Donor Entitlements

The entitlement system manages feature access across Donor and Free tiers.

Tiers

Feature	Free	Donor
Blocklist	10 emojis	Unlimited
Reaction Limits	Disabled	Enabled
Tickets	Disabled	Unlimited panels
Steam Link	10 links	Unlimited
Evidence Vault	Disabled	Enabled
R2 Storage	100 MB	1 GB

How It Works

Role Detection

Donor status is determined by the presence of specific Discord roles on the HAF Admin Guild:

• DONOR_PAID_ROLE_ID — Standard Donor tier
• DONOR_PLUS_ROLE_ID — Donor+ tier

These roles are typically managed by an external subscription bot.

Claim Process

When a guild subscribes to the Donor tier:

1. They receive the Donor role on the HAF Admin Guild
2. The bot detects the role assignment via GUILD_MEMBER_UPDATE gateway events
3. The guild's entitlement is upgraded to Donor status
4. All Donor features become available

Grace Period

When a subscription lapses (the Donor role is removed):

1. The guild enters a grace period (configurable, default 7 days)
2. Full Donor features remain active during grace
3. If the role is restored within the grace period, normal service resumes
4. If the grace period expires, the guild is downgraded to Free tier

If donor status drops, the guild enters a grace period before downgrading. If the donor role returns in time, service stays on Donor.

In the admin dashboard, the Overview page shows the current tier, and the Donor Claims page shows which servers are claimable or already claimed.