Permissions
Complete permission reference for HyperFactions v0.4.x.
Permissions Reference
This page documents all permission nodes available in HyperFactions v0.4.x.
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.*
Permission Categories
HyperFactions v0.4.x uses a category-based permission structure. Permissions are organized into logical groups for easier management.
Base Permission (Required)
Base Permission
| Permission | Description | Default |
|---|---|---|
hyperfactions.use | Required base permission for all faction commands | false |
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 | Default |
|---|---|---|
hyperfactions.faction.create | Create new factions | false |
hyperfactions.faction.disband | Dissolve your faction | false |
hyperfactions.faction.rename | Rename your faction | false |
hyperfactions.faction.description | Set faction description | false |
hyperfactions.faction.tag | Set faction tag | false |
hyperfactions.faction.color | Set faction display color | false |
hyperfactions.faction.open | Open faction to free joining | false |
hyperfactions.faction.close | Close faction (require invites) | false |
hyperfactions.faction.permissions | Manage faction territory permissions | false |
Member Management Permissions
Member Permissions (hyperfactions.member.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.member.invite | Invite players to your faction | false |
hyperfactions.member.join | Join open factions or accept invitations | false |
hyperfactions.member.leave | Leave your current faction | false |
hyperfactions.member.kick | Kick members from your faction | false |
hyperfactions.member.promote | Promote members to Officer | false |
hyperfactions.member.demote | Demote Officers to Member | false |
hyperfactions.member.transfer | Transfer faction leadership | false |
Territory Permissions
Territory Permissions (hyperfactions.territory.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.territory.claim | Claim territory for your faction | false |
hyperfactions.territory.unclaim | Release claimed territory | false |
hyperfactions.territory.overclaim | Overclaim enemy territory when their power is low | false |
hyperfactions.territory.map | View the chunk map | false |
Teleport Permissions
Teleport Permissions (hyperfactions.teleport.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.teleport.home | Teleport to faction home | false |
hyperfactions.teleport.sethome | Set faction home location | false |
hyperfactions.teleport.stuck | Use /f stuck to escape hostile territory | false |
Relation Permissions
Relation Permissions (hyperfactions.relation.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.relation.ally | Manage faction alliances | false |
hyperfactions.relation.enemy | Declare factions as enemies | false |
hyperfactions.relation.neutral | Reset relations to neutral | false |
hyperfactions.relation.view | View faction relations | false |
Chat Permissions
Chat Permissions (hyperfactions.chat.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.chat.faction | Use faction chat (/f c) | false |
hyperfactions.chat.ally | Use alliance chat (/f a) | false |
Info Permissions
Info Permissions (hyperfactions.info.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.info.faction | View faction information | false |
hyperfactions.info.list | List all factions | false |
hyperfactions.info.player | View player faction information | false |
hyperfactions.info.power | View power information | false |
hyperfactions.info.members | View faction member list | false |
hyperfactions.info.logs | View faction activity logs | false |
hyperfactions.info.help | Access help documentation | false |
Bypass Permissions
These permissions allow bypassing certain restrictions. Grant with caution.
Bypass Permissions (hyperfactions.bypass.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.bypass.build | Build in any claimed territory | op |
hyperfactions.bypass.interact | Interact with mechanisms anywhere | op |
hyperfactions.bypass.container | Access containers anywhere | op |
hyperfactions.bypass.damage | Bypass PvP restrictions | op |
hyperfactions.bypass.use | Use items anywhere | op |
hyperfactions.bypass.warmup | Skip home teleport warmup | false |
hyperfactions.bypass.cooldown | Skip home teleport cooldown | false |
Warning
Bypass permissions should only be granted to trusted staff. They allow circumventing game mechanics.
Admin Permissions
Admin Permissions (hyperfactions.admin.*)
| Permission | Description | Default |
|---|---|---|
hyperfactions.admin.use | Access admin menu and basic admin features | op |
hyperfactions.admin.reload | Reload configuration | op |
hyperfactions.admin.debug | Toggle debug mode | op |
hyperfactions.admin.zones | Manage SafeZones and WarZones | op |
hyperfactions.admin.disband | Force disband any faction | op |
hyperfactions.admin.modify | Modify any faction's settings | op |
hyperfactions.admin.bypass.limits | Bypass claim and power limits | op |
hyperfactions.admin.backup | Create, list, restore, and delete backups | op |
Limit Permissions
These permissions allow setting per-player or per-group limits.
Limit Permissions
| Permission | Description | Default |
|---|---|---|
hyperfactions.limit.claims.<n> | Set maximum claims limit (e.g., hyperfactions.limit.claims.50) | false |
hyperfactions.limit.power.<n> | Set maximum power limit (e.g., hyperfactions.limit.power.100) | false |
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 | Default |
|---|---|---|
hyperfactions.* | All HyperFactions permissions including admin | op |
hyperfactions.faction.* | All faction management permissions | false |
hyperfactions.member.* | All member management permissions | false |
hyperfactions.territory.* | All territory permissions | false |
hyperfactions.teleport.* | All teleport permissions | false |
hyperfactions.relation.* | All relation permissions | false |
hyperfactions.chat.* | All chat permissions | false |
hyperfactions.info.* | All info permissions | false |
hyperfactions.bypass.* | All bypass permissions | op |
hyperfactions.admin.* | All admin permissions | op |
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.4.x. 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.*
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.4.x) |
|---|---|
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.bypass.* | All bypass permissions |
hyperfactions.admin.* | All admin permissions |
Related Topics
- Roles - Role-based restrictions
- Configuration - Config file settings
- Admin Commands - Admin functionality