Importing assets

DIRECTORIES

To import a new asset in your game, you only have to copy it in the right place.
To find quickly where the best is to open the GameBox to the left and click on the  Directory button to open the directory.
(If you want to know, you can also find it in Documents/BuloStudio/Games/Your game name/Assets)

In the Asset directory you can find several other directories:
– Pictures: for menus, HUD, wallpaper, fonts, game over pictures, etc.
– Models: for all the game entities, like enemies, bullets, items, backgrounds…

Each kind of game object goes into its own sub-directory: items, players, enemies.
– Particles: for animated explosions and particle effects.

Then, inside each one of those directories, there are two sub-directories: Sprites and 3D. In Sprites you can save all your sprites pictures, and in 3D, you can save all your 3D assets and their textures.

Note: each asset should have a unique name in the game. For example, if you save a sprite called "sprite.png" in player/sprites and save another picture with the same name elsewhere, the engine will only load the first one.

Note: texture name for 3D assets should not contains space:
ex: my texture.png is not a valid name.
PLease use an underscore _ instead.

Note: When you create a new game, the SHMUP Creator creates several directories (Assets, Sprites, Enemies, Gamebox...): do not create new directories inside them, they will not be used by the editor.

ASSETS UPDATE

Each time you add a new asset, the SHMUP Creator will update the Game Box and the asset will be ready for you to play with. And each time you update something (a texture, a 3D assets…), the tool will update everything automatically (except for sounds).

MISSING ASSET

If you delete an asset that is used by your game, the engine will show a missing texture material or a ? Object for missing 3D objects. You can copy your asset and the engine will try to bring back everything as well as it can.

Please read best practices and performance tips for information about 3D and sprites creation good practice.

SOUNDS:

Put all the sounds in the Sounds directory, either in the Music or SoundFX sub-directories.
Accepted file formats are mp3, ogg or wave.
As soon as you copy a new sound in those directories, the tool imports them and add them in the right menus.

Note: If you modify a sound already imported, the sound will not be updated in the tool. You have to save, quit, and restart the tool to update it.