A comprehensive faction management mod for Hytale servers featuring territory claims, alliances, strategic PvP, economy, and extensive customization. Part of the HyperSystems plugin suite.
HyperFactions transforms your Hytale server into a dynamic faction-based environment where players create factions, claim territories, forge alliances, manage treasuries, and engage in strategic PvP combat. With 59 interactive GUI pages, 42 commands, and deep integration with the HyperSystems ecosystem, it provides a complete faction experience out of the box.
Main Commands: /faction | /f | /hf
| Feature | Status |
|---|---|
| Create, disband, rename factions | Implemented |
| Customizable colors and descriptions | Implemented |
| Three-tier roles (Leader, Officer, Member) | Implemented |
| Smart invitation system with expiration | Implemented |
| Join requests for closed factions | Implemented |
| Configurable member limits | Implemented |
| Feature | Status |
|---|---|
| Chunk-based claiming with visual feedback | Implemented |
| World map overlays with faction colors | Implemented |
| Power-based claim limits | Implemented |
| Adjacent claims mode | Implemented |
| Overclaiming for strategic warfare | Implemented |
| Inactive faction claim decay | Implemented |
| Multi-world support | Implemented |
| Terrain-based map mode | Implemented |
| Feature | Status |
|---|---|
| Per-player power with configurable cap | Implemented |
| Death penalty (configurable) | Implemented |
| Auto-regeneration at intervals | Implemented |
| Per-zone power loss flags | Implemented |
| Admin power management | Implemented |
| Feature | Status |
|---|---|
| Ally, enemy, neutral relations | Implemented |
| Alliance request/accept/reject workflow | Implemented |
| Color-coded displays in GUI and chat | Implemented |
| Feature | Status |
|---|---|
| Combat tagging with logout prevention | Implemented |
| Relationship-based PvP rules | Implemented |
| Spawn protection | Implemented |
| Feature | Status |
|---|---|
| Faction chat with history | Implemented |
| Alliance chat | Implemented |
| Public chat faction tags | Implemented |
| Feature | Status |
|---|---|
| Faction treasury with balance tracking | Implemented |
| Deposits, withdrawals, inter-faction transfers | Implemented |
| Transaction log | Implemented |
| VaultUnlocked integration | Implemented |
| Ecotale integration | Planned #20 |
| Feature | Status |
|---|---|
| Block, item, PvP protection | Implemented |
| OrbisGuard-Mixins (11 hooks) | Implemented |
| Mob spawn suppression | Implemented |
| Gravestones integration | Implemented |
| Zone flags (25+) | Implemented |
| Command blocking in zones | Planned #29 |
| Feature | Status |
|---|---|
| 59 interactive pages across 3 registries | Implemented |
| Admin dashboard | Implemented |
| Faction browser with search | Implemented |
| Territory map with terrain imagery | Implemented |
| Real-time updates | Implemented |
| Feature | Status |
|---|---|
| Zone management (SafeZone, WarZone) | Implemented |
| Backup system (GFS rotation) | Implemented |
| Data import (ElbaphFactions, HyFactions) | Implemented |
| Config migration (v1-v5) | Implemented |
| Update checker | Implemented |
| Admin GUI: Config editor | Planned #40 |
| Admin GUI: Backup manager | Planned #41 |
| Admin GUI: Updates page | Planned #42 |
| Feature | Status |
|---|---|
| HyperPerms | Implemented |
| LuckPerms | Implemented |
| VaultUnlocked | Implemented |
| PlaceholderAPI (35 placeholders) | Implemented |
| WiFlow | Implemented |
| OrbisGuard / OrbisGuard-Mixins | Implemented |
| Gravestones | Implemented |
| Feature | Status |
|---|---|
| Database storage backend | Planned #45 |
| Performance caching | Planned #44 |
| Command aliases | Planned #43 |
| Faction levels & progression | Planned #39 |
| Raid system | Planned #38 |
| War declarations | Planned #37 |
| Faction vaults | Planned #35 |
| Server-managed factions | Planned #33 |
| Relational placeholders | Planned #26 |
| NPC integrations | Considering #21 |
| Localization | Planned #19 |
| CurseForge updates | Planned #17 |
- Download the latest release from GitHub Releases or CurseForge
- Install by placing
HyperFactions-<version>.jarin your server'smods/directory - Configure by editing
mods/com.hyperfactions_HyperFactions/config.jsonafter first startup - Create a faction with
/f create MyFactionand claim territory with/f claim
Optional: Install HyperPerms for enhanced permission control with groups, tracks, and contextual permissions.
Comprehensive developer and admin documentation is available in the docs/ directory:
| Document | Description |
|---|---|
| architecture.md | 9-layer design, package structure, dependency graph |
| managers.md | 15 core managers with responsibilities and lifecycles |
| Document | Description |
|---|---|
| commands.md | 42 subcommands across 10 categories with full syntax |
| permissions.md | 60 permission nodes, chain-based resolution |
| config.md | ConfigManager, 8 module configs, migration (v1-v5) |
| storage.md | Interface-based storage, JSON adapters, backup system |
| gui.md | 59 pages, 3 registries, navigation flows |
| protection.md | ECS handlers, OrbisGuard-Mixins, zone flags |
| Document | Description |
|---|---|
| api.md | HyperFactionsAPI, EconomyAPI, EventBus for third-party mods |
| integrations.md | HyperPerms, LuckPerms, PAPI, WiFlow, OrbisGuard, Gravestones |
| placeholders.md | All 35 PAPI & WiFlow placeholders with examples |
| Document | Description |
|---|---|
| announcements.md | Server-wide broadcasts, 7 event types |
| data-import.md | ElbaphFactions/HyFactions importers, config migration |
- Java 25
- Gradle 9.3.0+ (included via wrapper)
- Hytale Server JAR (Early Access)
# From HyperSystems root (multi-project build):
./gradlew :HyperFactions:shadowJar
# Output: HyperFactions/build/libs/HyperFactions-<version>.jarSee CONTRIBUTING.md for full development setup and contribution guidelines.
- Discord: Join our server
- GitHub Issues: Report bugs or request features
HyperFactions is part of the HyperSystems plugin ecosystem. All plugins integrate seamlessly when installed together.
| Mod | Description | Status | Link |
|---|---|---|---|
| HyperPerms | Permissions management with groups, tracks, and web editor | Production | GitHub |
| HyperHomes | Personal home teleportation with sharing | Production | GitHub |
| HyperFactions | Faction management with territory, diplomacy, and economy | Production | GitHub |
| HyperWarp | Warps, spawns, TPA requests, and /back | Production | GitHub |
| HyperSpawns | Mob spawn zone control with advanced filtering | Production | GitHub |
| HyperGuard | Server-side anti-cheat | In Development | GitHub |
| HyperVerse | World management (Multiverse-like) | In Development | GitHub |
| HyperLogger | Activity logging and rollback | In Development | GitHub |
HyperFactions is licensed under the GNU General Public License v3.0.
Developed by HyperSystemsDev — Forge Your Empire