Capacity tiers

Mailbox size is set per rank. You define tiers in the config, and each tier grants a permission. A player gets the page count of the highest tier they have.

How capacity is calculated

capacity = pages for the player's rank x slots-per-page

So with slots-per-page: 45 and a 2-page tier, that player can hold 90 items.

Defining tiers

Tiers live under mailbox.pages.max-pages. Each entry is a name and a page count:

mailbox:
  pages:
    slots-per-page: 45
    max-pages:
      unlimited: 999   # atmailbox.capacity.unlimited
      mvp: 6           # atmailbox.capacity.mvp
      vip: 4           # atmailbox.capacity.vip
      default: 2       # everyone

Each tier <name> grants the permission atmailbox.capacity.<name>. For example, vip: 4 is unlocked by atmailbox.capacity.vip.

Tiers are not fixed

You can add, rename, or remove tiers freely. They are not hardcoded. To add an elite tier with 10 pages:

max-pages:
  elite: 10   # grants atmailbox.capacity.elite
  unlimited: 999
  mvp: 6
  vip: 4
  default: 2

Then grant atmailbox.capacity.elite to your elite rank in your permissions plugin.

How the highest tier wins

A player can hold permissions for several tiers at once. AT-MailBox uses the tier with the highest page count among the ones they have. The tier with the higher number wins, regardless of its name or order in the file.

For example, a player with both atmailbox.capacity.vip (4 pages) and atmailbox.capacity.mvp (6 pages) gets 6 pages.

Related pages

• Permissions lists the built-in capacity permissions.
• Configuration covers slots-per-page and the rest of the config.