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.

Command	Description

The admin menu provides GUI access to all administrative functions including faction management, zone creation, and system settings.

Configuration Commands

Command	Description

Reload applies:

config.json settings
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

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

Radius claiming:

radius - Number of chunks from current position
Add circle to 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

Zone Flags

Each zone type has 25 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
`item_pickup_manual`	false	true	Manual item pickup*
`invincible_items`	true	false	Prevent item destruction*
`fall_damage`	false	true	Allow fall damage
`environmental_damage`	false	true	Drowning, suffocation
`keep_inventory`	true	false	Keep inventory on death*
`power_loss`	false	false	Power loss on death
`mob_spawning`	false	true	Master mob spawn toggle
`hostile_mob_spawning`	false	true	Hostile mob spawning
`passive_mob_spawning`	false	true	Passive mob spawning
`neutral_mob_spawning`	false	true	Neutral mob spawning
`npc_spawning`	false	true	NPC spawning*
`gravestone_access`	false	true	Access gravestones

* Requires OrbisGuard-Mixins mod.

For full flag details, see Zones.

Bypass Mode

Command	Description

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

Modifiable settings:

name - Change faction name
description - Change description
color - Change faction color
power - Set faction power
leader - Change faction leader
open - Set open/closed status

Warning

Admin faction modifications bypass role checks. Use with caution as they directly affect player factions.

Power Management

Command	Description

Economy Management

Command	Description

Data Management

Command	Description

Decay Management

Command	Description

Integration Management

Command	Description

Backup System

HyperFactions includes a built-in backup system with GFS (Grandfather-Father-Son) rotation.

Command	Description

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 power <set\|add\|remove> ...`	Manage player power	`hyperfactions.admin.power`
`/f admin economy <set\|add\|remove> ...`	Manage faction treasury	`hyperfactions.admin.economy`
`/f admin rollback <faction>`	Rollback faction data	`hyperfactions.admin.rollback`
`/f admin clearhistory <faction>`	Clear faction history	`hyperfactions.admin.clearhistory`
`/f admin decay <status\|run\|exempt>`	Manage claim decay	`hyperfactions.admin.decay`
`/f admin integrations`	View integration status	`hyperfactions.admin.integrations`
`/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

Permission	Description

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 circle
```
This 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 arena
```
Repeat 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

Zones - SafeZone and WarZone details
Configuration - Config file reference
Permissions - All permission nodes

Edit this page on GitHub

Admin Commands

Admin Commands

Admin Menu

Configuration Commands

Zone Management

Creating Zones

Claiming Chunks for Zones

Managing Zones

Zone Flags

Bypass Mode

Faction Management

Power Management

Economy Management

Data Management

Decay Management

Integration Management

Backup System

Quick Reference

Admin Permissions

Admin Permissions

Example Workflows

Setting Up Server Spawn

Creating a PvP Arena

Investigating Player Issues

Creating a Manual Backup Before Changes

Removing Inactive Faction

Safety Guidelines

Do

Don't

Related Topics