⚔️ Elbaph Factions - Changelog

The complete faction system for Hytale. Build empires, wage wars, and dominate territories.

🆕 Version 1.3.2 - Hotfix Release

Release Date: January 19, 2026

✅ Fixed

• Command Parsing: All diplomacy commands now work correctly

  • /ef war <faction> - Fixed "Faction not found: ef" error
  • /ef ally <faction> - Properly parses faction names
  • /ef neutral <faction> - Works with all command aliases
  • /ef invite <player> - Fixed "Player not found: invite" error

• Faction Settings UI: Complete redesign and fixes

  • Two-column layout matching modern UI standards
  • Fixed checkbox functionality - now properly saves land protection settings
  • Text input no longer requires letter-by-letter typing
  • Save button now persists all changes correctly
  • Close button works properly
  • Fixed invite dropdown overlap issue

• Diplomacy UI: Stability improvements

  • Tab switching (ALLIES/NEUTRAL/ENEMIES) no longer crashes
  • Action buttons properly rebuild UI after executing
  • Eliminated "Object reference not set" crashes
  • Fixed "Selected element not found" selector errors

• Invite System: Full functionality restored

  • UI invite button now properly sends invites
  • Command supports both online and offline players
  • Added PlayerNameTracker reverse lookup for offline players
  • Proper success/error messages and notifications

• Visual Fixes:

  • Removed all emojis that were displaying as ?? in Hytale
  • Replaced with text equivalents (WAR, ALLY, CHAT, etc.)

• Safety Features:

  • Added two-click confirmation for faction disband
  • Prevents accidental faction deletion

⚡ Improved

• Text Input: Fixed letter-by-letter bug - you can now type normally in all text fields
• Checkbox Persistence: Land protection settings now save correctly and persist across sessions
• Offline Player Support: Invite command now works for players who have joined the server before
• UI Stability: Comprehensive error handling prevents crashes in diplomacy and settings pages
• Command Parsing: Improved argument parsing to handle full command strings correctly

📦 Version 1.1.2 - Production Ready

Release Date: December 2025

🎉 Initial Release Features

🛡️ Core Systems

• Silent Protection System

  • No spam messages - protection works seamlessly in background
  • Blocks break/place/interact for non-members
  • Configurable per-faction land protection settings
  • Separate permissions for outsiders, allies, and members

• Power-Based Raiding

  • Dynamic power system: Max Power = Members × 10
  • Power regeneration: +0.1 per minute per online member
  • Death penalty: -2.0 power (or -5.0 for combat logging)
  • Overclaim Mechanic: When Claims > Power, enemies can raid your land

• World Map Integration

  • Press 'M' to see all claims, zones, and territories
  • Real-time updates when claims change
  • Color-coded territories: Green (Ally), Red (Enemy), Gray (Neutral)
  • Visual distinction for SafeZones and WarZones

👥 Role & Permission System

• Three-Tier Hierarchy:

  • Leader: Full control, can disband faction
  • Officer: Can invite, claim land, manage diplomacy
  • Member: Basic access to faction features

• Granular Permissions:

  • INVITE - Send faction invites
  • CLAIM - Claim/unclaim territory
  • MANAGE_ALLIES - Handle diplomacy and alliances
  • KICK - Remove members from faction
  • MANAGE_HOME - Set faction home location

🗺️ Territory Management

• Interactive Map GUI

  • /ef map - Opens 17×17 chunk grid
  • Click to claim/unclaim chunks
  • Visual feedback for all territories
  • Shows player position in real-time

• Claiming System

  • /ef claim - Claim current 16×16 chunk
  • /ef unclaim - Remove claim from current chunk
  • Power-based claim limits
  • Cannot claim in SafeZones or WarZones

• Home & Teleportation

  • /ef sethome - Set faction home (Leader/Officer)
  • /ef home - Teleport to faction home
  • 5-second delay (cancels on move/damage)
  • 5-minute cooldown between uses
  • Blocked during combat tag (15 seconds)

⚔️ Combat & Diplomacy

• Combat Tag System

  • 15-second combat tag on PvP damage
  • Prevents teleportation during combat
  • -5.0 power penalty for combat logging
  • Visual indicator when tagged

• Diplomacy Commands

  • /ef ally <faction> - Request alliance (mutual)
  • /ef enemy <faction> - Declare war (mutual)
  • /ef neutral <faction> - Set neutral relationship
  • Color-coded on world map

• Faction Chat

  • /ef chat - Toggle faction-only chat
  • /ef achat - Toggle alliance chat
  • Private communication channels
  • Persistent across sessions

🎨 Professional UIs

• Faction Settings Page

  • Beautiful two-column layout
  • Member management with role display
  • Land protection toggles
  • PvP enable/disable
  • Color picker for faction color
  • Invite system with dropdown

• Diplomacy Page

  • Tabbed interface (Allies/Neutral/Enemies)
  • Faction statistics display
  • Quick action buttons
  • Real-time relationship management

• Admin Panel

  • SafeZone/WarZone creation GUI
  • Visual 16×16 chunk grid
  • Click to set/remove zones
  • Admin bypass toggle

🔧 Admin Features

• Zone Management

  • /ef admin safezone - Open SafeZone GUI (No PvP zones)
  • /ef admin warzone - Open WarZone GUI (All PvP zones)
  • Visual chunk-based zone creation
  • Prevents claiming in zones

• Admin Tools

  • /ef admin bypass - Toggle protection bypass
  • Ignore all claims and restrictions
  • Op/Admin permission required

📊 Data Management

• Storage System

  • JSON-based data storage
  • Human-readable format
  • Auto-saves every 30 seconds
  • Located in mods/ElbaphFactions/

• Files:

  • factions.json - Faction data and members
  • claims.json - Territory claims
  • config.json - Server configuration
  • playernames.json - Player name cache

⚙️ Configuration

Default configuration values:

{
  "powerPerPlayer": 10,
  "powerLossOnDeath": 2.0,
  "powerLossOnCombatLog": 5.0,
  "powerRegenerationRate": 0.1,
  "combatTagDurationSeconds": 15,
  "teleportDelaySeconds": 5,
  "teleportCooldownMillis": 300000,
  "inviteExpiryMinutes": 5
}

📜 Complete Command Reference

Player Commands

Admin Commands

Command Aliases

• /ef = /f = /factions
• /ef enemy = /ef war
• /ef neutral = /ef peace
• /ef chat = /ef c = /ef fc
• /ef achat = /ef ac = /ef allychat

🎯 Power System Mechanics

Power Calculation

• Starting Power: 10 per player
• Max Power: Members × 10
• Regeneration: +0.1 per minute (per online member)
• Death Penalty: -2.0 power
• Combat Log Penalty: -5.0 power

Claim Limits

• Max Claims: Floor(Current Power)
• Example: 25.7 power = 25 max claims

Overclaim (Raiding)

When Claims > Power, your faction becomes raidable:

• ❌ Enemies can break blocks
• ❌ Enemies can place blocks (TNT, ladders, etc.)
• ❌ Enemies can open chests and doors
• ❌ Enemies can interact with all blocks
• ✅ Your land is vulnerable until power is restored

Power Recovery

To recover from being raidable:

1. Have members stay online (regeneration)
2. Avoid deaths (prevents further loss)
3. Consider unclaiming excess territory
4. Wait for power to exceed claim count

🌍 Zone Types

Regular Territory

• Claimed by factions
• Protected based on faction settings
• Can be raided if power is low
• Shows on world map with faction color

SafeZone

• Created by admins
• No PvP allowed
• Cannot be claimed by factions
• Perfect for spawn areas and shops
• Shows as blue on world map

WarZone

• Created by admins
• All PvP enabled
• Cannot be claimed by factions
• No protection for anyone
• Shows as red on world map

🔧 Technical Information

Requirements

• Hytale Server: Latest version (Alpha builds)
• Permissions: Op/Admin for zone management
• Dependencies: None - standalone mod

File Structure

mods/ElbaphFactions/
├── factions.json       # Faction data
├── claims.json         # Territory claims
├── config.json         # Configuration
└── playernames.json    # Player name cache

Performance

• Auto-saves every 30 seconds
• Efficient chunk-based claim system
• Minimal server overhead
• Optimized world map updates

Compatibility

• Works with other Hytale mods
• No conflicts with vanilla features
• Safe to add to existing servers
• Data persists across server restarts

🐛 Known Issues

Version 1.3.2

• None currently reported

Version 1.1.2

• Command parsing issues with /ef war and /ef invite (Fixed in 1.3.2)
• Faction settings UI crashes when clicking allies button (Fixed in 1.3.2)
• Emojis displaying as ?? in Hytale (Fixed in 1.3.2)
• Text input requires letter-by-letter typing (Fixed in 1.3.2)
• Checkboxes don't save properly (Fixed in 1.3.2)

📚 Resources

Documentation

• Wiki: elbaphfactionswiki.vercel.app
• Discord: discord.gg/nRdKHyDxZh