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.