Skip to main content
PluginsFeaturesChangelogDocsDownloadCommunity

HyperFactions Wiki

Welcome to the official HyperFactions documentation. HyperFactions is a comprehensive faction management mod for Hytale servers featuring territory claims, alliances, strategic PvP, power systems, and extensive customization.

Info

Version: 0.4.3 | Game: Hytale Early Access | License: GPLv3

Important: Permission Setup Required

As of v0.3.0, HyperFactions requires explicit permission grants. The fallback behavior changed from "allow" to "deny". You must configure permissions using HyperPerms or another permission system before players can use factions.

See Permissions Reference for setup instructions.

Quick Links

Getting Started

New to HyperFactions? Start here:

Core Concepts

Understand how HyperFactions works:

Commands

Complete command reference:

Reference

Key Features

Faction Management

Create and manage factions with unique names, customizable colors, and a three-tier role hierarchy (Leader, Officer, Member). Features smart invitation system, activity logging, and configurable member limits.

Territory System

Chunk-based claiming with visual feedback, integrated world map display, power-based claim limits, and anti-fragmentation protection. Supports multi-world/dimension claiming.

Power System

Personal power per player that contributes to faction power. Automatic regeneration, death penalties, and power cost per claim create balanced strategic gameplay.

Diplomatic Relations

Form alliances for mutual protection and shared land access, declare enemies to enable full PvP and overclaiming, or maintain neutral relations with other factions.

Combat & Protection

Combat tagging prevents logout exploitation. Block placement, breaking, and container protection keeps your territory secure. Allied access is configurable.

Territory Permissions

Factions can configure 15 different flags to control what happens in their territory, including PvP, friendly fire, building, container access, and more.

GUI-Based Management

Full graphical interface for managing factions, viewing maps, configuring settings, and handling admin tasks.

Automatic Backups

Built-in backup system with GFS (Grandfather-Father-Son) rotation policy. Create manual backups or let the system handle it automatically.

Chat Integration

Custom faction and alliance chat channels with configurable formatting, tag display, and relation-based colors.

What's New in v0.4.x

v0.4.x Improvements

  • Zone system expanded to 15 configurable flags
  • Improved power regeneration (6 power/hour default)
  • Enhanced GUI with better territory visualization
  • Streamlined configuration with 47 options

Breaking Changes (from v0.2.x)

  • Permission system restructured - All permissions now use category-based nodes (e.g., hyperfactions.faction.create instead of hyperfactions.create)
  • Explicit permission grants required - The fallback changed from "allow" to "deny". The hyperfactions.use permission is now required.

See the Permissions Reference for migration instructions from v0.2.x.

Support

Need help? Join our community:

HyperFactions - Forge Your Empire