Skip to main content

Sound System

The framework supports four sound keys in item definition files:

KeyWhat it controls
copy_soundsCopies use + pickup + putdown sounds from a vanilla item
sound_useCustom audio file for the consume/use event
sound_pickupCustom audio file for picking up in inventory
sound_putdownCustom audio file for placing down in inventory

Audio files (.wav, .ogg, .mp3) must be placed in the same folder as the item file that references them.


Resolution order

Use/consume: sound_use > copy_sounds > UI swoosh fallback
Inventory pickup: sound_pickup > copy_sounds > game default
Inventory putdown: sound_putdown > copy_sounds > game default

copy_sounds fills in any slot not explicitly overridden by a specific key. You can use copy_sounds as a base and then only override the one sound you want to change.


Common copy_sounds values

ValueSounds like
Item_CheeseburgerEating / food sounds
Item_BottledWaterDrinking / potion sounds (good for oils and scrolls)
Item_ArmorVestArmor / passive inventory sounds