Ultimate Faction – v1.4.0

Ultimate Faction is a full-featured and highly optimized faction system for Hytale servers. It combines classic faction gameplay with modern systems such as GUI-based management, power mechanics, SafeZones & WarZones, advanced protections, diplomacy, chat channels, and reliable JSON persistence.

What’s New in v1.4.0

Fixes & Improvements

• SafeZone / WarZone / Claim protections fully fixed (break, place, interact now respect permissions)
• Configurable OP bypass for protection checks
• /f guiadm UI fixed: stable CustomUI bindings and persistent values
• Admin permissions now saved correctly
• SafeZone & WarZone permissions correctly applied (chests, build, interactions)
• UI crash “Failed to apply CustomUI event bindings” resolved
• /f map crash fixed (GUI now opens on the correct world thread)
• Map teleport (key M) disabled
• Other players hidden on the map (only faction members are visible)
• Faction prefix [Faction] added before player names
  • Color-coded by relation: same / ally / enemy / neutral
• Faction chat (/f chat) and ally chat (/f allychat) added
• Admin spy chat support
• Power system improved:
  • Power loss on death
  • Power gain on kill
  • Automatic power regeneration over time
• New command: /f unclaimall --confirm (full faction unclaim)
• Admin commands rewritten to avoid “wrong number of arguments” errors

Main Features

Factions

• Create and manage factions
• Roles: LEADER, OFFICER, MEMBER
• Invites, join, kick, promote, demote
• Faction info, list, rename, leader transfer

Claims & Zones

• Chunk-based claims (16x16)
• Protected faction land
• SafeZone: no build, no interact, no PvP
• WarZone: PvP enabled, build blocked

Power System

• Faction power = sum of member power
• Claim capacity limited by power
• Faction vulnerable when claims > power
• Power gained by kills and regeneration
• Power lost on death

Overclaim

• Only possible if target faction is vulnerable
• Leader or Officer required
• Outside-in rule: border claims must be overclaimed first
• Allies cannot be overclaimed

Diplomacy

• Ally, Enemy, Neutral relations
• Accept flow for relations
• Relations shown in /f info, map, and player name prefixes

Maps

• /f map: GUI map with claims, markers, legend
• Instant refresh on claim/unclaim
• Only faction members visible

GUI System

• /f gui: player menu
• /f guiadm: admin panel
• All permissions, power, and home settings configurable via GUI

Faction Homes

• /f sethome and /f home
• Cooldown support
• Teleport cancelled by combat-tag

Chat System

• Faction chat: /f chat <message>
• Ally chat: /f allychat <message>
• Admin spy chat toggle

Commands

Player / Faction

/f create <name>
/f disband
/f invite <player>
/f join <name>
/f leave
/f kick <player>
/f promote <player>
/f demote <player>
/f info [name]
/f list
/f claim
/f unclaim
/f unclaimall --confirm
/f map
/f chat <message>
/f allychat <message>
/f ally <faction>
/f enemy <faction>
/f accept <ally|enemy> <faction>
/f neutral <faction>
/f sethome
/f home
/f gui
/f guiadm

Admin / OP Commands

/f admin panel
/f admin reload
/f admin save
/f admin claim <faction|safezone|warzone> [radius]
/f admin unclaim <faction|safezone|warzone> [radius]
/f admin power <set|add> <player|faction> <value>
/f admin perms <safezone|warzone|preset>
/f admin spychat <on|off>
/f admin home <set|clear> <faction>
/f admin rename <faction> <newName>
/f admin leader <faction> <player>
/f admin wipe <faction>
/f admin disband <faction>

OP Zones

/f safezone
/f warzone

Admin GUI Options

• PowerKillGain: power gained per kill
• PowerRegenIntervalSeconds: regen interval
• PowerRegenAmount: regen amount
• All power, permission and home settings are persistent

Data Storage

plugins_data/UltimateFactions/
├── factions.json
├── claims.json
├── players.json
└── config.json

• JSON-based storage
• Autosave enabled
• Safe on restart

Why Ultimate Faction?

• Stable and optimized for real servers
• Full GUI-driven experience
• Advanced power and overclaim mechanics
• Perfect for PvP and faction-based gameplay