Textures Reference
Textures are the image files used to display items and enemies in the game UI. They appear on item cards in the shop, inventory, admin panel, and dungeon UI.
Supported Formats
| Format | Extension | Notes |
|---|---|---|
| PNG | .png | Recommended for all static images |
| GIF | .gif | Supports animation โ useful for special or rare items |
Recommended Size
All item and enemy icons: 64ร64 px. Larger images will be scaled down; smaller images may appear blurry.
Referencing Textures in JSON
The texture field contains the full path from the datapack root. The path always starts with your pack name:
"texture": "mypack/assets/textures/materials/ore/iron.png"
Texture Path Map
| Content Type | Path Pattern |
|---|---|
| Ore | mypack/assets/textures/materials/ore/<id>.png |
| Ingot | mypack/assets/textures/materials/ingot/<id>.png |
| Alloy | mypack/assets/textures/materials/alloy/<id>.png |
| Circuit | mypack/assets/textures/materials/circuits/<id>.png |
| Crystal | mypack/assets/textures/materials/crystal/<id>.png |
| Personal suit/helmet | mypack/assets/textures/equipment/personal/armor/suit/<id>.png |
| Personal gloves | mypack/assets/textures/equipment/personal/gloves/<id>.png |
| Personal boots | mypack/assets/textures/equipment/personal/boots/<id>.png |
| Personal accessory | mypack/assets/textures/equipment/personal/accessory/<id>.png |
| Personal weapon | mypack/assets/textures/equipment/personal/weapons/<id>.png |
| Ship hull | mypack/assets/textures/equipment/ship/hulls/<id>.png |
| Ship engine | mypack/assets/textures/equipment/ship/engines/<id>.png |
| Ship shields | mypack/assets/textures/equipment/ship/shields/<id>.png |
| Ship thruster | mypack/assets/textures/equipment/ship/thrusters/<id>.png |
| Ship weapon | mypack/assets/textures/equipment/ship/weapons/<id>.png |
Tips
- Use PNGs with transparency. Items look best on a transparent background so the game can place them on any UI color.
- Keep textures small. 64ร64 is sufficient โ larger files slow loading with no visible benefit.
- Use animated GIFs sparingly. Reserve for special or legendary items where the animation signals rarity.
- Be consistent within your pack. Mismatched sizes between items look unprofessional.