Inventory System: Item Definitions

Item Definitions describe what an item is and how your game should treat it.
This metadata tells your game how to load, equip, and display cosmetics.

Item Classes

Common item classes in VR fangames:

• Hat

• Badge

• Material / Color

• Holdable

• Event Item

• Exclusive Item

• Staff Item

Custom Data

Custom Data is where you store item‑specific information, such as:

• Color values

• Rarity

• Cosmetic type

• Unlock requirements

• Seasonal tags

• Mesh or material names

• Special effects

Your game reads this data when equipping cosmetics.

Tags

Tags help you organize items:

• Seasonal

• Halloween

• Winter

• Exclusive

• Staff

• Event

Your shop UI can filter items using tags.

Best Practices

• Keep item definitions simple

• Use consistent naming

• Store cosmetic metadata in Custom Data

• Avoid large JSON blobs

• Use tags for filtering