Docs → Advanced Features → Creating reward distributions
🏆 Creating reward distributions
Build a reward ledger from an event, a cycle or the whole clan, choose how the pool is split, and let the portal hand the rewards out in the game for you.
An event has finished, there are Dragon Coins in the clan capital, and you want them shared out in a way nobody can argue with. That is what a reward ledger is: a pool, a rule for splitting it, and a per-member list you can adjust before anything moves.
What is on the page
Clan Management → Reward Ledgers has three tabs: Ledgers, Reward Types and Player Exclusions.
Above them sit five counts — Total Ledgers, Confirmed, Pending, Failed Payouts and Distributed — and a Clan Capital panel showing when the capital was last read, how much is promised away, and how much is free.
Reward types
On the Reward Types tab, the in-game types are managed for you: they exist in every clan, match the in-game resource exactly, and cannot be renamed or deleted. Add your own for anything you track and hand out yourself — those are never sent to the game.
Creating a ledger
New Ledger opens a five-step wizard. You cannot skip forward past a step you have not answered.
Title, Reward type and Total to hand out. The reward type defaults to your clan's Dragon Coins. If your total is more than the capital holds, the wizard says by how much and makes you tick I understand and want to continue anyway — it warns rather than blocks, because the capital reading can be hours old.
This decides who is eligible and what counts as their score. See the table below.
Skipped for Manual and for Everyone — equal share, where the source already answers the question.
Six switches. Skipped for Manual.
It is created as a Draft. Nothing has been calculated and nothing has been handed out.
The sources
| Source | What it uses |
|---|---|
| Event | Points and chests from one event. You then pick What counts: Both points and chests, Points only or Chests only. The 50 most recent events are offered. |
| Crypt Cycle | Crypt points earned during one cycle. The minimum requirement comes from the cycle itself — you do not set it here. |
| AI Score | One insight score as the basis: OverallScore, ActivityScore, CryptScore, EventScore, CPScore or GrowthScore. |
| Everyone — equal share | Split evenly across every current member. No event, no requirement, nothing to configure. |
| Manual | No source at all. After you create the ledger you type every amount yourself. |
| Automatic | Not something you create. These are the ledgers your clan's automatic Dragon Coin payout produces. They are hidden from the list until you switch Automatic payouts to Shown, and they are left out of the Total Ledgers count. |
The methods
| Method | How it splits | What you must set |
|---|---|---|
| Proportional to points | Each player gets their points divided by the points of everyone included, times the pool. | Nothing |
| Requirement met — equal share | Everyone who met the minimum gets exactly the same amount. | Nothing |
| Rank based | Fixed percentages for the top places. | A percentage per place, adding to exactly 100. Starts at 50 / 30 / 20 for the first three. |
| Rank within G-level brackets | Brackets share the pool, then places share each bracket. | Bracket shares totalling 100 and place percentages totalling 100. Starts at G7–G9 60% and G4–G6 40%. |
| Manual amounts | No calculation runs at all. | Nothing — but exclusions still apply, so you start from the right list of people. |
The exclusions, and their defaults
| Switch | Default | Applies to |
|---|---|---|
| Leave out players below the minimum points | On | Event source |
| Leave out players below the minimum chests | On | Event source |
| Leave out players below the minimum crypt points | On | Crypt cycle source |
| Leave out inactive player profiles | Off | Any — means no profile update in the last 30 days |
| Leave out players without a portal account | On | Any — they cannot see the ledger, but can still be paid in the game |
| Leave out players without Gold Pass | Off | Any — read from the last member scan |
From draft to locked amounts
| Status | What you can do |
|---|---|
| Draft | Calculate rewards, edit inclusions, or Delete. |
| Calculating | Wait — the split is being worked out. |
| Calculated | Every per-member amount is visible. Recalculate, adjust individuals, or Confirm distribution. |
| Amounts locked | Nothing about the split can change. The ledger now reserves clan capital, and can be queued for payout. |
| Closed | Finished and out of the way. |
While a ledger is a draft or calculated, each row on the Players list offers Include, Leave out and Reset. Putting someone back in for this ledger never clears their standing exclusion — the next ledger starts from their normal setting again.
Handing them out in the game
A confirmed ledger on an in-game reward type shows Hand out rewards in-game automatically. The form asks:
- When — Send now or Schedule for later with a time. A time in the past is refused.
- Post status updates to — one of your in-game chat groups, or Do not post anywhere.
- Tell me when it finishes and Tell me if something goes wrong.
- Send each player a direct message — a private in-game message to each player when their reward arrives.
It goes into a queue, so expect a few minutes before the first payment. Players left out, and anyone whose final amount is zero, are not queued. While it is still waiting you can Take back out of the queue; once the payout has started, you cannot.
Afterwards: what the payout column means
The portal checks each payment against your clan's own capital log and reports one of these, word for word:
- Sent · found in clan log — matched, proven, finished.
- Sent · waiting for the next clan-log read — sent, not yet checked.
- Sent · could not be confirmed — sent, but the log we hold does not cover that moment.
- Sent · not found in the clan log — sent, and not matched. This is not proof the player went without.
- Handed out by hand — you recorded it yourself; the portal sent nothing.
- Not handed out through the portal — nothing was queued for this row.
Every one of those first four begins with Sent on purpose: what the portal knows is that it sent the reward, not that the player received it. The list of rows still wanting your attention is headed Needs you — not found in clan log.
Ledgers you settled yourself
On a confirmed ledger the portal never sent anything for, I handed these out myself records the fact. Nothing is sent to the game; the ledger stops reserving clan capital and stops reading as unfinished. It can no longer be queued for an automatic payout afterwards, so use it only when the rewards really are settled — or when they are never going to be given out at all.
Standing exclusions
The Player Exclusions tab holds two independent settings per member, and they do very different things:
- Never include in automatic payouts — absolute. The member is never part of an automatic payout, no exceptions.
- Leave out of new ledgers by default — only a starting point. They are left out when a new ledger is calculated, but you can put them back in for any single distribution.
Both are permanent until you remove them, and both are visible to the member on their own rewards page along with the reason you typed.
What a member sees at the other end of all this is covered in Understanding your rewards.
Common questions
Can I change a distribution after confirming it?
No. Confirming locks every amount: the ledger cannot be recalculated, cannot have members included or excluded, and cannot be deleted.
If it is wrong and nothing has been paid yet, use I handed these out myself to record it as settled — that frees the clan capital it was reserving — and build a fresh ledger with the right numbers. If rewards have already gone out, check your clan log in the game before paying anyone a second time.
Someone was left out who should not have been. What can I do?
While the ledger is still a draft or calculated, open it and press Include on their row, then Recalculate. That change applies to this ledger only and does not touch their standing exclusion.
After confirming, it is too late — the amounts are locked. Handle that one member outside the portal, or create a small separate ledger for them.
Does an excluded player's share get shared out among everyone else?
No. It stays in the clan capital. Leaving five people out of a fixed pool does not make the remaining shares bigger — it just means less of the pool is handed out.
If you want the whole pool distributed among the qualifying members, use Proportional to points or Requirement met — equal share, which divide the pool across whoever is actually included.
My clan capital says less is free than I know we have. Why?
Two reasons, and usually both.
- Every confirmed ledger reserves its total, whether or not it was ever paid out. Old confirmed ledgers nobody ever queued keep holding capital until they are recorded as handed out by hand.
- The capital figure comes from the last time the portal read your clan capital, so donations since then are not counted yet. The panel tells you when that reading was taken.
Related