For all users to submit their own works! Must be original and usable in GB Studio.

Everything in here in under the MIT Licence. No credit is required, all assets can be used commercially, and nothing is stopping you from redistributing these assets as well.

HOWEVER, in the interest of giving thanks to our contributors, you can find credits to all the contributors in each folder's README file. Please take your time to read up on who made the thing that you're downloading and consider including their name in your game's credits!

If you're submitting your own work, you must be okay with all of your submitted work being under the MIT Licence. That means it can be used commercially and redistributed. If you're submitting someone else's work, they must consent to have their work placed in a repository under the MIT Licence before anything else.

I'd love to accept any unofficial modifications to GB Studio or its compontents if they can be shared under the MIT Licence or the GPL 3.0 licence. Ember#1765 is my Discord handle, let me know if you'd like to add experimental features of the engine to this repository. (different GBT waveforms, different palettes, different character sets, etc.)

Give unique and distinctive names to all the files you submit! This makes it much easier for users to browse and to find specific file credits in the README files.

1. Have all your files ready to be added

2. Make a fork of this repository

3. Upload your own files to your own fork

4. Edit the README.md of the folder that has your new files to include the following formatting:

///

Your Name:

Your file - And a little blurb describing it

///

5. Make a pull request. Make sure the page is showing [my repository] << [your fork]

6. If you'd like to be added to the contributors list so you can approve your own pull requests or approve others', just let me know in your pull request.

Index:

1. Backgrounds
2. Sprites
3. UI
4. Music

"An image can contain no more than 192 unique 8px x 8px tiles at once due to memory limits."

Use Tiled or other programs to help you allign these backgrounds.

Put tilesets in the graphics/tilesets folder, and finished backgrounds in the /backgrounds folder.

Docs: https://www.gbstudio.dev/docs/backgrounds/

Minimum file dimensions are 160px x 144px

Maximum file dimensions are 256px x 256px

Docs: https://www.gbstudio.dev/docs/sprites/

Please keep static sprites in the /sprites/static/ folder and all not-animated actors in the /sprites/actors folder. Animated actors belong only in /sprites/anim-actors/ and all other animated sprites belong only in /sprites/anim/

Name your file something unique, either with your own name or anything other than "ascii.png" or other default filenames.

Put ascii files in the /fonts folder and everything else in the /UI folder.

Docs: https://www.gbstudio.dev/docs/ui-elements/

The following folders exist for music:

• Action - Boss themes, battle themes, tense music
• Cutscenes - Short or non-loopable thematic songs
• Drumbeats - Non-melodic patterns, good song-starters.
• Jingles - Short melodic pieces, great for games that have to stop the music often.
• Menu Themes - Songs for a main menu/inventory screen
• MilkyTracker Templates - Get started in MilkyTracker, faster!
• National Anthems - Add your own!
• Overworld - Songs for exploring an overworld
• SFX - Sound effects of all sorts
• Utility - This folder is currently archived and is planned to be deleted

Docs: https://www.gbstudio.dev/docs/music/

Join the GB Studio discord to answer your music questions: https://discord.gg/2hYeJ4m