Admin Commands
Server administration commands for HyperFactions.
Admin Commands
These commands are for server administrators to manage factions, zones, backups, and the mod itself. Admin commands require permissions from the hyperfactions.admin.* category.
Admin Menu
| Command | Description | Permission |
|---|---|---|
/f admin | Open the admin management GUI | hyperfactions.admin.use |
The admin menu provides GUI access to all administrative functions including faction management, zone creation, and system settings.
Configuration Commands
| Command | Description | Permission |
|---|---|---|
/f admin reload | Reload the configuration file | hyperfactions.admin.reload |
/f admin debug | Toggle debug mode for troubleshooting | hyperfactions.admin.debug |
Reload applies:
config.jsonsettings- Message configuration
- Power settings
- All other configuration changes
Info
Some changes may require a server restart. The reload command handles most configuration changes.
Debug mode:
- Shows detailed logging for troubleshooting
- Outputs to console and/or chat
- Categories can be configured in
config.json
Zone Management
The zone system allows admins to create named zones that span multiple chunks with customizable flags.
Creating Zones
| Command | Description | Permission |
|---|---|---|
/f admin zone create <safe|war> <name> | Create a new named zone (SafeZone or WarZone) | hyperfactions.admin.zones |
Zone Types:
safe- SafeZone (no PvP, no building, protected area)war- WarZone (PvP enabled, no power loss by default)
Claiming Chunks for Zones
| Command | Description | Permission |
|---|---|---|
/f admin zone claim <name> | Add the current chunk to an existing zone | hyperfactions.admin.zones |
/f admin zone radius <name> <radius> [circle] | Claim a radius of chunks for a zone | hyperfactions.admin.zones |
Radius claiming:
radius- Number of chunks from current position- Add
circleto claim in a circular pattern instead of square
Example: /f admin zone radius spawn 5 circle claims a circular area with 5-chunk radius.
Managing Zones
| Command | Description | Permission |
|---|---|---|
/f admin zone unclaim | Remove the current chunk from its zone | hyperfactions.admin.zones |
/f admin zone delete <name> | Delete a zone entirely (unclaims all chunks) | hyperfactions.admin.zones |
/f admin zone list [safe|war] | List all zones, optionally filtered by type | hyperfactions.admin.zones |
Zone Flags
Each zone type has 15 configurable flags. Use the admin GUI to modify zone flags:
| Flag | SafeZone Default | WarZone Default | Description |
|---|---|---|---|
pvp_enabled | false | true | Allow PvP |
friendly_fire | false | false | Allow same-faction damage |
projectile_damage | false | true | Allow projectile damage |
mob_damage | false | true | Allow mob damage |
build_allowed | false | false | Allow building |
block_interact | true | true | General block interaction |
door_use | true | true | Use doors and gates |
container_use | false | false | Access storage containers |
bench_use | false | false | Use crafting tables |
processing_use | false | false | Use furnaces/smelters |
seat_use | true | true | Sit on seats/mounts |
item_drop | false | true | Allow item dropping |
item_pickup | true | true | Allow item pickup |
fall_damage | false | true | Allow fall damage |
environmental_damage | false | true | Drowning, suffocation |
For full flag details, see Zones.
Bypass Mode
| Command | Description | Permission |
|---|---|---|
/f admin bypass | Toggle admin bypass mode | hyperfactions.admin.use |
Bypass Mode Enables:
- Build in any claimed territory
- Open containers anywhere
- Interact with mechanisms
- Useful for investigating or fixing issues
Toggle:
- Run once to enable
- Run again to disable
Tip
Remember to disable bypass mode when done to avoid accidentally breaking player builds.
Faction Management
| Command | Description | Permission |
|---|---|---|
/f admin disband <faction> | Force disband any faction | hyperfactions.admin.disband |
/f admin modify <faction> <setting> <value> | Modify any faction's settings | hyperfactions.admin.modify |
Modifiable settings:
name- Change faction namedescription- Change descriptioncolor- Change faction colorpower- Set faction powerleader- Change faction leaderopen- Set open/closed status
Warning
Admin faction modifications bypass role checks. Use with caution as they directly affect player factions.
Backup System
HyperFactions includes a built-in backup system with GFS (Grandfather-Father-Son) rotation.
| Command | Description | Permission |
|---|---|---|
/f admin backup create [name] | Create a manual backup with optional custom name | hyperfactions.admin.backup |
/f admin backup list | List all available backups | hyperfactions.admin.backup |
/f admin backup restore <name> | Restore from a specific backup | hyperfactions.admin.backup |
/f admin backup delete <name> | Delete a specific backup | hyperfactions.admin.backup |
Backup retention (configurable):
- Hourly backups: 24 (1 day)
- Daily backups: 7 (1 week)
- Weekly backups: 4 (1 month)
Restore Warning
Restoring a backup overwrites current data. Consider creating a backup before restoring.
Quick Reference
| Command | Description | Permission |
|---|---|---|
/f admin | Open admin menu | hyperfactions.admin.use |
/f admin reload | Reload configuration | hyperfactions.admin.reload |
/f admin debug | Toggle debug mode | hyperfactions.admin.debug |
/f admin bypass | Toggle bypass mode | hyperfactions.admin.use |
/f admin zone create <type> <name> | Create a zone | hyperfactions.admin.zones |
/f admin zone claim <name> | Add chunk to zone | hyperfactions.admin.zones |
/f admin zone unclaim | Remove chunk from zone | hyperfactions.admin.zones |
/f admin zone delete <name> | Delete zone | hyperfactions.admin.zones |
/f admin zone list | List zones | hyperfactions.admin.zones |
/f admin zone radius <name> <r> | Claim radius | hyperfactions.admin.zones |
/f admin disband <faction> | Force disband | hyperfactions.admin.disband |
/f admin modify <faction> ... | Modify faction | hyperfactions.admin.modify |
/f admin backup create | Create backup | hyperfactions.admin.backup |
/f admin backup list | List backups | hyperfactions.admin.backup |
/f admin backup restore <name> | Restore backup | hyperfactions.admin.backup |
/f admin backup delete <name> | Delete backup | hyperfactions.admin.backup |
Admin Permissions
Admin Permissions
| 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 | Manage backups | op |
hyperfactions.admin.* | All admin permissions | op |
Example Workflows
Setting Up Server Spawn
-
Create the SafeZone:
/f admin zone create safe spawn -
Claim the spawn area:
/f admin zone radius spawn 3 circleThis claims a 3-chunk radius circle around your position.
-
Verify:
/f admin zone list safe
Creating a PvP Arena
-
Build the arena structure first
-
Create the WarZone:
/f admin zone create war arena -
Stand in the arena and claim:
/f admin zone claim arenaRepeat for each chunk, or use radius:
/f admin zone radius arena 2 -
Reload configuration if needed:
/f admin reload
Investigating Player Issues
-
Enable bypass:
/f admin bypass -
Enable debug mode if needed:
/f admin debug -
Investigate the area
-
Disable bypass and debug when done:
/f admin bypass /f admin debug
Creating a Manual Backup Before Changes
-
Create named backup:
/f admin backup create pre-update -
Make your changes
-
If something goes wrong:
/f admin backup restore pre-update
Removing Inactive Faction
-
Check faction info first:
/f info InactiveFaction -
Force disband:
/f admin disband InactiveFaction
Safety Guidelines
Do
- Keep bypass mode disabled when not needed
- Document zone changes for other admins
- Create backups before major changes
- Test configuration changes on a staging server first
- Use debug mode to troubleshoot issues
Don't
- Leave bypass enabled accidentally
- Force disband without investigating
- Restore backups without creating a current backup first
- Modify factions without documenting the reason
Related Topics
- Zones - SafeZone and WarZone details
- Configuration - Config file reference
- Permissions - All permission nodes