Guides
Catalog and classnames
One item list for shop, wheel, votes, and Claim. Classnames come from CfgVehicles / CfgWeapons / CfgMagazines. Free holds 25 items.
Free
If it can be bought, spun, voted for, or Claimed, it lives in Catalog first. Don't make a second list in Shop. Shop only prices and posts things that already exist here.
The 25-item ceiling
Free keeps the 25 oldest items (by created_at). Add a 26th and it sits locked until Plus. Deleting an old flashlight to free a slot works; the panel is not trying to be cute about it.
Kinds
- Game item / weapon: needs a classname. That's what Claim spawns.
- Currency: credits donate or play coins. No classname.
- Nothing: roles, chat styles, cosmetic grants with no world item.
Classnames
Use the config class, not the display name. CfgVehicles, CfgWeapons, CfgMagazines. Example the panel itself uses: Aug. Wrong class = Claim succeeds in Discord and spawns air. Test on a dummy player before you sell it.
Attachments are other catalog rows, not a comma-separated string. A kit is previewed and delivered as one weapon. Each attachment row still needs its own classname and, if you care about the picture, its own image.
Inventory vs immediate
- Inventory: sits in the Claim menu until the player takes it. That's what you want for shop and wheel loot.
- Immediate: queued for delivery now. Use it when you're granting from the Players tab and the person is online.
Pictures
Direct image URL is the boring path that works. A Discord message link is a fallback; the Worker fetches the CDN URL on save. Wheel slot art is separate from the shop thumbnail. Plus can auto-cut chromakey screenshots; anyone can upload by hand.