PlayFab Integration: Inventory System

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:

1. Player logs in

2. Game loads their inventory

3. Game equips cosmetics

4. Player earns or buys new items

5. Game grants the item

6. 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