Caution: Fraudulent or imitation websites may appear. Only this site is official. Report concerns on our Report Fraud page.
The Inventory System is the backbone of all cosmetic and item ownership in your VR fangame.
It controls what items exist, how they are defined, how players receive them, and how they are stored permanently in PlayFab.
This page explains how the entire system works, from catalogs to item grants, and how your game should interact with it.
1. How the Inventory System Works (Overview)
PlayFab’s inventory system is built on four core components:
A. Catalog
This is the database of every item in your game.
The catalog defines:
Item IDs
Item classes (Hat, Badge, Material, etc.)
Tags (Seasonal, Event, Staff)
Prices (optional)
Custom Data (color, rarity, metadata)
If an item is not in the catalog, it cannot be granted or owned.
B. Item Definitions
Each item has metadata that tells your game how to use it.
Item definitions include:
Cosmetic type
Color/material info
Rarity
Unlock requirements
Seasonal/event flags
Your game reads this data to know how to display and equip items.
C. Granting Items
This is how players receive items.
Items can be granted through:
CloudScript (recommended)
Shop purchases
Event rewards
Leveling systems
Staff tools
Admin panel (testing)
All item grants are stored permanently in the player’s inventory.
D. Consuming Items
Some items can be “used up.”
Examples:
Event tokens
Crafting materials
Temporary boosts
Consumable items have a usage count that decreases when used.
2. How Inventory Fits Into Your Game Flow
A typical VR fangame uses this flow:
Player logs in
Game loads their inventory
Game equips cosmetics
Player earns or buys new items
Game grants the item
PlayFab saves it permanently
This ensures cosmetics and unlocks stay synced across sessions and devices.
3. What the Inventory System Is Used For
Most VR fangames use inventory for:
Hats
Badges
Materials / colors
Holdables
Event items
Seasonal cosmetics
Exclusive items
Staff‑only items
Anything the player can “own” belongs in the inventory.
4. Why PlayFab Inventory Is Important
Prevents cheating
Stores items securely
Syncs cosmetics across devices
Works with Virtual Currency
Works with CloudScript
Works with Photon for multiplayer identity
It’s the safest and most scalable way to manage cosmetics in a VR game.
5. Subpages in This Section
This Inventory System page has four subpages that explain each part in detail:
Catalog Setup
Item Definitions
Granting Items
Consuming Items
These pages break down the full system step‑by‑step.
6. Best Practices
Never grant items directly from the client
Use CloudScript for secure operations
Keep item IDs consistent (HAT_, BADGE_, MAT_)
Use tags to organize cosmetics
Store cosmetic metadata in Custom Data
Keep catalogs clean and organized
Use separate catalogs for:
Cosmetics
Events
Staff items