Описание

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>) - ✅ Чанк уже должен быть востребован вражеской фракцией.
- ✅ Ваша фракция должна иметь достаточно доступных претензий.
Как это работает:
- Объявить фракцию врагом:
/hf enemy <targetFaction> - Вступайте в бой, чтобы уменьшить их мощность до 0 или ниже.
- Стоять в куске, заявленном вражеской фракцией
- казнить
/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 или более раннее, выполните следующие действия:
Быстрые шаги миграции:
- Остановите сервер
- Резервное копирование твой
Вселенная/Гифация/папка - Создавать каталоги:
плагины/Hyfaction/configплагины/Hyfaction/config/faction
- Переместить основные файлы то
плагины/Hyfaction/config:Партии.Claims.jsonИмя:ache.jsonAdminOverrides.jsonSafeZones.jsonWarZones.jsoncombatlogs.json
- Переместить файлы фракции: Все файлы UUID.json
фракции?конфигурация/фракция/ - Стартовый сервер Проверьте, все ли работает
️️ Всегда резервное копирование перед внесением изменений!
Структура файла (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.adminpermission
⚙️ 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
MaxPlayerPowerper 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 requirementOnlyAdjacentClaims: 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
InactiveFactionDecayDaysdays, 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 inactivityInactiveFactionDecayDays: 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:
- Declare a faction as enemy:
/hf enemy <targetFaction> - Engage in combat to reduce their power to 0 or below
- Stand in a chunk claimed by the enemy faction
- Execute
/hf overclaimto capture it
Configuration:
EnableOverclaiming: true- Overclaiming enabled, no automatic decayEnableOverclaiming: 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:
- 🛑 Stop your server
- 💾 Backup your
universe/Hyfaction/folder - 📁 Create directories:
plugins/Hyfaction/config/plugins/Hyfaction/config/faction/
- 📦 Move main files to
plugins/Hyfaction/config/:Parties.jsonClaims.jsonNameCache.jsonAdminOverrides.jsonSafeZones.jsonWarZones.jsoncombatlogs.json
- 📦 Move faction files: All UUID.json files from
factions/→config/faction/ - ✅ 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 helpin-game - Wiki: Access via
/hf wikiin-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 -
NeutralKillPowerLosssetting 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/toplugins/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
Hyfaction-1.0.494.jar
Hyfaction-1.0.478.jar
Информация
Авторы:
Версии игры:
Создан: 15.01.2026
