Licensing and payment

AFK Warden ships as one jar. Without a license key it runs as Free: everything the plugin does, with the global settings and one LuckPerms rank with its own timers. A license key lifts the limit on ranks: Pro while a monthly subscription is active, or Pro Lifetime for good. Nothing else differs; see the Free and Pro table.

Plans #

Prices are in US dollars. Polar adds sales tax or VAT for your country at checkout, and you can enter a discount code there.

How to buy #

Once it opens, you pay through Polar (polar.sh), our merchant of record, which charges you, applies sales tax or VAT for your country and issues the invoice. Your license key starts with AWPRO-, like AWPRO-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. It is shown on Polar's confirmation page right after you pay, and it is always available in Polar's customer portal, where you sign in with the e-mail address you used at checkout.

Activate the key #

Use one of these on the server where Pro should run:

• Server console (recommended): afkwarden license activate <key>
• In game: /afkwarden license activate <key> (needs afkwarden.admin)

The key is checked and the answer arrives a moment later: License activated: Pro or License activated: Pro Lifetime. The key is then saved under license.key in config.yml (comments kept), and Pro applies at once. The key is masked in every log line; from chat, the server itself logs the command first, which is why the console is the better place for it.

• Changing keys is safe. The new key is checked first, and the one already active is released only after the new one is accepted. A refused key changes nothing and is never saved.
• If Polar cannot be reached while you activate, a working license stays as it is. A server without one keeps the key and checks it again every 15 minutes until Polar answers.
• Other ways in: paste the key into config.yml under license.key and run /afkwarden reload, or set the AW_LICENSE_KEY environment variable, which takes precedence over config.yml (handy on hosting panels).

Check the license at any time with afkwarden license status: the tier and its state, the masked key, the expiry, the last check, this server's install id and how many ranks entries are in effect.

Move to another server #

1. On the old server, run afkwarden license deactivate. It releases the activation, removes license.key from config.yml, and that server goes back to Free.
2. On the new server, run afkwarden license activate <key>.

If the old server no longer exists, free the activation from Polar's customer portal, or write to [email protected] with your order number.

License checks and offline grace #

• The server needs outbound HTTPS access to Polar's API (api.polar.sh) to check the key.
• The key is checked when you activate it, when the server starts and then every 12 hours.
• If Polar cannot be reached, Pro keeps working for up to 7 days after the last successful check, and everything is back to normal as soon as Polar answers again. The grace never extends a subscription past the end of its paid period. afkwarden license status shows when the grace ends.
• Activation sends Polar the key, our store's organization id (Polar requires it) and an instance label, afkwarden@ followed by 12 hexadecimal characters: a hash of a random identifier created when the plugin was installed. Later checks send the key, the organization id and the activation id Polar assigned. No player data is sent.
• Offline keys, which start with AW1., are issued by Cool Apps for special cases. They are checked on the server itself, without internet access, and can be bound to the install id that afkwarden license status shows.

When Pro ends #

When a subscription ends (cancelled and past its paid period, or not paid), or a key is refunded or revoked, the key stops validating and the server goes back to Free at its next check.

• Nothing is deleted. Your config.yml is kept as it is, every rank included.
• Only the first entry of ranks, in file order, keeps applying (an entry with bypass: true counts too). Players whose ranks are only among the other entries get the global settings. The console names the ignored entries at startup and on every reload, and /afkwarden status and afkwarden license status show them.
• Activating a valid key brings every entry back at once.

If some players must never be kicked whatever the tier, give them the afkwarden.bypass permission: it does not depend on the order of your ranks.

Manage your purchase #

Everything about your order is in Polar's customer portal. Sign in with the e-mail address you used at checkout. There you can:

• copy your license key;
• cancel your subscription. Pro stays active until the end of the period you already paid for, and the server goes back to Free after that;
• update your payment method. If a renewal payment fails, Polar e-mails you a link to the portal to fix it;
• download invoices and receipts, and add your company name, VAT number or billing address to an invoice.

Refunds #

See the refund policy.