Audio, Icons, and Modification UI

26. Audio

Encode final files as OGG Vorbis and register them in assets/<namespace>/sounds.json. Keep action audio untrimmed unless the source design explicitly requires truncation. Map events to the visible animation frame: magazine removal/insertion, chambering, pump/bolt, selector changes, inspect gestures, draw, holster, melee, fire tail, and dry fire.

Avoid layering duplicate composite files and event sounds for the same physical action. Test single fire and sustained fire separately, and allow the sound-physics mod to process firearm and foley categories where supported.

For a first integration, add one event at a time: copy the OGG to assets/<namespace>/sounds/<weapon>/, register it in sounds.json, verify firing, then add reload, inspect, bolt, and melee frame commands. Test again after a full restart.

The physical file, resource value, and event ID are different layers:

file: assets/example/sounds/example_rifle/mag_in.ogg
resource value: example:example_rifle/mag_in
event ID: example:example_rifle_mag_in

27. Icons and localization

Provide item model JSON, transparent PNG icons, and both zh_cn.json and en_us.json names. Keep the same white-model-with-shadow visual language across weapons, default parts, optional attachments, and ammunition.

Keep a consistent camera angle, silhouette size, margin, shadow, and brightness. Do not brighten assets until their original material color is lost. icon_texture supplies item and modification-card artwork; hud.weapon_icon explicitly selects a HUD image. Validate creative inventory, hotbar, HUD, modification card, and tooltip separately.

28. Modification screen

Weapon class, slot names, and attachment cards must be localized. Use modify_screen only for the static model's position, rotation, and scale. The model renders behind text and UI cards and must not run idle animation. Default parts must attach to their actual nodes in this static pose.