HomeDocumentation

Reserved slots and seeding rewards

A reserved slot in Squad is the reserve permission in Admins.cfg. Communities hand them out for seeding, for supporting the server, for being in the clan — and then edit the file by hand and forget to take them away. Aquilon gives the slot a lifecycle: it is earned or granted, it has an end date, it lapses on its own, and the file Squad reads is generated.

Seeding earns the slot

Seeding counts while a server has fewer players than the threshold (40 by default). Every minute a player spends on a seeding server adds to their clock; at the target — 10 hours by default — they get a reserved slot for 30 days. Keep seeding and the slot rolls over.

You set the target hours, the slot length and the seeding threshold on the Reserved slots page. The readout for a player is "65 % of the next slot", and admins see who is closest.

Two modes, one ledger

Under the hood every hour seeded is worth tokens, and the slot is a bundle the tokens buy. In the default seed reward mode nobody sees a token: the bundle buys itself the moment the balance covers it. Switch to the token economy and the same balance is kept for the player to spend — on any bundle you define, through chat, the Discord bot or an admin. Quests, seasons and shop purchases pay into the same balance.

The mode is a switch per organisation. Changing it changes nothing already earned.

Grants by hand and through the API

Give a slot for an event, a giveaway or a clan mate with a Steam64 and a number of days. Grants stack: a new one starts where the current one ends.

Your own integration posts them too. With an API token scoped to whitelist.manage:

POST https://api.aquilon.cc/api/orgs/<org>/whitelist/grants
{"steam_id":"76561198000000001","days":30,"label":"Patron","external_id":"patreon:pledge-123"}

or sell tokens — in seed-reward mode the slot is bought at once when the balance covers it:

POST https://api.aquilon.cc/api/orgs/<org>/whitelist/tokens
{"steam_id":"76561198000000001","amount":100,"source":"kofi","external_id":"kofi:txn-456"}

Send the platform's transaction id as external_id and replaying a webhook log never grants twice. Mapping a pledge to a Steam64 is your side of the integration.

How the server gets the list

Squad merges hosted admin lists from RemoteAdminListHosts.cfg. Aquilon serves your active slots at a private URL as a reserve-only group:

Group=Whitelist:reserve
Admin=76561198000000001:Whitelist // Reserved slot · 30 days until 2026-10-04

Generate the URL on the Reserved slots page and add it to the file — the page can do that for you through the config editor. Squad reads the list on start and refreshes it periodically. Nothing is written into Admins.cfg, so your admin groups stay exactly as you set them.

There is no stock Whitelist.cfg in Squad; reserved slots are the reserve permission, granted in Admins.cfg or through a remote list.

Getting started → · Pricing →

Continue with DiscordFree for one server · no card · connected in about five minutes