Permission Contexts

Presently, only LuckPerms is supported for this feature. To get more information on how to use contexts in LuckPerms, click this link for their documentation. You need to be running at least LuckPerms version 5.1.0 for FactionsUUID to utilize this feature.

Contexts Offered

Faction ID

factionsuuid:faction-id
Possible values: Any number matching an existing faction's ID
Description: The ID of the faction the player is in. If not in a faction, they get the wilderness ID which is 0. Presently you need to check data/factions.json for the faction ID. The tag is not used because factions could change tag and that would be painful to juggle.

Is peaceful?

factionsuuid:is-peaceful
Possible values: true, false
Description: True if the player is in a peaceful faction.

Is permanent?

factionsuuid:is-permanent
Possible values: true, false
Description: True if the player is in a permanent faction.

Territory relation

factionsuuid:territory-relation
Possible values: member, ally, truce, neutral, enemy
Description: The player's relation to the land they are in. Only one value at a time. Could be used to, for example, prevent players in enemy territory from using particular features of another plugin that are permission-based (not just limited to commands).

factionsuuid:territory-id
Possible values: any number
Description: What is the ID of the faction whose land the player is standing in?

factionsuuid:territory-is-safezone
Possible values: true, false
Description: Is the player standing in safezone?

factionsuuid:territory-is-warzone
Possible values: true, false
Description: Is the player standing in warzone?

factionsuuid:territory-is-wilderness
Possible values: true, false
Description: Is the player standing in unclaimed land (wilderness)?

Faction role at least

factionsuuid:role-at-least
Possible values: admin, coleader, moderator, normal, recruit
Description: If a player is a recruit, they will only have the recruit value. If moderator, they will have moderator, normal, and recruit. Could be used to, for example, grant a permission node only to faction admins.

Faction role at most

factionsuuid:role-at-most
Possible values: admin, coleader, moderator, normal, recruit
Description: If a player is an admin, they will only have the admin value. If moderator, they will have moderator, coleader, and admin. Could be used to, for example, grant a permission node only to normal members and recruits.