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.

CurseForge: https://www.curseforge.com/hytale/mods/ultimate-factions

Credit required: If you use or redistribute this mod or its code, you must credit Darko6666.

License: MIT

What’s New in v1.4.0
Main Features
Commands
Admin GUI Options
Data Storage
Installation
Build & Development
Support & Issues
Contributing
Why Ultimate Faction?
Credits

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

Installation

Download the mod from CurseForge or build it yourself
Place the mod file in your Hytale server mods/plugins folder
Start the server once to generate config/data files
Configure settings in plugins_data/UltimateFactions/config.json
Restart the server and use /f commands in-game

Build & Development

Requirements: JDK 17+ and Gradle
Build: ./gradlew build (Windows: gradlew.bat build)
Local run (if configured): ./gradlew run
Output: build/libs/

Support & Issues

Report bugs and feature requests via GitHub Issues
Include server version, logs, and steps to reproduce
For general info and downloads, see CurseForge

Contributing

Feel free to fork and propose changes via pull requests
Please keep credits to Darko6666 in forks and derivatives
By contributing, you agree your changes are shared under the MIT license

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

Credits

Author: Darko6666
Please credit Darko6666 if you use or redistribute this mod or its code

Ultimate Factions