One catalogue per server
Every Shop item, hidden and not-for-sale ones too, plus every defeated boss. Exclude items you don’t want listed or turn either half off.
Codex turns everything members buy, find and fight into a collection. It lists your Shop items and every World Boss the server has defeated. Entries a member hasn’t found stay undiscovered, and sets you define pay a reward once when they are complete.
/codex browse

Only you can see this
Every Shop item, hidden and not-for-sale ones too, plus every defeated boss. Exclude items you don’t want listed or turn either half off.
Show what a member hasn’t found as “???” or as a greyed-out name. Browse everything, or only items or bosses, with /codex browse.
Discovery comes from what already happened: Shop items you received and bosses you damaged. An item stays found after it is sold or used.
Group 2 to 25 entries into a set with a name, emoji and description. Mix items and bosses for a collection that fits your server’s story.
A set can pay coins, a Shop item, a role or any mix. Each member gets it once, even if a set is renamed, and a set can even pay a crate.
A finished set is announced to the member privately and, if you want, in a channel of your choice, with no pings.
Open https://console.botgg.app, choose your server and turn on Codex in the Engagement section. Choose what is listed and how undiscovered entries look.
Pick item and boss entries for each set and add a reward. The builder flags problems like a deleted item or a boss nobody has defeated yet.
History counts from day one: items already received and bosses already fought are found the first time a member opens /codex browse.
/codex sets shows the sets, and /codex set shows one in detail. The reward is paid automatically when the last entry is found.
Items from Expeditions, Crafting, crates and boss drops all land in the Shop inventory, so they count for the Codex with no extra setup. A refunded purchase doesn’t count as a find, but a set paid before a refund stays paid. A boss joins the catalogue after its first defeat, and a boss that respawns under the same name is one entry.
A reward item that ran out of stock or was deleted is skipped, so it can’t hold the coins and role back, and a coin reward waits while the Bank is off. Set rewards aren’t a chance outcome, because nothing is rolled. Sets: 3 on Free, 15 on Pro. The console shows finders per entry, top collectors and a claims log, and Flows can react to new discoveries and finished sets.
/codex browse: the catalogue, all or by kind/codex sets: the server’s sets and your progress/codex set: one set with its entries and rewardGenerated from the bot’s real command definitions. Full list on the commands page.
/codexThe server catalogue of items and bosses3 subcommands/codex browsekind?Browse what you have found/codex setsYour progress on every set/codex setsetEverything in one setEvery feature works on the Free plan. Pro raises the limits and unlocks extras.
| Limit | Free | Pro |
|---|---|---|
| Codex sets | 3 | 15 |
Turn on the Shop and Codex in the BotGG console, add items and build a few sets. Members track their finds with /codex browse and /codex sets.
A member discovers an item by receiving it through the Shop, and it stays found after it is sold or used. A refunded purchase doesn’t count.
By dealing damage to it in a fight the server won. A boss joins the catalogue after its first defeat.
Yes. Items a member already received and bosses they already helped defeat count as soon as they open the Codex.
No. Each set pays each member once, even if two actions finish it at the same moment or the set is renamed.
Add BotGG for free, then switch features on in the web console.