Data:Assets
From Starbounder - Starbound Wiki
The asset tree contains all game assets that are loaded during gameplay. It is the central location modding work takes place. By modifying the files contained in the assets directory, Starbound can have its existing content changed, removed, and new content added.
The asset tree location is defined by sbinit.config By default, it is the assets directory in the root install directory.
Individual mods each have their own asset tree. These are created and placed in the mods folder of the Starbound install directory. Each mod has its own *.metadata file that contains information for loading the mod. Any modinfo file in the mods directory tree will be loaded into the game.
Asset Tree Contents
Note that you can rename your packed folder to anything. The packed in the filepaths here is just here to represent where files are in the unpacked assets.
| Asset Type | Filepath | Description |
|---|---|---|
| Animations | assets/packed/animations | Contains reusable animations. |
| Monster and NPC Behavior | assets/packed/behaviors | Behaviors for NPCs and monsters such as pathfinding and attacks. |
| Biomes | assets/packed/biomes | Biome definition - Ore distribution - Generation pattern code |
| Navigation Images | assets/packed/celestial | Contains the images for everything found in the navigation console, such as celestial bodies, space stations, and planets. |
| Cinematics | assets/packed/cinematics | Contains the game's cinematics. |
| Codexes | assets/packed/codex | Contains the text and formatting of all codex entries. |
| Damage Types | assets/packed/damage | Damage types. |
| Dungeons | assets/packed/dungeons | Contains the Tiled (and png, for some dungeons) files and dungeon files for Dungeons. |
| Status Effects | assets/packed/stats/effects | Contains all status effects and their Lua and animation files. (e.g. poison, speed boost). |
| Character Bodies | assets/packed/humanoid | Images used for each races base body and body customization options, along with their associated frames files. |
| Interface | assets/packed/interface | GUI images plus configuration files. |
| Items | assets/packed/items | Contains definitions and images for usable items and equipment. |
| Damage Calculations | assets/packed/leveling | Contains mathematical functions for various aspects of the game (e.g. animation curves, damage curves). |
| Liquids | assets/packed/liquids | Contains liquid textures and files. |
| Monsters | assets/packed/monsters | Contains images, definitions, and scripts for monsters. |
| Music | assets/packed/music | Contains background music. |
| NPC Types | assets/packed/npcs | Contains images, definitions, and scripts for NPCs. |
| Objects | assets/packed/objects | Contains definitions for placeable objects. subfolders sort objects into race/category. |
| Parallax | assets/packed/parallax | Contains images for background parallax. |
| Particles | assets/packed/particles | Contains images and definitions for particle effects. |
| Plants | assets/packed/plants | Contains images and definitions for foliage and trees. |
| Projectiles | assets/packed/projectiles | Contains images and definitions for projectiles. |
| Quests | assets/packed/quests | Contains definitions for quests. |
| Recipes | assets/packed/recipes | Contains crafting recipes. |
| Sound Effects | assets/packed/sfx | Contains .ogg files used for in-game sound effects. |
| Ship Structures | assets/packed/ships | Contains background images and structure definitions of player ships. |
| Sky | assets/packed/sky | Contains images and animations for the sky. |
| Races | assets/packed/species | Contains player information for species (e.g. racial crafting recipes, sfx, name generation). |
| Techs | assets/packed/tech | Contains definitions and scripts for techs. |
| Terrain | assets/packed/terrain | Contains terrain generation parameters. |
| Blocks | assets/packed/tiles | Contains images and definitions of materials. |
| Treasure | assets/packed/treasurepools | Contains definitions for pools of items (e.g. chests, drops, merchants). |
| Weather | assets/packed/weather | Contains definition of weather effects (e.g. rain, snow). |
Specific File Types
| File Type | Description |
|---|---|
| Frames | Dictates frame names of sprite sheet |
Config Files
| File | Description |
|---|---|
| assets.config | [File does not exist in assets as recent as version 1.3] |
| asteroids_worlds.config | Defines parameters for generating Asteroid Field "worlds" |
| authmunin.config | [File does not exist in assets as recent as version 1.3] |
| blueprint.config | Defines the default text for generated blueprint items |
| celestial.config | Defines the parameters for generating the galaxy |
| client.config | Defines the parameters of the game client |
| codex.config | Defines the default text for generated codex items |
| currencies.config | Defines parameters for currencies |
| default_actor_movement.config | Defines some default parameters of entities |
| default_configuration.config | Defines default parameters for the game client (This appears to have been removed or renamed) |
| default_movement.config | Defines some default parameters of entities |
| dungeon_worlds.config | Defines the parameters for instanced worlds like the Outpost or The Erchius Mining Facility |
| emotes.config | Defines phrases that trigger player emotes |
| farming.config | Defines parameters related to immersion of crops in water and crop growth |
| help.config | Defines command descriptions when using "/help" |
| highlights.config | Defines highlight overlay states when using scan mode |
| humanoid.config | Defines rendering parameters for humanoid entities |
| hunger.config | Defines phrases used for hunger levels |
| instance_worlds.config | Defines the parameters for instanced worlds like the Outpost or The Erchius Mining Facility |
| interface.config | Defines position and setting of interface elements |
| itemdrop.config | Defines item movement parameters, such as pickup range, throw velocity, and fall speed |
| lighting.config | Defines rendering parameters for lighting |
| liquids.config | Defines liquids |
| merchant.config | Defines default merchant shop parameters such as buy and sell factors |
| metamaterials.config | Defines metamaterials not already specified by the game engine |
| panes.config | Defines tooltip parameters |
| perf.config | [File does not exist in assets as of version 1.1.1] |
| planetgen.config | Replaced by terrestrial_worlds.config |
| player.config | Defines initial states of a new player including animations, warmth, and blueprint tiers |
| playermodes.config | Defines player difficulty parameters |
| radiomessages.config | Defines default parameters for radio messages from entities such as SAIL |
| rails.config | Defines friction and speed limits for platforms traversing various rail components |
| renderer.config | Renamed rendering.config |
| rendering.config | Defines parameters for the renderer |
| server.config | [File does not exist in assets as recent as version 1.3] |
| sfx.config | Defines audio parameters for sound playback |
| sky.config | Defines rendering parameters for the sky |
| songbook.config | Defines how symbols in .abc song files are converted into musical notes (?) |
| spawning.config | Defines default parameters for monster spawning as well as common kinds of monster spawns |
| streamingvideo.config | [File does not exist in assets as of version 1.1.1] |
| system_objects.config | Defines parameters for explorable ships, stations, and anomalies |
| systemworld.config | Defines parameters for star systems |
| terrestrial_worlds.config | Defines the parameters used to generate planets |
| universe_server.config | Defines various server-side parameters such as starter planet requirements |
| universeflags.config | Defines conditions for universe-wide flags, such as Outpost unlocks |
| versioning.config | |
| weather.config | Defines occurrence chances for weather types |
| world_template.config | |
| worldserver.config | |
| worldstorage.config |
