Inventory Texture Configuration

Configure inventory slot background textures, including the shared slot atlas.

Inventory textures are the background art drawn behind item icons in inventory UI — most notably the slot and selected-slot backgrounds. This is separate from item icons themselves (see Item Texture Configuration) and from general UI/button textures (see Button Texture Configuration).

File Location

Config file:

mods/<your-mod>/assets/textures/inventory/inventory.yaml

Texture images go in the same folder:

mods/<your-mod>/assets/textures/inventory/<name>.png

The file name must match the name field exactly (case-sensitive), with spaces kept as spaces in the file name.

Minimal Example

textures:
  - name: my-slot-background

This registers my-slot-background from my-slot-background.png, available as YourMod:my-slot-background anywhere an inventory texture name is expected.

Full Field Reference

textures:
  - name: my-slot-background  # Required. Registered as YourMod:my-slot-background
    inventory-atlas: false    # Optional. Pack into the shared inventory slot atlas. Default: false
    frame-width: 0            # Optional. Frame width in pixels, if the texture is subdivided
    frame-height: 0           # Optional. Frame height in pixels, if the texture is subdivided

Field	Required	Description
`name`	Yes	Identifier for this texture. Registered as `ModName:name`.
`override`	No	Full name of another mod’s inventory texture to replace (e.g. `Creation:slot`). See Overrides.
`inventory-atlas`	No	If `true`, packs this texture into the shared inventory slot atlas (see Slot Atlas Ordering). Default: `false`.
`frame-width`	No	Frame width in pixels. Default: `0`.
`frame-height`	No	Frame height in pixels. Default: `0`.

Slot Atlas Ordering

The base game’s own slot and selected-slot textures are packed into inventory-atlas first, at fixed indices the renderer depends on:

Index	Texture
`0`	`slot`
`1`	`selected-slot`

If you add your own inventory-atlas: true entries, they’re appended after whatever the game and other mods have already loaded — you don’t control their index, so this atlas is only appropriate for textures your own mod’s code looks up by name, not for replacing the base game’s slot rendering constants.

Overrides

Your mod can replace the texture used for any inventory texture from another mod without changing that mod’s files. Add override with the full mod-namespaced name of the inventory texture to replace:

textures:
  - name: slot
    override: Creation:slot

The name field is still required — it locates your replacement PNG in your mod’s folder.
Your entry replaces the target’s registered texture, so redeclare any settings (such as inventory-atlas) you want to keep.

Complete Example

Based on the real shipped inventory configuration:

textures:
  - name: slot
    inventory-atlas: true
  - name: selected-slot
    inventory-atlas: true