HyFactions

HyFactions

A Faction Mod for Hytale

2.5 тысяч загрузок
Обновлён 8 дней назад

Скриншоты

Описание


Hyfaction - полная система фракции для Hytale

Комплексный мод управления фракциями для серверов Hytale с территориальными претензиями, альянсами, стратегическим PvP, чрезмерным спросом и обширной настройкой. Идеально подходит для конкурирующих серверов, ищущих организованную групповую войну.

Версия 1.0.509 - Обновление капитального ремонта


Обзор

извержение Преобразует ваш Hytale сервер в динамической фракционной среде, где игроки создают фракции, претендуют на территории, создают альянсы и участвуют в стратегических PvP-боях. С интуитивно понятной системой графического интерфейса, интеграцией ECS, превосходной механикой и обширной настройкой Hyfaction предоставляет все необходимое для игрового процесса конкурентной фракции.

Главные команды: /fh ! гифазия ! /фракция ! f


Ключевые особенности

Advanced Faction Management

  • Создание и управление фракциями с уникальными именами и случайными цветами
  • Трехуровневая иерархия ролей (владелец, сотрудник, член) с различными разрешениями
  • Умная система приглашений с явным принятием
  • Всесторонние журналы деятельности Отслеживание последних 100 действий фракции
  • Индивидуальное хранение фракций Изолированные файлы JSON для каждой фракции
  • Полный раствор удаление всех претензий и файлов данных
  • Система ограничения членства - Настройка максимальных членов на фракцию (по умолчанию: 50)
  • Расформировать подтверждение - Новое всплывающее окно для предотвращения случайного удаления фракции

Интеллектуальная территориальная система

  • Утверждения, основанные на Чанке Защита территорий фракций
  • Визуальная карта интеграции отображение заявленных кусков в цветах фракции
  • Интегрированная мини-карта в GUI для контекстной осведомленности
  • 15х15 кусковая сетка Легкое управление территорией
  • Силовые ограничения Обеспечение сбалансированного расширения
  • Система смежных претензий Фракции, претендующие только на связанные территории
  • Противотрубная защита Предотвращает отсоединенные группы кусков при невостребовании
  • Система переоценки Захват вражеской территории, когда их сила достигнет 0!
  • Неактивный распад фракции Автоматическое удаление претензий от неактивных фракций
  • Автоматическая система распада для неактивных или маломощных фракций (настраиваемых)
  • Ограничения размеров Предотвращение претензий во временных или ограниченных районах

Динамическая энергетическая система

  • Личная власть для каждого игрока (конфигурируемая шапка 20)
  • Расчет мощности фракции как сумма мощности участника (заключается на одного игрока)
  • Автоматическая регенерация каждый настраиваемый интервал (+1 power/player)
  • Стратегическая потеря мощности Смерть (-1) или убийство нейтральных (-1)
  • Конфигурируемая стоимость электроэнергии - Набор мощности, требуемый по требованию (по умолчанию): 2)
  • Нет потери мощности в WarZones - Сражайтесь свободно без штрафов!
  • Пересчет в реальном времени Изменения в членах и события власти
  • Санкции за дефицит электроэнергии Запуск автоматического распада претензии

Система дипломатических отношений

  • Альянсы Взаимная защита, общий доступ к земле, отсутствие дружественного огня
  • Враги - Полный PvP, двунаправленная враждебность, Сверхмощный
  • Нейтралы PvP включили силовые санкции за агрессию
  • Система запросов Альянса с механикой утверждения/отказа
  • Автоматическая конверсия противника При отклонении требований альянса
  • Цветные дисплеи (зеленые союзники, красные враги, белые/серые нейтральные)

Home & Телепортация

  • Дом фракции установленный собственником на заявленной территории
  • Точная телепортация Сохранение положения и вращения (yaw/pitch)
  • Междисциплинарная поддержка Использование родной телепортации Hytale
  • Доступ только для членов с разрешения проверки
  • Конфигурируемое охлаждение Система задержки

️ Расширенная боевая система

  • Боевая пометка предотвращение эксплуатации выхода из системы (по умолчанию 15s)
  • Отношения на основе PvP Правила (союзники защищены, враги открыты)
  • Штрафы за власть для нападения на нейтральных
  • Боевые журналы Отслеживание всех смертей с помощью меток времени
  • Безопасные зоны для административных зон защиты (зеленый)
  • WarZones для PvP-боев без штрафов за потерю мощности (красный)
  • Обнаружение смерти через ECS DeathComonent и анализ чата

Исполнитель: Faction & Alliance Chat System - новый!

  • Режим Chat Toggle Переключение между каналами чата мгновенно
  • Фракционный чат ()/fc) - Режим чата фракции Toggle
  • Alliance Chat ()/fa aРежим чата Toggle Alliance
  • Генерал Чат ()/f g) - Переключитесь на общий чат
  • Визуальное подтверждение При переключении режимов чата
  • Отдельное форматирование с пользовательскими цветами и префиксами
  • Безопасные сообщения Только фракции/союзники могут участвовать
  • Никакого дублирования сообщений - Эффективная доставка сообщений
  • Контроль на основе разрешений Интеграция LuckPerms

Специальная зона – новая!

SafeZones (зеленый)

  • Полная защита Из всех PvP-боев
  • Без блокировки. Разрешенное размещение
  • назначенный администратором безопасные зоны для нерест, хабов или событий
  • Показано в зеленом На карте мира
  • Наивысший приоритет отображение карты

WarZones (Красные)

  • Выделенные зоны боевых действий PvP
  • PvP включен без потери мощности на смерть
  • Никаких штрафов Смерть в WarZones
  • Идеально подходит для событийАрены и организованные бои
  • Показано красным На карте мира
  • Автоматическое название «WarZone» Уведомление о въезде/выезде
  • Визуальная индикация В иске GUI: «PvP включен — нет потери мощности при смерти»
  • только администратор Создание и управление

️ Комплексная защита

  • Размещение/разрыв блока Защита в заявленных кусках
  • Защита от взаимодействия для контейнеров, дверей и механизмов
  • Размещение жидкости Защита (вода, лава и т.д.)
  • Подбор предметов Защита в заявленных районах
  • Союзнический доступ дружественные территории (конфигурируемые)
  • Креативный режим шунтирования Вариант для строительства (конфигурируемый)
  • Опровержение администратора Система для управления сервером
  • Многомировая поддержка Правильно работает с несколькими мирами и измерениями

Профессиональные инструменты администратора

  • Консолидированное меню admin со всеми вариантами управления
  • Неограниченные претензии Настройка сервера и события
  • Переключение режима обхода Для изменения любой территории
  • Улучшенный админ unclaim Может не требовать, даже если создает несвязанные группы
  • Управление безопасной зоной (добавить/убрать/перечислить)
  • Управление WarZone Новое специальное меню для создания зон боевых действий
  • Обсуждение Admin Bunk GUI Неограниченный доступ
  • Система контроля для специальных разрешений

Современный пользовательский интерфейс

  • Интерактивное главное меню Показывать статистику фракций, членов и действия
  • Управление куском ГУИ с интегрированной мини-картой и сеткой 15х15
  • Обновление Alliance UI Отражает изменения в реальном времени
  • Управление Альянсом визуальная обработка запросов
  • Браузер фракции Список всех фракций с членами click-to-view
  • Disband confirmation popup Предотвращение случайного удаления фракции
  • Многостраничная вики с полной внутриигровой документацией
  • Система помощи с категоризированной командной ссылкой
  • Цветные значки для ролей и отношений
  • Индикаторы WarZone GUI с четкими подсказками

Полная командная ссылка

Командование базовой фракции

Командование Разрешение Описание
/fh или /f список - Открытое интерактивное меню фракции (GUI)
/hf создать <n> hyfaction.create Создать новую фракцию с уникальным названием
/hf invite <player> hyfaction.invite Пригласить игрока во фракцию (владельца/офицера)
/f принять - Принять приглашение фракции
/f оставить - Оставьте существующую фракцию (не для владельца)
/hf kick <player> hyfaction.kick Удалить игрока из фракции
/hf расформирование hyfaction.disband Распустить фракцию полностью (только владелец)

Home & Телепортация

Командование Разрешение Описание
/hf sethome hyfaction.sethome Установить фракцию дома на текущей позиции (только владелец)
/f дома hyfaction.home Телепортируйте во фракцию домой с точной ротацией

Менеджмент

Командование Разрешение Описание
/hf promote <player> hyfaction.promote Поощрять сотрудника (только владельца)
/hf demote <player> hyfaction.demote Уничтожить сотрудника (только владельца)

Управление территориями

Командование Разрешение Описание
/hf кусок hyfaction.claim/hyfaction.unclaim Open Bunk Management GUI с мини-картой
/f переоценка hyfaction.claim Новый Захват фракции противника (требует ≤0 силы, отношения противника)

Примечание: прямой Претензия и /f unclaim Командование обесценивается. В настоящее время управление всей территорией использует /hf кусок Чувак.

Дипломатические отношения

Командование Разрешение Описание
/hf Ally <faction> hyfaction.ally Отправить запрос альянса (автопринять, если взаимно)
/hf enemy <faction> hyfaction.enemy Объявлять фракцию врагом (двунаправленным, позволяет завоевывать)
/hf нейтральный <faction> hyfaction.enemy Установление нейтральных отношений (односторонние)
/f фракция - Посмотреть все фракции с отношениями и статистикой

Информация и помощь

Командование Разрешение Описание
/hf журналы - Отображение последних 100 записей активности фракции
/f помощь - Открытое интерактивное меню помощи со всеми командами
/hf wiki - Доступ к многостраничной внутриигровой документации

Коммуникационные команды - НОВЫЕ!

Командование Разрешение Описание
/hf c <message> hyfaction.chat.faction Режим фракционного чата - Переход на канал фракции
/hf a <message> hyfaction.chat.ally Скачать Alliance Chat Mode Переключитесь на канал Альянса
/f g - Обсуждение General Chat Вернуться в Глобальный чат

Административные команды

Командование Разрешение Описание
/hf admin hyfaction.admin Открытое консолидированное меню администратора
/hf admin-chunk hyfaction.admin Open admin chunk GUI (неограниченный)
/hf admin-claim hyfaction.admin Претензионный текущий кусок (неограниченный)
hf admin-unclaim hyfaction.admin Невостребованный текущий кусок (любой владелец)
/hf администратора Safezone hyfaction.admin Добавьте текущий кусок в безопасную зону
/hf админ сейфзон удалить hyfaction.admin Удалить безопасную зону из текущего куска
/hf список безопасных зон администратора hyfaction.admin Список всех безопасных зон с координатами
/hf админ варзона добавить hyfaction.admin Новый Добавить текущую часть как WarZone
/hf Удаление варзоны администратора hyfaction.admin Новый Удалить WarZone из текущего куска
/hf Список варзон администратора hyfaction.admin Новый Перечислите все WarZone с координатами

Разрешения и интеграции

Интеграция разрешительной системы

Гифракционная поддержка Несколько систем разрешений Максимальная гибкость:

Лакпермс

Полная интеграция с Лакпермс для гранулированного контроля разрешения. Без LuckPerms все разрешения по умолчанию предоставляются (разрешительный режим).

Гиперпермь

Автоматическая интеграция с Гиперпермь - Расширенные разрешения для Hytale!

Особенности:

  • Автоматический префикс фракции в чате - Показывает название фракции перед приставкой группы игрока
  • Факультативное отображение ранга - Включите звание фракции (владелец, офицер, член) в чате
  • Заполнители чата Используйте данные фракции в любом месте в формате чата
  • ️️ Настраиваемые форматы Полный контроль над отображением информации фракции

держатели мест Доступно:

  • %-фактор % Фракция игрока (например, «Воины»)
  • %faction_rank % - ранг игрока внутри фракции (владелец/офицер/член)
  • %faction_tag% Короткий тег фракции (обычно 4 символа)

Чат Примеры:

[Воины] [Админ] Стив: Привет всем! # с фракцией
[Воины] [Админ] Стив: Здравствуйте! # фракция + ранг
Стив: Здравствуйте! # Нет фракции 

Конфигурация не требуется! HyperPerms автоматически обнаруживает износ. Просто установите оба мода, и они будут работать вместе мгновенно.

Узнайте больше: HyperPerms HyFactions Интеграция

Основные разрешения

Разрешение Функция Заметки
hyfaction.create Создавать фракции Требуемый для /f создать
hyfaction.invite Пригласить игроков Требуется должность офицера +
hyfaction.claim Заявить куски Используется в Chunk GUI и Overclaim
hyfaction.unclaim Невостребованные куски Используется в Chunk GUI
hyfaction.home Используйте дом фракции Телепортировать домой
hyfaction.sethome Дом фракции Владелец + разрешение
hyfaction.kick Члены Kick Владелец/Офицер + разрешение
hyfaction.promote Повысить до офицера Владелец + разрешение
hyfaction.demote Понизить до члена Владелец + разрешение
hyfaction.ally Управление альянсами Союзники/враги/нейтральные отношения
hyfaction.enemy Управлять отношениями Как и разрешение союзника
hyfaction.disband Распущенная фракция Владелец + разрешение
hyfaction.admin Административный доступ Все команды администратора + шунтирование
hyfaction.chat.faction Фракционный чат Использовать /fc фракционный чат
hyfaction.chat.ally Альянс чат Использовать /fa a Обсуждение Alliance Chat

Иерархия разрешений

  • Владелец: Автоматический обход всех разрешений фракции
  • Офицер: Ограниченные разрешения на основе роли + LuckPerms
  • Член: Базовые разрешения только через LuckPerms
  • Админ: Полный контроль над hyfaction.admin разрешение

️ Конфигурация

Конфигурационный файл: плагины/Hyfaction/config/Hyfaction.json (автогенерируется с дефолтами)

Варианты конфигурации

настройка Тип по умолчанию Описание
Обсуждение DefaultFactionClaimsAmount целое число 25 Начало претензий к новым фракциям (наследие)
Компания MaxFactionClaims целое число 100 Абсолютный максимум кусков на фракцию
MaxPlayerPower целое число 20 Коэффициент мощности на одного игрока (лимит вклада в игру)
PowerRegenerationЧасы целое число 1 1 Время между регенерацией энергии +1
CombatTagDurationВторые целое число 15 Продолжительность боевой метки (период штрафных санкций)
ClaimDecayВторой целое число 600 Задержка до авто-невостребования лишних кусков (10 минут)
Позволяет переоценивать булевый истинный Включить/отключить систему переоценки
PowerPerClaim целое число 2 2 Стоимость электроэнергии по претензиям (настраиваемая)
Участники MaxFaction целое число 50 Максимальный член фракции
Только соседи булевый ложный Сила смежных претензий только (связанные территории)
НеактивнаяFactionDecayDays целое число 7. За несколько дней до автоматического удаления претензий от неактивных фракций (0)
Нейтральный KillPowerLoss целое число 1 1 Потеря мощности при убийстве нейтральных игроков (настраиваемый штраф)
Безопасная зона Разрешить двери булевый ложный Разрешить взаимодействие дверей в SafeZones
SafeZone AllowChests булевый ложный Разрешить доступ к груди в SafeZones
Скачать WarZoneAllowDoors булевый ложный Разрешить взаимодействие дверей в WarZones
Обсуждение WarZoneAllowChests булевый ложный Разрешить доступ к груди в WarZones
ShowClaimsOnMap булевый истинный Отображение фракционных кусков на карте мира
ShowFactionNameInChat булевый истинный Префиксировать название фракции в сообщениях чата
HidePlayersNotInSameFactionOnMap булевый ложный Скрыть нефракционных игроков на карте
Скачать HidePlayerNameTags булевый ложный Скрыть теги имени игрока в игре
HidePlayerMarkersOnMap булевый ложный Спрятать маркеры игроков на карте мира
HomeTeleportDelaySeconds целое число 5 Задержка перед домашней телепортацией
HomeTeleportCooldownMinutes целое число 5 Охлаждение между домашними телепортами
Системные требования ForceyfactionChunkWorldMap булевый истинный Карта гидроизоляции для совместимых размеров
CreativeModeBypass Защита булевый ложный Разрешить творческим игрокам обойти защиту
Скачать DefaultFactionBlockPlaceEnabled булевый истинный Разрешить союзникам размещать блоки по умолчанию
Скачать DefaultFactionBlockBreakEnabled булевый ложный Позволить союзникам по умолчанию разбивать блоки
Скачать DefaultFactionBlockInteractEnabled булевый ложный Разрешить союзникам взаимодействовать с блоками по умолчанию

Полная конфигурация Пример

{
"DefaultFactionClaimsAmount": 25,
"DefaultFactionBlockPlaceEnabled": правда,
"DefaultFactionBlockBreakEnabled": ложный,
"DefaultFactionBlockInteractEnabled": ложный,
"ForceHyfactionChunkWorldMap": правда,
"CreativeModeBypassProtection": ложный,
"ShowClaimsOnMap": правда,
"CombatTagDurationSeconds": 15,
«Часы регенерации энергии»: 1,
"MaxPlayerPower": 20,
"ShowFactionNameInChat": правда,
"MaxFactionClaims": 100,
"ClaimDecaySeconds": 600,
"HidePlayersNotInSameFactionOnMap": ложный,
"HomeTeleportDelaySeconds": 5,
"HomeTeleportCooldownMinutes": 5,
"HidePlayerNameTags": ложные,
"HidePlayerMarkersOnMap": ложный,
«EnableOverclaiming»: правда
"PowerPerClaim": 2,
"MaxFactionMembers": 50,
"OnlyAdjacentClaims": правда,
"InactiveFactionDecayDays": 7,
«NeutralKillPowerLoss»: 1
"SafeZoneAllowDoors": ложный,
"SafeZoneAllowChests": ложный,
"WarZoneAllowDoors": ложный,
"WarZoneAllowChests": фальшивка
? 

Фракционная ролевая система

Владелец (владелец)

Уникальный лидер фракции с абсолютным контролем

Разрешения:

  • Распустить фракцию полностью
  • Поощрение членов в офицеры
  • Уничтожить офицера до члена
  • Нажмите любой член (Офицеры и члены)
  • Местонахождение фракции
  • Управлять всеми дипломатическими отношениями
  • Принять/отклонить запросы альянса
  • Пригласите новых игроков

Ограничения:

  • Не может покинуть фракцию (должна расформироваться)
  • Нельзя пинать или понижать
  • Только один собственник по фракции

Офицер

Доверенный член с управленческим авторитетом

Разрешения:

  • Пригласите новых игроков
  • Удары только по членам (не другим офицерам)
  • Управление дипломатическими отношениями (союзники/враги/нейтральные)
  • Принять/отклонить запросы альянса
  • Claim/unclaim chunks (с разрешения LuckPerms)
  • Используйте перевес на вражеской территории

Ограничения:

  • Не может никого раскрутить/подавить
  • Нельзя пинать других офицеров или владельца
  • Не может распустить фракцию
  • Не может быть фракции дома

️ Член

Участник стандартной фракции

Разрешения:

  • Claim chunks (с участием) hyfaction.claim)
  • Невостребованные куски (с) hyfaction.unclaim)
  • Преувеличивать вражеские куски (с) hyfaction.claim)
  • Телепортация в дом фракции
  • Посмотреть информацию о фракции
  • Журналы фракций доступа

Ограничения:

  • Не могу пригласить игроков
  • Нельзя пинать никого
  • Не может управлять отношениями
  • Не может продвигать / удалять
  • Не могу вернуться домой
  • Нет доступа к управлению

Передовые системы

Механика энергетических систем

Расчет:

  • Сила фракции = сумма всей власти члена (заключается в MaxPlayerPower на одного игрока
  • Пример: С MaxPlayerPower = 20Игрок, имеющий 25 сил, вносит только 20

Регенерация:

  • +1 мощность на каждого игрока PowerRegenerationЧасы
  • Отдельные таймеры (не одновременные)
  • Автоматический перерасчет по завершении

Потеря мощности:

  • -1 мощность на смерть (обнаружена по ключевым словам DeathComponent или чата)
  • 1 Сила для убийства нейтральных игроков
  • Нет потери мощности при смерти в WarZones
  • Отслежено в Боевой лог-менеджер

Триггеры перерасчета:

  • Член фракции / покидает фракцию
  • Регенерация электроэнергии завершена
  • Смерть или убийство событий
  • Автоматически каждые 5 минут

Формула предельного требования:

maxClaims = min (factionPower / PowerPerClaim, MaxFactionClaims) 

По умолчанию: 1 претензия требует 2 мощности (настраиваемая через PowerPerClaim)

Соседняя система претензий - новая!

Связанные территории для стратегического геймплея!

Как это работает:

  • Когда Оригинальное название: OnlyAdjacentClaims: TrueФракции могут претендовать только на куски рядом с существующими претензиями.
  • Первое требование Каждое измерение становится отправной точкой.
  • Противотрубная защита Предотвращает создание несвязанных групп при невостребованности
  • Обход администратора - Администраторы могут по-прежнему отменять любой кусок с помощью команд администратора

Преимущества:

  • Содействие стратегическому планированию территорий
  • Предотвращает рассеянные, разрозненные претензии
  • Создание более сплоченных фракционных территорий
  • Легче защищать прилежащую землю

Конфигурация:

  • Оригинальное название: OnlyAdjacentClaims: True - Включить требование о смежных требованиях
  • Оригинальное название: OnlyAdjacentClaims: false - Позволить претендовать в любом месте (по умолчанию)

Неактивный распад фракции - НОВЫЙ!

Автоматически очищайте претензии от неактивных фракций!

Как это работает:

  • Почасовая проверка Сканирование всех фракций на предмет активности
  • Если ни один из участников не был онлайн НеактивнаяFactionDecayDays Дни, претензии сняты
  • Сами фракции остаются (члены могут воссоединиться и вернуть)
  • Конфигурируемая продолжительность или полностью отключить

Конфигурация:

  • Неактивное действие DecayDays: 7 Автоматическое удаление претензий после 7 дней бездействия
  • Неактивное действие DecayDays: 0 - Отключить неактивную систему распада

Преимущества:

  • Держит карту чистой с заброшенных территорий
  • Бесплатная земля для активных игроков
  • Предотвращает вздутие сервера от неактивных фракций
  • Конфигурируемый, чтобы соответствовать уровню активности вашего сервера

Чрезмерная система

Захват вражеской территории посредством стратегической войны.

Требования:

  • ✅ Целевая фракция должна иметь ≤ 0 мощности
  • Целевая фракция должна быть объявлена враг использование /hf enemy <faction>)
  • ✅ Чанк уже должен быть востребован вражеской фракцией.
  • ✅ Ваша фракция должна иметь достаточно доступных претензий.

Как это работает:

  1. Объявить фракцию врагом: /hf enemy <targetFaction>
  2. Вступайте в бой, чтобы уменьшить их мощность до 0 или ниже.
  3. Стоять в куске, заявленном вражеской фракцией
  4. казнить /f переоценка Чтобы захватить его

Конфигурация:

  • Оригинальное название: Enable Overclaiming: True - Переоценка включена, нет автоматического распада
  • Оригинальное название: False - Применяется чрезмерная инвалидность, нормальная система распада

Сообщения об успехе:

  • «Успешно переоцененный кусок [Факт-Имя]!»

Сообщения об ошибке:

  • «Вы можете переоценить только куски фракций с силой ≤ 0»
  • «Вы можете только переоценить куски вражеских фракций».
  • «Этот кусок не востребован»

предрасположенность Chat System - новый!

Фракционный чат:

  • Формат: [ФАКЦИЯ] [ФАКЦИОННОЕ ИМЯ] Игрок: Сообщение
  • Пользовательские цвета на основе цвета RGB вашей фракции
  • Частное общение Только члены фракции получают сообщения
  • Идеально для: Быстрая координация во время рейдов и PvP сражений

Alliance Chat:

  • Формат: [ВСЁ] [ФАКЦИОННОЕ ИМЯ] Игрок: Сообщение
  • голубой цвет Отличие от фракционных сообщений
  • Координация с союзниками Сообщения, отправленные всем союзным группировкам
  • Требуется: По крайней мере одна союзная фракция
  • Идеально для: Масштабные атаки и стратегическое планирование

Примеры использования:

/fc Все онлайн для рейда в 8 вечера!
/hf Необходимость резервного копирования по координатам X:100 Z:200 

Ответные сообщения:

  • «Послание, отправленное фракции» — Успешно отправлено
  • «Послание, отправленное X союзной фракции(-ам)» — отправлено союзникам
  • «У вас нет союзнических фракций» — Нет альянсов
  • «Вы должны быть во фракции, чтобы использовать фракционный чат»
  • «У вас нет разрешения на использование этой команды» - Пропущенное разрешение

Система PvP

Правила ущерба:

  • Та же фракция: Ущерб отменен
  • Союзные фракции: Ущерб отменен, общий доступ к земле
  • Вражеские группировки: Полный PvP включен, боевая метка применена, избыточный доступный
  • Нейтральные игроки: PvP включен, боевая метка применена, -1 штраф за силу для убийцы
  • Безопасные зоны: Все повреждения отменены
  • WarZones: PvP включен, Нет потери мощности при смерти

Боевой тег:

  • Продолжительность: CombatTagDurationВторые (по умолчанию: 15s)
  • Выйти во время тега: 1 штраф за мощность
  • Отслеживание каждого игрока с истечением срока действия

Архитектура хранения данных

НОВЫЙ в v1.0.389: Все данные плагина были перемещены в новое место для лучшей организации.

Старое местоположение: Вселенная/Гифация/
Новое местоположение: плагины/Hyfaction/config

Руководство по миграции

️️ ВАЖНО: Если вы обновляете v1.0.388 или более раннее, выполните следующие действия:

Быстрые шаги миграции:

  1. Остановите сервер
  2. Резервное копирование твой Вселенная/Гифация/ папка
  3. Создавать каталоги:
    • плагины/Hyfaction/config
    • плагины/Hyfaction/config/faction
  4. Переместить основные файлы то плагины/Hyfaction/config:
    • Партии.
    • Claims.json
    • Имя:ache.json
    • AdminOverrides.json
    • SafeZones.json
    • WarZones.json
    • combatlogs.json
  5. Переместить файлы фракции: Все файлы UUID.json фракции ? конфигурация/фракция/
  6. Стартовый сервер Проверьте, все ли работает

️️ Всегда резервное копирование перед внесением изменений!

Структура файла (v1.0.389+)

плагины/Hyfaction/config
Hyfaction.json (конфигурация)
Обсуждение Party.json
Обсуждение Claims.json
недоброжелательность Имя:ache.json
недоброжелательность AdminOverrides.json
недоброжелательность SafeZones.json
Обсуждение WarZones.json
Обсуждение Battlelogs.json
─ ─ фракция/
{UUID1}.json
{UUID2}.json
─ ─ ─ 

Идеально для

Конкурентные PvP-серверы организованная фракционная война
Серверы выживания Требуется территориальный контроль
Серверы RPG Нужны клановые / гильдейские системы
Масштабные серверы Структурированные организации игроков
Серверы сообщества Содействие командному геймплею
Серверы Hardcore Стратегическое управление земельными ресурсами
Серверы событий с выделенными PvP-аренами (WarZones)
Многомировые серверы Полностью совместим с несколькими измерениями


Почему стоит выбрать Hyfaction?

Современная архитектура

  • Интеграция ECS для оптимальной производительности
  • Асинхронная обработка данных, предотвращающая задержку
  • Проектирование модульной системы для расширяемости
  • Многомировая безопасность потоков Правильная синхронизация по измерениям

Комплексные характеристики

  • Каждая функция, необходимая моду фракции
  • Внешние зависимости не требуются
  • Факультативные интеграции: Лакпермс и Гиперпермь
  • Профессиональные инструменты администратора включены
  • Система переоценки Стратегический территориальный контроль
  • WarZones для безнаказанных PvP-событий

Пользовательский дизайн

  • Интуитивный графический интерфейс для всех основных функций
  • Внутриигровая вики и система помощи
  • Визуальная обратная связь и уведомления
  • Четкие индикаторы зоны на карте и в игре

Активное развитие

  • Регулярные обновления и исправления ошибок
  • Улучшения на уровне общин
  • Версия 1.0.395+ проверенный и стабильный
  • Устранение сбоев для многомировых серверов

Поддержка и документация

Помощь в игре:

  • /hf wiki - Полная многостраничная документация
  • /f помощь - Ссылка на команду с описанием

Конфигурация:

  • Автоматическая конфигурация с разумными по умолчанию
  • Полностью документированные варианты
  • Примеры включают

Устранение неполадок:

  • Проверить плагины/Hyfaction/config каталог для файлов данных
  • Проверьте установку LuckPerms (необязательно)
  • Обзор журналов сервера для ошибок
  • Проблемы миграции? Убедитесь, что все файлы были правильно удалены из Вселенная/Гифация/

Быстрые ссылки

  • Команды: Использовать /f помощь внутриигровой
  • Вики: Доступ через /hf wiki внутриигровой
  • Конфиг: плагины/Hyfaction/config/Hyfaction.json
  • Данные: плагины/Hyfaction/config справочник
  • Разрешения: Обсуждение LuckPerms & Hyper Пермь совместима
  • Гиперпермская интеграция: Документация

Технические характеристики

Версия Hytale: Совместим с последними Сервер Hytale
Мод-версия: 1.0.509+
Зависимости: Нет (необязательно: LuckPerms, HyperPerms)
Системы разрешений: LuckPerms, HyperPerms (автообнаружение)
Языки: Поддержка нескольких языков (EN, FR, ES, DE)
Многомировой: ✅ Полная поддержка с аварийными исправлениями
ECS Системы: 11 зарегистрированных систем
Хранение: JSON с сохранением асинка
Расположение данных: плагины/Hyfaction/config
Выступление: Оптимизированные обновления карт с системой очередей для конкретных участков


Особенности игры At a Glance

Особенность статус Подробности
Создание фракции Уникальные имена, назначение автовладельца
Территориальные претензии Чанк с ограничениями мощности
чрезмерный Захват вражеской территории при 0 мощности
Система Альянса Запрос/принятие с взаимными требованиями
Управление PvP Контроль повреждений на основе отношений
Система питания Регенерация, потеря, механика распада
Защита Блоки, жидкости, взаимодействия, пикапы
Инструменты Admin Неограниченные претензии, обход, безопасные зоны
WarZones PvP без штрафов за потерю мощности
Безопасные зоны Полные защитные зоны
Фракционный чат Частная фракционная коммуникация (/fc)
Alliance Chat Координация с союзниками (/fa a)
Многомировой Безопасные операции по всем измерениям
Соседние претензии Связанные с силой территории (конфигурируемые)
Неактивный декай Автоматическое удаление претензий от неактивных фракций
Пределы членов Конфигурируемые максимальные члены одной фракции
Многоязычие Поддержка EN, FR, ES, DE
Чат Toggle Переключение между каналами чата мгновенно
Зона разрешений Настройка доступа к дверям/скам в зонах
ГУИ Интерфейс Современные меню с минимальной интеграцией
Карта мира Цветные фракционные территории + зоны
Борьба с лесозаготовками Отслеживание смерти и штрафы за власть
Лакпермс Полная интеграция (факультативно)
Гиперпермь Автоматическая интеграция чата с заполнителями
ECS интеграция 11 систем для оптимальной производительности

Changelog Основные моменты

v1.0.509 - Обновление капитального ремонта

  • Многоязыковая система - Переводы на основе JSON (EN, FR, ES, DE)
  • предрасположенность Режим Chat Toggle Переключение между фракцией/союзом/общим чатом /fc, /fa a, /f g
  • Улучшенная интеграция LuckPerms - Улучшенная поддержка префикса/суффикса с разрешением заполнителя
  • Оптимизированные обновления карт - Система очередей для улучшения производительности
  • ️ Зона разрешений Настройка доступа к двери / груди в SafeZones и WarZones
  • ️️ Конфигурируемая потеря мощности - Нейтральный KillPowerLoss Убийства нейтральных игроков
  • ️ Очистка Удаленные кнопки wiki и описания фракций для более чистого интерфейса
  • Thread Безопасность Фиксированные летучие флаги и условия гонки
  • Производительность Boost - Обновляются только модифицированные фрагменты вместо всей карты.
  • Лучшее форматирование чата Префикс / суффикс LuckPerms с преобразованием цветового кода

Новые параметры конфигурации:

{
«NeutralKillPowerLoss»: 1
"SafeZoneAllowDoors": ложный,
"SafeZoneAllowChests": ложный,
"WarZoneAllowDoors": ложный,
"WarZoneAllowChests": фальшивка
? 

Языковые файлы: Автогенерируется в конфигурация/ленг/ (en-US.json, fr-FR.json, es-ES.json, de-DE.json)

v1.0.430 - Обновление смежной претензии и конфигурации

  • Система смежных претензий Фракции, претендующие только на связанные территории
  • Противотрубная защита Предотвращает отсоединенные группы кусков при невостребовании
  • Неактивный распад фракции Автоматическое удаление претензий после X дней бездействия (конфигурируемый)
  • PowerPerClaim - Настраиваемая стоимость электроэнергии по претензии (по умолчанию): 2)
  • Участники MaxFaction - Максимальный лимит членов на фракцию (по умолчанию: 50)
  • Обновление Alliance UI Обновления интерфейса Alliance в режиме реального времени
  • Disband confirmation popup Предотвращение случайного удаления фракции
  • Решения по безопасности нитей Фиксированные летучие флаги и условия гонки
  • Расширенные полномочия администратора Администраторы могут не требовать, даже если создают разобщенные группы.
  • ️ Улучшения системы Decay - Теперь соблюдаю правила соседства

Пример конфигурации:

{
"PowerPerClaim": 2,
"MaxFactionMembers": 50,
"OnlyAdjacentClaims": ложный,
«InactiveFactionDecayDays»: 7
? 

v1.0.395 - Обновление Crash Fix

  • Критическая фиксация Решенные сбои серверов на многомировых серверах
  • Восстановлена стабильность Плагин теперь работает правильно с несколькими мирами
  • Безопасность нитей Все доступы игроков выполняются в правильной мировой нити
  • Больше никаких аварий Проблемы синхронизации в системах карт, чатов и уведомлений
  • Hotfix выпустили Немедленное обновление рекомендуется для многомировых серверов

v1.0.389 Обновление миграции данных

  • ATA Новое местоположение данных - Переехала из Вселенная/Гифация/ то плагины/Hyfaction/config
  • Parties.json Новый файл данных партийной системы
  • Лучшая организация Все файлы данных в одном месте с конфигурацией
  • Многомировая поддержка Проблемы с фиксированными потоками для серверов с несколькими мирами
  • ✅ Безопасность нитей - Доступ ко всем игрокам теперь выполняется в правильной мировой нити
  • ️ Улучшение стабильности Улучшенная синхронизация для карт, чатов и систем уведомлений
  • ️️ Улучшение кода - Фиксированные предупреждения об амортизации Java
  • Руководство по миграции Для бесшовного обновления
  • ️️ Требования к МАНУАЛЬНОЙ МИГРАЦИИ См. миграционное руководство выше

v1.0.370 - Обновление сообщений

  • Фракционный чат Частное общение с /fc
  • Обсуждение Alliance Chat Координировать действия с союзниками через /fa a
  • Разрешения Chat Контрольный доступ с LuckPerms
  • Пользовательское цветовое форматирование на основе цветов фракции
  • Эффективная доставка сообщений без дублирования
  • Устранение ошибок и повышение производительности

v1.0.365 - Обновление WarZone

  • Система WarZones Выделенные зоны PvP без потери мощности
  • чрезмерный Захват вражеской территории при 0 мощности
  • Безопасные зоны Полная защита нерестовых зон
  • Расширенный дисплей карты с приоритетными зонами
  • Улучшенная боевая вырубка и отслеживание
  • Поддержка интеграции HyperPerms
  • Оптимизация производительности и исправление ошибок

Преобразуйте свой Hytale сервер в эпической фракции поле битвы! ️️

Гифракция - где стратегия отвечает выживанию

Показать оригинальное описание (English)


⚔️ Hyfaction - Complete Faction System for Hytale

A comprehensive faction management mod for Hytale servers featuring territory claims, alliances, strategic PvP, overclaiming, and extensive customization. Perfect for competitive servers seeking organized faction warfare.

Version: 1.0.509 - Major Overhaul Update 🚀


🌟 Overview

Hyfaction transforms your Hytale server into a dynamic faction-based environment where players create factions, claim territories, forge alliances, and engage in strategic PvP combat. With an intuitive GUI system, ECS integration, overclaiming mechanics, and extensive customization, Hyfaction provides everything needed for competitive faction gameplay.

Main Commands: /hf | /hyfaction | /faction | /f


✨ Key Features

🏰 Advanced Faction Management

  • Create & manage factions with unique names and random colors
  • Three-tier role hierarchy (Owner, Officer, Member) with distinct permissions
  • Smart invitation system with explicit acceptance
  • Comprehensive activity logs tracking the last 100 faction actions
  • Individual faction storage with isolated JSON files per faction
  • Complete dissolution removing all claims and data files
  • 🆕 Member limit system - Configure maximum members per faction (default: 50)
  • 🆕 Disband confirmation - New popup to prevent accidental faction deletion

🗺️ Intelligent Territory System

  • Chunk-based claiming protecting faction territories
  • Visual map integration displaying claimed chunks in faction colors
  • Integrated minimap in GUI for contextual awareness
  • 15x15 chunk grid for easy territory management
  • Power-based limits ensuring balanced expansion
  • 🆕 Adjacent claims system - Force factions to claim only connected territories
  • 🆕 Anti-hole protection - Prevents disconnected chunk groups when unclaiming
  • 🆕 Overclaiming system - Capture enemy territory when their power reaches 0!
  • 🆕 Inactive faction decay - Auto-remove claims from inactive factions
  • Automatic decay system for inactive or low-power factions (configurable)
  • Dimension restrictions preventing claims in temporary or restricted areas

⚡ Dynamic Power System

  • Personal power for each player (configurable cap at 20)
  • Faction power calculation as sum of member power (capped per player)
  • Automatic regeneration every configurable interval (+1 power/player)
  • Strategic power loss on death (-1) or killing neutrals (-1)
  • 🆕 Configurable power cost - Set power required per claim (default: 2)
  • 🆕 No power loss in WarZones - Fight freely without penalties!
  • Real-time recalculation on member changes and power events
  • Power deficit penalties triggering automatic claim decay

🤝 Diplomatic Relations System

  • Alliances - Mutual protection, shared land access, no friendly fire
  • Enemies - Full PvP, bidirectional hostility, overclaiming enabled 🔥
  • Neutrals - PvP enabled with power penalties for aggression
  • Alliance request system with approval/rejection mechanics
  • Automatic enemy conversion when rejecting alliance requests
  • Color-coded displays (green allies, red enemies, white/gray neutrals)

🏠 Home & Teleportation

  • Faction home set by owner in claimed territory
  • Exact teleportation preserving position AND rotation (yaw/pitch)
  • Cross-dimension support using Hytale's native teleportation
  • Member-only access with permission checks
  • Configurable cooldown and delay system

⚔️ Advanced Combat System

  • Combat tagging preventing logout exploitation (15s default)
  • Relationship-based PvP rules (allies protected, enemies open)
  • Power penalties for attacking neutrals
  • Combat logs tracking all deaths with timestamps
  • 🆕 Safe zones for admin-designated protection areas (Green)
  • 🆕 WarZones for PvP combat without power loss penalties (Red)
  • Death detection via ECS DeathComponent and chat analysis

💬 Faction & Alliance Chat System - NEW!

  • 🆕 Chat Toggle Mode - Switch between chat channels instantly
  • Faction Chat (/hf c) - Toggle faction chat mode
  • Alliance Chat (/hf a) - Toggle alliance chat mode
  • General Chat (/hf g) - Toggle back to general chat
  • Visual confirmation when switching chat modes
  • Distinct formatting with custom colors and prefixes
  • Secure messaging - Only faction/allied members can participate
  • No message duplication - Efficient message delivery
  • Permission-based control via LuckPerms integration

🎯 Special Zone System - NEW!

🟢 SafeZones (Green)

  • Complete protection from all PvP combat
  • No block breaking or placement allowed
  • Admin-designated safe areas for spawns, hubs, or events
  • Displayed in green on the world map
  • Highest priority in map display

🔴 WarZones (Red)

  • 🆕 Dedicated PvP combat zones
  • PvP enabled without power loss on death
  • No penalties for dying in WarZones
  • Ideal for events, arenas, and organized combat
  • Displayed in red on the world map
  • Automatic "WarZone" title notification on entry/exit
  • Visual indication in claim GUI: "PvP enabled - No power loss on death"
  • Admin-only creation and management

🛡️ Comprehensive Protection

  • Block placement/breaking protection in claimed chunks
  • Interaction protection for containers, doors, and mechanisms
  • Fluid placement protection (water, lava, etc.)
  • Item pickup protection in claimed areas
  • Allied access to friendly territories (configurable)
  • Creative mode bypass option for building (configurable)
  • Admin override system for server management
  • 🆕 Multi-world support - Works correctly with multiple worlds and dimensions

👑 Professional Admin Tools

  • Consolidated admin menu with all management options
  • Unlimited claiming for server setup and events
  • Bypass mode toggle for modifying any territory
  • 🆕 Enhanced admin unclaim - Can unclaim even if creates disconnected groups
  • 🆕 Safe zone management (add/remove/list)
  • 🆕 WarZone management - New dedicated menu for creating combat zones
  • Admin chunk GUI with unrestricted access
  • Override system for special permissions

🎨 Modern User Interface

  • Interactive main menu showing faction stats, members, and actions
  • Chunk management GUI with integrated minimap and 15x15 grid
  • 🆕 Auto-updating alliance UI - Reflects changes in real-time
  • Alliance management with visual request handling
  • Faction browser listing all factions with click-to-view members
  • 🆕 Disband confirmation popup - Prevents accidental faction deletion
  • Multi-page wiki with comprehensive in-game documentation
  • Help system with categorized command reference
  • Color-coded badges for roles and relationships
  • 🆕 WarZone indicators in claim GUI with clear tooltips

📋 Complete Command Reference

Basic Faction Commands

Command Permission Description
/hf or /hf list - Open interactive faction menu (GUI)
/hf create <n> hyfaction.create Create a new faction with unique name
/hf invite <player> hyfaction.invite Invite player to faction (Owner/Officer)
/hf accept - Accept pending faction invitation
/hf leave - Leave current faction (not for Owner)
/hf kick <player> hyfaction.kick Remove player from faction
/hf disband hyfaction.disband Dissolve faction completely (Owner only)

Home & Teleportation

Command Permission Description
/hf sethome hyfaction.sethome Set faction home at current position (Owner only)
/hf home hyfaction.home Teleport to faction home with exact rotation

Member Management

Command Permission Description
/hf promote <player> hyfaction.promote Promote member to Officer (Owner only)
/hf demote <player> hyfaction.demote Demote Officer to Member (Owner only)

Territory Management

Command Permission Description
/hf chunk hyfaction.claim/hyfaction.unclaim Open chunk management GUI with minimap
/hf overclaim hyfaction.claim 🆕 NEW - Capture enemy faction chunk (requires ≤0 power, enemy relation)

Note: Direct /hf claim and /hf unclaim commands are deprecated. All territory management now uses the /hf chunk GUI.

Diplomatic Relations

Command Permission Description
/hf ally <faction> hyfaction.ally Send alliance request (auto-accept if mutual)
/hf enemy <faction> hyfaction.enemy Declare faction as enemy (bidirectional, enables overclaiming)
/hf neutral <faction> hyfaction.enemy Set neutral relationship (unilateral)
/hf faction - View all factions with relations and stats

Information & Help

Command Permission Description
/hf logs - Display last 100 faction activity entries
/hf help - Open interactive help menu with all commands
/hf wiki - Access multi-page in-game documentation

Communication Commands - 🆕 NEW!

Command Permission Description
/hf c <message> hyfaction.chat.faction 🆕 Toggle faction chat mode - Switch to faction channel
/hf a <message> hyfaction.chat.ally 🆕 Toggle alliance chat mode - Switch to alliance channel
/hf g - 🆕 Toggle general chat - Return to global chat

Administrative Commands

Command Permission Description
/hf admin hyfaction.admin Open consolidated admin menu
/hf admin-chunk hyfaction.admin Open admin chunk GUI (unlimited)
/hf admin-claim hyfaction.admin Claim current chunk (unrestricted)
/hf admin-unclaim hyfaction.admin Unclaim current chunk (any owner)
/hf admin safezone add hyfaction.admin Add current chunk as safe zone
/hf admin safezone remove hyfaction.admin Remove safe zone from current chunk
/hf admin safezone list hyfaction.admin List all safe zones with coordinates
/hf admin warzone add hyfaction.admin 🆕 NEW - Add current chunk as WarZone
/hf admin warzone remove hyfaction.admin 🆕 NEW - Remove WarZone from current chunk
/hf admin warzone list hyfaction.admin 🆕 NEW - List all WarZones with coordinates

🔑 Permissions & Integrations

Permission System Integration

Hyfaction supports multiple permission systems for maximum flexibility:

LuckPerms

Full integration with LuckPerms for granular permission control. Without LuckPerms, all permissions default to granted (permissive mode).

HyperPerms ⭐

Automatic integration with HyperPerms - Advanced permissions for Hytale!

Features:

  • 🎨 Automatic faction prefix in chat - Shows faction name before player's group prefix
  • 👑 Optional rank display - Include faction rank (Owner, Officer, Member) in chat
  • 🔧 Chat placeholders - Use faction data anywhere in chat format
  • ⚙️ Customizable formats - Full control over faction info display

Placeholders Available:

  • %faction% - Player's faction name (e.g., "Warriors")
  • %faction_rank% - Player's rank within faction (Owner/Officer/Member)
  • %faction_tag% - Short faction tag (typically 4 characters)

Chat Examples:

[Warriors][Admin] Steve: Hello everyone!           # With faction
[Warriors|Owner][Admin] Steve: Hello!              # With faction + rank
[Admin] Steve: Hello!                              # No faction

No configuration required! HyperPerms automatically detects Hyfaction. Just install both mods and they work together instantly.

Learn more: HyperPerms HyFactions Integration

Core Permissions

Permission Function Notes
hyfaction.create Create factions Required for /hf create
hyfaction.invite Invite players Also requires Officer+ role
hyfaction.claim Claim chunks Used in chunk GUI and overclaim
hyfaction.unclaim Unclaim chunks Used in chunk GUI
hyfaction.home Use faction home Teleport to home
hyfaction.sethome Set faction home Owner only + permission
hyfaction.kick Kick members Owner/Officer + permission
hyfaction.promote Promote to Officer Owner only + permission
hyfaction.demote Demote to Member Owner only + permission
hyfaction.ally Manage alliances Ally/enemy/neutral relations
hyfaction.enemy Manage relations Same as ally permission
hyfaction.disband Dissolve faction Owner only + permission
hyfaction.admin Admin access All admin commands + bypass
hyfaction.chat.faction Faction chat 🆕 Use /hf c for faction chat
hyfaction.chat.ally Alliance chat 🆕 Use /hf a for alliance chat

Permission Hierarchy

  • Owner: Automatic bypass for all faction permissions
  • Officer: Limited permissions based on role + LuckPerms
  • Member: Basic permissions via LuckPerms only
  • Admin: Full override with hyfaction.admin permission

⚙️ Configuration

Configuration file: plugins/Hyfaction/config/Hyfaction.json (auto-generated with defaults)

Configuration Options

Setting Type Default Description
DefaultFactionClaimsAmount Integer 25 Starting claims for new factions (legacy)
MaxFactionClaims Integer 100 Absolute maximum chunks per faction
MaxPlayerPower Integer 20 Power cap per player (faction contribution limit)
PowerRegenerationHours Integer 1 Hours between +1 power regeneration
CombatTagDurationSeconds Integer 15 Combat tag duration (logout penalty period)
ClaimDecaySeconds Integer 600 Delay before auto-unclaiming excess chunks (10 min)
EnableOverclaiming Boolean true 🆕 Enable/disable overclaiming system
PowerPerClaim Integer 2 🆕 Power cost per claim (customizable)
MaxFactionMembers Integer 50 🆕 Maximum members per faction
OnlyAdjacentClaims Boolean false 🆕 Force adjacent claims only (connected territories)
InactiveFactionDecayDays Integer 7 🆕 Days before auto-removing claims from inactive factions (0 to disable)
NeutralKillPowerLoss Integer 1 🆕 Power loss when killing neutral players (configurable penalty)
SafeZoneAllowDoors Boolean false 🆕 Allow door interactions in SafeZones
SafeZoneAllowChests Boolean false 🆕 Allow chest access in SafeZones
WarZoneAllowDoors Boolean false 🆕 Allow door interactions in WarZones
WarZoneAllowChests Boolean false 🆕 Allow chest access in WarZones
ShowClaimsOnMap Boolean true Display faction chunks on world map
ShowFactionNameInChat Boolean true Prefix faction name in chat messages
HidePlayersNotInSameFactionOnMap Boolean false Hide non-faction players on map
HidePlayerNameTags Boolean false Hide player name tags in-game
HidePlayerMarkersOnMap Boolean false Hide player markers on world map
HomeTeleportDelaySeconds Integer 5 Delay before home teleportation
HomeTeleportCooldownMinutes Integer 5 Cooldown between home teleports
ForceHyfactionChunkWorldMap Boolean true Force Hyfaction map for compatible dimensions
CreativeModeBypassProtection Boolean false Allow creative players to bypass protection
DefaultFactionBlockPlaceEnabled Boolean true Allow allies to place blocks by default
DefaultFactionBlockBreakEnabled Boolean false Allow allies to break blocks by default
DefaultFactionBlockInteractEnabled Boolean false Allow allies to interact with blocks by default

Complete Configuration Example

{
  "DefaultFactionClaimsAmount": 25,
  "DefaultFactionBlockPlaceEnabled": true,
  "DefaultFactionBlockBreakEnabled": false,
  "DefaultFactionBlockInteractEnabled": false,
  "ForceHyfactionChunkWorldMap": true,
  "CreativeModeBypassProtection": false,
  "ShowClaimsOnMap": true,
  "CombatTagDurationSeconds": 15,
  "PowerRegenerationHours": 1,
  "MaxPlayerPower": 20,
  "ShowFactionNameInChat": true,
  "MaxFactionClaims": 100,
  "ClaimDecaySeconds": 600,
  "HidePlayersNotInSameFactionOnMap": false,
  "HomeTeleportDelaySeconds": 5,
  "HomeTeleportCooldownMinutes": 5,
  "HidePlayerNameTags": false,
  "HidePlayerMarkersOnMap": false,
  "EnableOverclaiming": true,
  "PowerPerClaim": 2,
  "MaxFactionMembers": 50,
  "OnlyAdjacentClaims": true,
  "InactiveFactionDecayDays": 7,
  "NeutralKillPowerLoss": 1,
  "SafeZoneAllowDoors": false,
  "SafeZoneAllowChests": false,
  "WarZoneAllowDoors": false,
  "WarZoneAllowChests": false
}

👥 Faction Role System

👑 Owner (Proprietor)

Unique faction leader with absolute control

Permissions:

  • Dissolve faction completely
  • Promote members to Officer
  • Demote Officers to Member
  • Kick any member (Officers and Members)
  • Set faction home location
  • Manage all diplomatic relations
  • Accept/reject alliance requests
  • Invite new players

Restrictions:

  • Cannot leave faction (must disband)
  • Cannot be kicked or demoted
  • Only one Owner per faction

⭐ Officer

Trusted member with management authority

Permissions:

  • Invite new players
  • Kick Members only (not other Officers)
  • Manage diplomatic relations (ally/enemy/neutral)
  • Accept/reject alliance requests
  • Claim/unclaim chunks (with LuckPerms permission)
  • Use overclaim on enemy territory

Restrictions:

  • Cannot promote/demote anyone
  • Cannot kick other Officers or Owner
  • Cannot dissolve faction
  • Cannot set faction home

🎖️ Member

Standard faction participant

Permissions:

  • Claim chunks (with hyfaction.claim)
  • Unclaim chunks (with hyfaction.unclaim)
  • Overclaim enemy chunks (with hyfaction.claim)
  • Teleport to faction home
  • View faction information
  • Access faction logs

Restrictions:

  • Cannot invite players
  • Cannot kick anyone
  • Cannot manage relations
  • Cannot promote/demote
  • Cannot set home
  • No management access

🎮 Advanced Systems

Power System Mechanics

Calculation:

  • Faction power = Sum of all member power (capped at MaxPlayerPower per player)
  • Example: With MaxPlayerPower = 20, a player with 25 power contributes only 20

Regeneration:

  • +1 power per player every PowerRegenerationHours
  • Individual timers (not simultaneous)
  • Automatic recalculation on completion

Power Loss:

  • -1 power on death (detected via DeathComponent or chat keywords)
  • -1 power for killing neutral players
  • 🆕 No power loss when dying in WarZones
  • Tracked in CombatLogManager

Recalculation Triggers:

  • Member joins/leaves faction
  • Power regeneration completes
  • Death or kill events
  • Automatic every 5 minutes

Claim Limit Formula:

maxClaims = min(factionPower / PowerPerClaim, MaxFactionClaims)

Default: 1 claim requires 2 power (configurable via PowerPerClaim)

🆕 Adjacent Claims System - NEW!

Force connected territories for strategic gameplay!

How it works:

  • When OnlyAdjacentClaims: true, factions can only claim chunks next to existing claims
  • First claim in each dimension becomes the starting point
  • Anti-hole protection prevents creating disconnected groups when unclaiming
  • Admin bypass - Admins can still unclaim any chunk via admin commands

Benefits:

  • Encourages strategic territory planning
  • Prevents scattered, disconnected claims
  • Creates more cohesive faction territories
  • Easier to defend contiguous land

Configuration:

  • OnlyAdjacentClaims: true - Enable adjacent claims requirement
  • OnlyAdjacentClaims: false - Allow claiming anywhere (default)

🆕 Inactive Faction Decay - NEW!

Automatically clean up claims from inactive factions!

How it works:

  • Hourly check scans all factions for activity
  • If no members have been online for InactiveFactionDecayDays days, claims are removed
  • Factions themselves remain (members can rejoin and reclaim)
  • Configurable duration or disable entirely

Configuration:

  • InactiveFactionDecayDays: 7 - Auto-remove claims after 7 days of inactivity
  • InactiveFactionDecayDays: 0 - Disable inactive decay system

Benefits:

  • Keeps map clean from abandoned territories
  • Frees up land for active players
  • Prevents server bloat from inactive factions
  • Configurable to match your server's activity level

🔥 Overclaiming System

Capture enemy territory through strategic warfare!

Requirements:

  • ✅ Target faction must have ≤ 0 power
  • ✅ Target faction must be declared as enemy (use /hf enemy <faction>)
  • ✅ Chunk must already be claimed by the enemy faction
  • ✅ Your faction must have enough available claims

How it works:

  1. Declare a faction as enemy: /hf enemy <targetFaction>
  2. Engage in combat to reduce their power to 0 or below
  3. Stand in a chunk claimed by the enemy faction
  4. Execute /hf overclaim to capture it

Configuration:

  • EnableOverclaiming: true - Overclaiming enabled, no automatic decay
  • EnableOverclaiming: false - Overclaiming disabled, normal decay system applies

Success Messages:

  • ✅ "Successfully overclaimed chunk from [FactionName]!"

Error Messages:

  • ❌ "You can only overclaim chunks from factions with ≤ 0 power"
  • ❌ "You can only overclaim chunks from enemy factions"
  • ❌ "This chunk is not claimed"

💬 Chat System - NEW!

Faction Chat:

  • Format: [FACTION] [FactionName] Player: Message
  • Custom colors based on your faction's RGB color
  • Private communication - Only faction members receive messages
  • Perfect for: Quick coordination during raids and PvP battles

Alliance Chat:

  • Format: [ALLY] [FactionName] Player: Message
  • Cyan color to distinguish from faction messages
  • Coordinate with allies - Messages sent to all allied factions
  • Requires: At least one allied faction
  • Perfect for: Large-scale attacks and strategic planning

Usage Examples:

/hf c Everyone online for the raid at 8pm!
/hf a Need backup at coordinates X:100 Z:200

Response Messages:

  • ✅ "Message sent to faction" - Successfully sent
  • ✅ "Message sent to X allied faction(s)" - Sent to allies
  • ❌ "You don't have any allied factions" - No alliances
  • ❌ "You must be in a faction to use faction chat" - Not in faction
  • ❌ "You don't have permission to use this command" - Missing permission

PvP System

Damage Rules:

  • Same faction: Damage canceled
  • Allied factions: Damage canceled, shared land access
  • Enemy factions: Full PvP enabled, combat tag applied, overclaiming available
  • Neutral players: PvP enabled, combat tag applied, -1 power penalty for killer
  • Safe zones: All damage canceled
  • WarZones: PvP enabled, no power loss on death

Combat Tag:

  • Duration: CombatTagDurationSeconds (default: 15s)
  • Logout during tag: -1 power penalty
  • Tracked per player with expiration

📁 Data Storage Architecture

🆕 NEW in v1.0.389: All plugin data has been moved to a new location for better organization!

Old Location: universe/Hyfaction/
New Location: plugins/Hyfaction/config/

Migration Guide

⚠️ IMPORTANT: If you're updating from v1.0.388 or earlier, follow these steps:

Quick Migration Steps:

  1. 🛑 Stop your server
  2. 💾 Backup your universe/Hyfaction/ folder
  3. 📁 Create directories:
    • plugins/Hyfaction/config/
    • plugins/Hyfaction/config/faction/
  4. 📦 Move main files to plugins/Hyfaction/config/:
    • Parties.json
    • Claims.json
    • NameCache.json
    • AdminOverrides.json
    • SafeZones.json
    • WarZones.json
    • combatlogs.json
  5. 📦 Move faction files: All UUID.json files from factions/config/faction/
  6. ✅ Start server and verify everything works

⚠️ Always backup before making changes!

File Structure (v1.0.389+)

plugins/Hyfaction/config/
├── Hyfaction.json (configuration)
├── Parties.json
├── Claims.json
├── NameCache.json
├── AdminOverrides.json
├── SafeZones.json
├── WarZones.json
├── combatlogs.json
└── faction/
    ├── {UUID1}.json
    ├── {UUID2}.json
    └── ...

🎯 Perfect For

Competitive PvP servers with organized faction warfare
Survival servers requiring territorial control
RPG servers needing clan/guild systems
Large-scale servers with structured player organizations
Community servers fostering team-based gameplay
Hardcore servers with strategic land management
🆕 Event servers with dedicated PvP arenas (WarZones)
🆕 Multi-world servers - Fully compatible with multiple dimensions


💡 Why Choose Hyfaction?

Modern Architecture

  • Native ECS integration for optimal performance
  • Asynchronous data handling preventing lag
  • Modular system design for extensibility
  • 🆕 Multi-world thread safety - Proper synchronization across dimensions

Comprehensive Features

  • Every feature a faction mod needs
  • No external dependencies required
  • Optional integrations: LuckPerms & HyperPerms
  • Professional admin tools included
  • 🆕 Overclaiming system for strategic territory control
  • 🆕 WarZones for penalty-free PvP events

User-Friendly Design

  • Intuitive GUI for all major functions
  • In-game wiki and help system
  • Visual feedback and notifications
  • Clear zone indicators on map and in-game

Active Development

  • Regular updates and bug fixes
  • Community-driven improvements
  • Version 1.0.395+ tested and stable
  • Crash fixes for multi-world servers

🆘 Support & Documentation

In-Game Help:

  • /hf wiki - Complete multi-page documentation
  • /hf help - Command reference with descriptions

Configuration:

  • Auto-generated config with sensible defaults
  • Fully documented options
  • Examples included

Troubleshooting:

  • Check plugins/Hyfaction/config/ directory for data files
  • Verify LuckPerms installation (optional)
  • Review server logs for errors
  • Migration issues? Ensure all files were moved correctly from universe/Hyfaction/

🔗 Quick Links

  • Commands: Use /hf help in-game
  • Wiki: Access via /hf wiki in-game
  • Config: plugins/Hyfaction/config/Hyfaction.json
  • Data: plugins/Hyfaction/config/ directory
  • Permissions: LuckPerms & HyperPerms compatible
  • HyperPerms Integration: Documentation

📝 Technical Specifications

Hytale Version: Compatible with latest Hytale server
Mod Version: 1.0.509+
Dependencies: None (optional: LuckPerms, HyperPerms)
Permission Systems: LuckPerms, HyperPerms (auto-detection)
Languages: 🌍 Multi-language support (EN, FR, ES, DE)
Multi-World: ✅ Full support with crash fixes
ECS Systems: 11 registered systems
Storage: JSON-based with async saving
Data Location: plugins/Hyfaction/config/
Performance: Optimized map updates with chunk-specific queue system


🌐 Features at a Glance

Feature Status Details
Faction Creation Unique names, auto-owner assignment
Territory Claims Chunk-based with power limits
Overclaiming 🆕 Capture enemy territory at 0 power
Alliance System Request/accept with mutual requirements
PvP Management Relationship-based damage control
Power System Regeneration, loss, decay mechanics
Protection Blocks, fluids, interactions, pickups
Admin Tools Unlimited claims, bypass, safe zones
WarZones 🆕 PvP without power loss penalties
SafeZones Complete protection zones
Faction Chat 🆕 Private faction communication (/hf c)
Alliance Chat 🆕 Coordinate with allies (/hf a)
Multi-World 🆕 Thread-safe operations across dimensions
Adjacent Claims 🆕 Force connected territories (configurable)
Inactive Decay 🆕 Auto-remove claims from inactive factions
Member Limits 🆕 Configurable max members per faction
Multi-Language 🆕 Support for EN, FR, ES, DE
Chat Toggle 🆕 Switch between chat channels instantly
Zone Permissions 🆕 Configure door/chest access in zones
GUI Interface Modern menus with minimap integration
World Map Colored faction territories + zones
Combat Logging Death tracking and power penalties
LuckPerms Full integration (optional)
HyperPerms Auto chat integration with placeholders
ECS Integration 11 systems for optimal performance

🔄 Changelog Highlights

v1.0.509 - Major Overhaul Update 🚀

  • 🌍 Multi-Language System - JSON-based translations (EN, FR, ES, DE)
  • 💬 Chat Toggle Mode - Switch between faction/alliance/general chat with /hf c, /hf a, /hf g
  • 🔧 Enhanced LuckPerms Integration - Improved prefix/suffix support with placeholder resolution
  • ⚡ Optimized Map Updates - Chunk-specific queue system for better performance
  • 🛡️ Zone Permissions - Configure door/chest access in SafeZones and WarZones
  • ⚙️ Configurable Power Loss - NeutralKillPowerLoss setting for killing neutral players
  • 🗑️ UI Cleanup - Removed wiki button and faction descriptions for cleaner interface
  • 🔒 Thread Safety - Fixed volatile flags and race conditions
  • 📊 Performance Boost - Only modified chunks are updated instead of entire map
  • 🎨 Better Chat Formatting - LuckPerms prefix/suffix with color code conversion

New Configuration Options:

{
  "NeutralKillPowerLoss": 1,
  "SafeZoneAllowDoors": false,
  "SafeZoneAllowChests": false,
  "WarZoneAllowDoors": false,
  "WarZoneAllowChests": false
}

Language Files: Auto-generated in config/lang/ (en-US.json, fr-FR.json, es-ES.json, de-DE.json)

v1.0.430 - Adjacent Claims & Configuration Update ⚙️

  • 🆕 Adjacent Claims System - Force factions to claim only connected territories
  • 🆕 Anti-hole protection - Prevents disconnected chunk groups when unclaiming
  • 🆕 Inactive Faction Decay - Auto-remove claims after X days of inactivity (configurable)
  • 🆕 PowerPerClaim - Customizable power cost per claim (default: 2)
  • 🆕 MaxFactionMembers - Limit maximum members per faction (default: 50)
  • 🆕 Auto-updating Alliance UI - Alliance interface updates in real-time
  • 🆕 Disband confirmation popup - Prevents accidental faction deletion
  • 🔧 Thread safety fixes - Fixed volatile flags and race conditions
  • 🔧 Enhanced admin powers - Admins can unclaim even if creates disconnected groups
  • ⚙️ Decay system improvements - Now respects adjacency rules

Configuration Example:

{
  "PowerPerClaim": 2,
  "MaxFactionMembers": 50,
  "OnlyAdjacentClaims": false,
  "InactiveFactionDecayDays": 7
}

v1.0.395 - Crash Fix Update 🛠️

  • 🔧 CRITICAL FIX - Resolved server crashes on multi-world servers
  • ✅ Stability restored - Plugin now works correctly with multiple worlds
  • 🔒 Thread safety - All player access executed in correct world thread
  • 🚫 No more crashes - Fixed synchronization issues in map, chat, and notification systems
  • Hotfix release - Immediate update recommended for multi-world servers

v1.0.389 - Data Migration Update 📁

  • 🆕 NEW DATA LOCATION - Moved from universe/Hyfaction/ to plugins/Hyfaction/config/
  • 🆕 Parties.json - New party system data file
  • 📁 Better organization - All data files in one location with configuration
  • 🔧 Multi-world support - Fixed threading issues for servers with multiple worlds
  • ✅ Thread safety - All player access now executed in correct world thread
  • 🛡️ Stability improvements - Better synchronization for map, chat, and notification systems
  • ⚙️ Code improvements - Fixed Java deprecation warnings
  • Migration guide included for seamless upgrade
  • ⚠️ REQUIRES MANUAL MIGRATION - See migration guide above

v1.0.370 - Communication Update 💬

  • 🆕 Faction Chat - Private communication with /hf c
  • 🆕 Alliance Chat - Coordinate with allies via /hf a
  • 🆕 Chat Permissions - Control access with LuckPerms
  • Custom color formatting based on faction colors
  • Efficient message delivery without duplication
  • Bug fixes and performance improvements

v1.0.365 - WarZone Update 🔥

  • 🆕 WarZones System - Dedicated PvP zones without power loss
  • 🆕 Overclaiming - Capture enemy territory at 0 power
  • 🆕 SafeZones - Complete protection for spawn areas
  • Enhanced map display with priority zones
  • Improved combat logging and tracking
  • HyperPerms integration support
  • Performance optimizations and bug fixes

Transform your Hytale server into an epic faction battlefield! ⚔️🏰

Hyfaction - Where strategy meets survival

Последние версии

Hyfaction-1.0.510.jar

Early Access 26.01.2026 771.0 КБ

Hyfaction-1.0.494.jar

Early Access 24.01.2026 757.0 КБ

Hyfaction-1.0.478.jar

Early Access 22.01.2026 748.4 КБ