Concepts

Federation

A federation is a group of servers that exchange ban records. Every server is a member with its own signing key. There is one public federation, and any network can run a private one.

Record

A record is created when a moderator bans someone on a member server and the ban reason maps to a shared category. It contains:

• the player UUID and the last known name,
• the category (cheating, griefing, chat-abuse, ban-evasion, other),
• the duration, or none for permanent bans,
• evidence links, if the moderator added any with -e <url>,
• the issuing member and its signature.

Records are signed since 0.12.0. A member can not change or forge another member’s record, and a revoked record is a new signed record, not a deletion.

Policy

Each member decides what to do with incoming records. A policy can apply the ban, flag the player for staff when they join, or ignore the record. See Policies and appeals.

Sync

Members keep one streaming connection to the federation and receive records as they are issued. After a disconnect the plugin asks for everything since the last record it saw, so nothing is lost during a restart.