Docs → Chest Tracking → Chest catalog explained
📦 Chest catalog explained
Find out what any chest is worth to your clan, how epic points are worked out, and why editing a value never changes chests already collected.
You opened a chest and want to know what it was worth. Or a chest gave you nothing and you want to know why. Both answers live in the same place: your clan's chest catalog, the list that turns a chest you claimed in Total Battle into a number of points.
Every member can read it at Clan → Chest Catalog. Clan admins have a second, editable version of the same list at Clan Management → Chest Catalog — same chests, plus the controls to change them.
What one catalog entry is
An entry pairs a source — where the chest came from in the game — with a chest name, and hangs a value and a few flags off that pair. When a chest is collected, the portal looks for the entry that matches it and copies the value across.
That pairing matters. Crypt + Gold Chest and Citadel + Gold Chest are two separate entries with two separate values, even though the chest has the same name.
| Column | What it tells you |
|---|---|
| Source | Where the chest comes from in Total Battle. |
| Chest Name | The chest itself. |
| Group | The bucket this chest belongs to — crypts, citadels, event chests and so on. Groups drive the breakdowns on the statistics pages. A dash here means the entry was never filed under a group; that only happens on older rows, because a group is required on anything added today. |
| Tag | An optional second label, used for narrower filters and for deciding which chests count towards an event. |
| Points | What this chest adds to a member's cycle score. A dash means zero — the chest is tracked but scores nothing. |
| Epic | A tick if the chest is dropped by an epic monster. |
| Epic Pts | The fraction of one kill this single chest represents. See the next chapter. |
| Penalty | Marks the entry as a penalty chest. These are not chests anyone collects — see below. |
Four tiles at the top count the entries: Total Chests, With Points, Penalty Chests and Epic Chests. They count catalog entries, not chests anyone has collected.
Epic points, and the arithmetic behind them
Epic monsters drop several chests for one kill. Counting each chest as a kill would inflate everything, so the portal splits a kill across its drops.
A clan admin enters one number — Epic chests (total drops), how many chests the monster drops in a single kill — and the portal works out the epic points itself as 1 ÷ that number. So:
- A monster dropping 5 chests gives 0.2 epic points per chest. Collect all five and you have 1.0 — one kill.
- A monster dropping 7 chests gives roughly 0.143 per chest. Collect four of the seven and the portal records 0.57 of a kill, which is the honest answer.
Epic points are counted separately from ordinary points. An epic chest can carry both: an epic fraction that measures kills, and a normal point value that counts towards the cycle. The two never interfere with each other.
Points are frozen the moment a chest is collected
This is on purpose. A closed cycle should still say what it said when it closed, and a member who was penalised for missing a target should not silently pass six weeks later because someone doubled a chest's value.
The consequence is worth remembering: if a chest was worth the wrong amount last week, fixing the catalog fixes next week. To correct the chests that were already counted, a clan admin edits them directly on Claimed Chests — the points can be changed on a single chest or on a selection at once.
Penalty entries are different
An entry marked Penalty is not a chest anyone opens. It is a label the portal attaches to a deduction so that the deduction has a name when it shows up in a member's record.
The number in the Points column of a penalty entry is not what gets deducted. The amount is set by whichever penalty rule fired — the crypt shortfall rule, the Gold Pass rule, an event, and so on — and each rule carries its own value in the clan's settings. The catalog entry only supplies the name.
Penalty entries appear in a member's chest history with Auto Penalty as their source, which is a quick way to tell them apart from anything that was actually collected. The guide Understand the penalty system covers which rules exist and what each one charges.
Where the entries come from
Your clan does not maintain this list from scratch. There is a master catalog kept centrally, and every clan gets its own copy of it. When a new chest type is added to the master list, it is copied into your clan automatically — as long as Receive Global Chests is switched on. A clan admin finds that switch on Clan Management → Clan Settings, in the 🔗 Webhook & Chest Import card.
Because the copy is yours, editing a value changes it for your clan only. Nothing you do here affects any other clan, and nothing another clan does affects you.
A copied chest arrives with the master list's point value, which is sometimes zero. That is the usual reason a brand-new chest type shows up in the catalog worth nothing until an admin prices it.
If a chest you collected is not in the list
Every chest collected from the game is matched against this catalog before it counts. When nothing in the catalog matches, the chest is not thrown away — it is held aside and only scored once the entry it needs exists.
What a clan admin does about it:
Search for the chest name. The same chest can be read slightly differently from the game screen, and an alias on the existing entry absorbs the variant permanently. Adding an alias is almost always better than creating a second entry.
Use + Add chest. Four fields are required and the form will not save without them: Chest source, Chest name, Group and Chest points. Points arrives pre-filled with 0, so in practice it rarely stops you — but if you leave it at 0 the chest is tracked and scores nothing, which is the usual reason a newly added chest gives members no points. Tag, the epic settings and the penalty toggle are the optional ones.
The Duplicates filter lists entries that share a source and name inside your clan. Duplicates split one chest's claims across two rows and make every total look wrong, so they are worth clearing out.
An entry that already has chests recorded against it cannot be deleted — the portal blocks it so that historical statistics stay intact. Removing it would leave those chests pointing at nothing.
If chests are still not being matched after the catalog entry exists and is spelled correctly, that is not something the catalog can fix. Contact support with the chest source and name and it can be corrected centrally.
Finding things on the page
- Type filters to Epic, Penalty or With Points — the last of these is the fastest way to see only chests that actually score.
- Group and Tag narrow to one bucket or label.
- Search matches the chest name or the source.
- Source, Chest Name, Points and Epic Pts sort when you click the column heading. The other columns do not sort.
- The list pages 25 entries at a time.
Entries a clan admin has removed are never shown here, so what you see is the live list your clan is scored against.
Common questions
Why did a chest I collected give me no points?
Look the chest up on Clan → Chest Catalog. If the Points column shows a dash, the entry is priced at zero and is being tracked but not scored — a clan admin has to give it a value. If the chest is not in the list at all, it has not been matched yet and is waiting for a clan admin to add it. Either way it is your clan's catalog that decides, and it can be changed.
Our admin changed a chest's points but my score did not move. Why?
Because a chest keeps the value it had when it was collected. Catalog edits apply to chests collected afterwards and never rewrite what is already recorded. To correct chests that were already counted, a clan admin changes them on Claimed Chests, where the points can be edited on one chest or on a whole selection.
What is the difference between Points and Epic Pts?
Points is what the chest contributes to a member's cycle score. Epic Pts is a fraction of an epic monster kill — 1 ÷ the number of chests that monster drops — and is counted in the epic statistics rather than in the cycle score. A chest can have both, and the two never affect one another.
A chest appeared in our catalog that nobody added. Where did it come from?
From the master catalog. New chest types are added centrally and copied into every clan that has Receive Global Chests switched on — a clan admin finds it on Clan Management → Clan Settings, in the 🔗 Webhook & Chest Import card. The copy is yours to price and rename; if you would rather add chests yourself, a clan admin can turn that setting off.
Related