Admin and Moderation

Admin root:

• /fa

Core actions:

• /fa bypass
• /fa claim
• /fa unclaim
• /fa disband <faction>
• /fa reload
• /fa safezone [one|square|circle|remove] [radius]
• /fa warzone [one|square|circle|remove] [radius]
• /fa shield <faction> <start-hour (0-23)> <duration-hours>
• /fa shield <faction> clear
• /fa flag <faction> <flag> [on|off]
• /fa audit <faction> [page] [--action=<action>]
• /fa power view <player>
• /fa power set <player> <amount> <reason...>
• /fa power add <player> <amount> <reason...>
• /fa power remove <player> <amount> <reason...>
• /fa power reset <player> <reason...>
• /fa power freeze <player> <on|off>
• /fa power history <player> [page]

Example output (/fa power history <player>):

Permissions:

• factions.admin — full access to all /fa commands
• factions.cmd.safezone — assign / remove safe zone chunks (default op)
• factions.cmd.warzone — assign / remove war zone chunks (default op)
• factions.cmd.shield — set or clear a faction’s war shield window (default op)
• factions.cmd.admin.power — root permission for /fa power
• factions.cmd.admin.power.view / .set / .add / .remove / .reset / .freeze / .history

Config toggles:

• factions.zones.safe-zone.enabled (default true) — disable to treat safe zone chunks as Wilderness
• factions.zones.war-zone.enabled (default true) — disable to treat war zone chunks as Wilderness
• factions.war.shield.enabled (default false) — enable the war shield system before /fa shield has effect
• factions.war.shield.max-duration-hours (default 8) — maximum window length an admin may assign
• factions.power.sources.* — per-source enable/amount controls
• factions.power.constraints.* — min/max/clamp controls
• factions.power.multipliers.* — world/zone scaling controls
• factions.power.freeze.* — frozen-state behavior and admin bypass controls
• factions.power.notifications.* — actor/faction/staff notification routing

Operational notes:

• Use admin claim/unclaim carefully in production to avoid player claim conflicts.
• Safe zone and war zone chunks can only be assigned or removed by admins — players cannot claim over them.
• War shields are stored per-faction in the database and survive restarts. Use /fa shield <faction> clear to remove a window.
• The shield window is evaluated in UTC. Communicate window hours to players in UTC or convert to their local timezone.