Collectibles
Scarce, serialized universal items that trade peer-to-peer for LIX. How they differ from ordinary items, and how worlds use them.
A collectible is a special kind of universal item: it
exists in a fixed supply and each copy a player owns is serialized (numbered #1…#N).
Collectibles trade peer-to-peer between players for LIX — they are
redistributed, never minted on demand.
Collectibles are NOT in-world purchasable
Helix.marketplace.purchaseItem and purchaseProduct reject collectibles (you'll get
ProductInactive). They only change hands through the Marketplace's peer-to-peer offers. A world can
read ownership of a collectible (to gate content) but cannot sell one.
Template vs instance
A collectible has two layers — the template (the design + its supply) and the instances (the individual numbered copies players own).
Prop
Type
Collectible (template)
Prop
Type
CollectibleInstance (one owned copy)
Prop
Type
How worlds use collectibles
Because a collectible (when isUniversal) is a universal item, everything on the
inventory API works:
// Gate content on owning a collectible — same call as any item.
if (await Helix.inventory.hasItem('founders_badge_001')) showFoundersLounge();To let a player acquire one, send them to the Marketplace — a world can't settle a P2P collectible trade itself:
// (planned) deep-link to the collectible's marketplace page
Helix.marketplace.getListings({ category: 'collectible' });Collectible vs ordinary item vs world product
Universal item
The unlimited, listing-priced asset. Sold in-world via purchaseItem.
World product
A world-registered purchasable. Sold in-world via purchaseProduct.
The rule of thumb
Unlimited + listing-priced → universal item. World-defined price/bundle/consumable → world product. Scarce + serialized + traded between players → collectible. Only the first two are sold through an in-world purchase; collectibles move peer-to-peer on the Marketplace.
Reference
- Items & inventory → Inventory
- Economy & marketplace → LIX & Economy
Universal Avatar
Cross-runtime avatar loadouts, equipment slots, and placeholder-compatible socket rules for Web and Unreal.
World media (thumbnail, preview image, preview video)
Set a world's card artwork and the images + YouTube video that play in its detail carousel. Images upload through a presigned PUT; video is referenced from YouTube, not hosted.