Permissions
Complete permission reference for HyperFactions v0.8.0.
Permissions Reference
This page documents all permission nodes available in HyperFactions v0.8.0.
Breaking Change in v0.3.0
As of v0.3.0, HyperFactions requires explicit permission grants. The fallback behavior changed from "allow" to "deny". Players without the hyperfactions.use permission cannot access any faction commands.
You must configure permissions before players can use factions!
Quick Setup with HyperPerms
Grant default players access to all standard faction features:
/hp group setperm default hyperfactions.use
/hp group setperm default hyperfactions.faction.*
/hp group setperm default hyperfactions.member.*
/hp group setperm default hyperfactions.territory.*
/hp group setperm default hyperfactions.teleport.*
/hp group setperm default hyperfactions.relation.*
/hp group setperm default hyperfactions.chat.*
/hp group setperm default hyperfactions.info.*
/hp group setperm default hyperfactions.economy.*
Permission Categories
HyperFactions v0.8.0 uses a category-based permission structure. Permissions are organized into logical groups for easier management.
Base Permission (Required)
Base Permission
| Permission | Description |
|---|
Important
Without hyperfactions.use, players cannot access ANY faction functionality. This permission must be explicitly granted.
Faction Management Permissions
These permissions control core faction operations.
Faction Permissions (hyperfactions.faction.*)
| Permission | Description |
|---|
Member Management Permissions
Member Permissions (hyperfactions.member.*)
| Permission | Description |
|---|
Territory Permissions
Territory Permissions (hyperfactions.territory.*)
| Permission | Description |
|---|
Teleport Permissions
Teleport Permissions (hyperfactions.teleport.*)
| Permission | Description |
|---|
Relation Permissions
Relation Permissions (hyperfactions.relation.*)
| Permission | Description |
|---|
Chat Permissions
Chat Permissions (hyperfactions.chat.*)
| Permission | Description |
|---|
Economy Permissions
Economy Permissions (hyperfactions.economy.*)
| Permission | Description |
|---|
Info Permissions
Info Permissions (hyperfactions.info.*)
| Permission | Description |
|---|
Bypass Permissions
These permissions allow bypassing certain restrictions. Grant with caution.
Bypass Permissions (hyperfactions.bypass.*)
| Permission | Description |
|---|
Warning
Bypass permissions should only be granted to trusted staff. They allow circumventing game mechanics.
Admin Permissions
Admin Permissions (hyperfactions.admin.*)
| Permission | Description |
|---|
Limit Permissions
These permissions allow setting per-player or per-group limits.
Limit Permissions
| Permission | Description |
|---|
Limit Permissions
Replace <n> with a number. For example, hyperfactions.limit.claims.100 allows up to 100 claims. The highest matching limit is used.
Wildcard Permissions
Wildcard Permissions
| Permission | Description |
|---|
Permission Defaults
| Default | Meaning |
|---|---|
false | Must be explicitly granted |
op | Only server operators have this by default |
No True Defaults
Unlike previous versions, no permissions default to true in v0.8.0. All permissions must be explicitly granted through your permission system.
HyperPerms Integration
Recommended Setup
Default Players (all standard features):
/hp group setperm default hyperfactions.use
/hp group setperm default hyperfactions.faction.*
/hp group setperm default hyperfactions.member.*
/hp group setperm default hyperfactions.territory.*
/hp group setperm default hyperfactions.teleport.*
/hp group setperm default hyperfactions.relation.*
/hp group setperm default hyperfactions.chat.*
/hp group setperm default hyperfactions.info.*
/hp group setperm default hyperfactions.economy.*
VIP Players (bypass teleport delays):
/hp group setperm vip hyperfactions.bypass.warmup
/hp group setperm vip hyperfactions.bypass.cooldown
Moderators (bypass protection for investigations):
/hp group setperm moderator hyperfactions.bypass.build
/hp group setperm moderator hyperfactions.bypass.container
/hp group setperm moderator hyperfactions.bypass.interact
Administrators (full access):
/hp group setperm admin hyperfactions.*
Permission by Role
While permissions control who can attempt an action, faction roles control who can succeed:
| Permission Has | Role Has | Result |
|---|---|---|
| Yes | Yes | Success |
| Yes | No | Role denied |
| No | Yes | Permission denied |
| No | No | Permission denied |
Example: A Member with hyperfactions.member.promote permission still cannot promote others because only Leaders can promote by role.
Migration from v0.2.x
If upgrading from v0.2.x, update your permission nodes:
| Old (v0.2.x) | New (v0.8.0) |
|---|---|
hyperfactions.create | hyperfactions.faction.create |
hyperfactions.invite | hyperfactions.member.invite |
hyperfactions.kick | hyperfactions.member.kick |
hyperfactions.claim | hyperfactions.territory.claim |
hyperfactions.unclaim | hyperfactions.territory.unclaim |
hyperfactions.map | hyperfactions.territory.map |
hyperfactions.overclaim | hyperfactions.territory.overclaim |
hyperfactions.home | hyperfactions.teleport.home |
hyperfactions.sethome | hyperfactions.teleport.sethome |
hyperfactions.promote | hyperfactions.member.promote |
hyperfactions.demote | hyperfactions.member.demote |
hyperfactions.transfer | hyperfactions.member.transfer |
hyperfactions.ally | hyperfactions.relation.ally |
hyperfactions.enemy | hyperfactions.relation.enemy |
hyperfactions.neutral | hyperfactions.relation.neutral |
hyperfactions.disband | hyperfactions.faction.disband |
hyperfactions.rename | hyperfactions.faction.rename |
hyperfactions.desc | hyperfactions.faction.description |
hyperfactions.color | hyperfactions.faction.color |
hyperfactions.open | hyperfactions.faction.open |
hyperfactions.close | hyperfactions.faction.close |
hyperfactions.logs | hyperfactions.info.logs |
hyperfactions.bypass.protection | hyperfactions.bypass.* (multiple nodes) |
hyperfactions.admin | hyperfactions.admin.* |
Quick Reference Table
| Permission | Description |
|---|---|
hyperfactions.use | Required base permission |
hyperfactions.faction.* | All faction management |
hyperfactions.member.* | All member management |
hyperfactions.territory.* | All territory management |
hyperfactions.teleport.* | All teleport features |
hyperfactions.relation.* | All diplomacy features |
hyperfactions.chat.* | All chat features |
hyperfactions.info.* | All info commands |
hyperfactions.economy.* | All economy features |
hyperfactions.bypass.* | All bypass permissions |
hyperfactions.admin.* | All admin permissions |
Related Topics
- Roles - Role-based restrictions
- Configuration - Config file settings
- Admin Commands - Admin functionality