Elbaph Factions

Faction Properties

• Unique Identity: UUID-based identification with custom Names (max 32 chars) and Tags (max 8 chars).
• Visuals: Random RGB color assignment on creation (24-bit color support).
• Persistence: Automatic saving every 30 seconds and on critical operations.
• Management: Auto-cleanup on disband removes all claims, data, and map markers.

Invitation System

Invitations are thread-safe and expire automatically after 5 minutes.

• /ef invite <player>Send invitation (Officer+)
• /ef accept [faction]Accept pending invite
• /ef kick <player>Remove member (Officer+)
• /ef promote <player>Promote member to Officer (Leader only)
• /ef demote <player>Demote Officer to Member (Leader only)

Dual Permission System

Elbaph Factions now supports two ways to manage permissions:

Permission Nodes

LuckPerms permissions override faction roles. If a player has the permission node, they can perform the action regardless of their faction role.

Example Use Cases

/lp user BuilderName permission set factions.permission.claim true
/lp user BuilderName permission set factions.permission.unclaim true

/lp creategroup diplomat
/lp group diplomat permission set factions.permission.manageallies true
/lp group diplomat permission set factions.permission.manageenemies true
/lp user DiplomatName parent add diplomat

# Most members use faction roles
/ef promote Officer1
/ef promote Officer2

# But grant special permission to one player
/lp user SpecialPlayer permission set factions.permission.sethome true

Visual Territory Map

Command: /ef map

• 17x17 Chunk Grid UI
• Click-to-claim/unclaim functionality
• Color-coded by relationship (Ally/Enemy/Neutral)
• Real-time updates

Strict Protection Rules

* Unless the enemy faction is Overclaimed.

Combat Tag System

The CombatTagManager tracks active PvP states to prevent abuse.

• Duration: 15 Seconds (Configurable)
• Triggers: Any PvP damage (attacker and victim)
• Restrictions:
  • ❌ Cannot use /ef home
  • ❌ Cannot teleport
  • ❌ Logging out causes massive power loss (-5.0)

• /ef ally <faction> Grant access to claims and disable friendly fire.
• /ef enemy <faction> Declare war. Enemy markers appear red on map.
• /ef neutral <faction> Reset relationship to default.

Teleport Mechanics

Teleportation is designed to be fair and prevent escape during combat.

• Delay: 5 Seconds with countdown.
• Cooldown: 5 Minutes between uses.
• Cancellation: Teleport cancels if you move > 0.5 blocks or take damage.

Zone Types

• SafeZone: Protected areas (Spawn/Trading).
  ❌ No PvP | ❌ No Building | ❌ Cannot Claim
• WarZone: PvP Arenas.
  ✅ All PvP | ✅ All Building | ❌ No Protections

Managed via /ef admin safezone and /ef admin warzone GUIs.

Admin Bypass Mode

Command: /ef admin bypass

Toggles a mode that allows building anywhere and bypassing all protections. Persists across sessions.

Admin Panel

Command: /ef admin

Control panel to toggle global PvP, Map Visibility, Health Bars, and perform mass operations (Reset Power, Disband All).

Example: Claim Data Structure

{
  "default:16:-25": {
    "dimension": "default",
    "x": 16,
    "z": -25,
    "factionId": "uuid-string-here",
    "claimedAt": 1234567890,
    "claimedBy": "uuid-string-here"
  }
}