entitlements.yml

Every number a player's rank can change lives here. This page covers the file's shape and how a value is resolved; Limits and costs covers granting the nodes.

An entry

entitlements:
  uxmclaims.limit.claim:
    strategy: STACK
    defaultValue: 1
    incrementRate: 1

The map key is the permission prefix. A missing or incomplete entry falls back to the shipped default for that prefix, and the console warns once: entitlements.yml has no complete '<prefix>' entry; using the shipped default.

Limits and delays

A player holds <prefix>.<amount>, for example uxmclaims.limit.claim.5. Each amount is multiplied by incrementRate, then the matches combine:

STACK includes the default: uxmclaims.limit.claim ships with 1, so a rank granting .2 gives three claims. A rate above 1 turns the node into a tier: with rate 20, uxmclaims.limit.claim.5 gives 100 claims. Every shipped limit and delay uses rate 1.

Costs

Costs ignore strategy. A node carries the price, and the lowest matching price wins:

<n> is which item is being bought: the 3rd claim, the 12th chunk. Write a decimal point as _. For item n, a node naming n exactly sets the price; otherwise the nearest lower node (or defaultValue from item 1) is the base, and incrementRate compounds per item after it:

A cost node can raise a price as well as lower it: it replaces defaultValue rather than competing with it.

The shipped defaults

delay.teleport is the warmup before a teleport; the other delays are cooldowns between two uses of the same action, all in seconds. A cooldown refusal answers with errorOnCooldown.

Notes

• Whose nodes count differs. Limits are read from the claim owner, costs and delays from the player acting, and a resolved limit of 0 means unlimited for some limits and none for others. Limits and costs has the details.
• Operators, uxmclaims.admin and <prefix>.* skip the numbers. They get unlimited limits, free costs and no delays.
• Without LuckPerms every player gets defaultValue. The nodes are read through LuckPerms; see permissionSupport in config.yml.
• defaultValue: 1 for claims is deliberately tight. Raise it if your server expects players to hold several claims without buying a rank.
• limit.time interacts with expireMode. With claimSettings.expireMode: false nothing expires and the entitlement is inert. With it on, limit.time caps how far /claim extend may push the expiry: going past it answers errorClaimTimeExceeded.
• Watch inherited groups. With STACK, a VIP inheriting the default group gets the sum of both sets of nodes. This is the usual explanation for a limit that came out higher than intended.