HyGuild
A complete guild system for Hytale servers with roles, private guild chat, on-screen notifications, and intelligent map filtering.
Описание
HyGuild — плагин для Hytale Servers
Присоединяйтесь к нашей Discord для поддержки, обновлений и документации.
HyGuild - это полнофункциональный плагин гильдии для серверов Hytale, предназначенный для многопользовательской и ролевой сред.
Он предоставляет полную систему гильдий с ролями, разрешениями, экономикой, территориальными претензиями, держателями мест и интеллектуальным фильтром видимости карты, который показывает только членов гильдии.
Плагин легкий, эффективный и полностью настраиваемый.
Основные характеристики
Создание Гильдии и управление
4-уровневая иерархия ролей (лидер, офицер, член, рекрут)
Поддержка разрешения LuckPerms
Внутренний API-интерфейс (используемый другими плагинами)
Частный чат гильдии (г)
Экранные уведомления о событиях гильдии
Интеллектуальный фильтр видимости карты
Территориальные претензии Гильдии
Личная денежная система и банк гильдии
Постоянство данных JSON
Многоязычная поддержка (итальянский и английский)
Гильдийская система
Обычные названия гильдий
Настраиваемый максимум членов на гильдию
Членство на основе приглашений
Устойчивое хранение с использованием JSON
Роли и разрешения
Лидер: Полный контроль (приглашать, пинать, продвигать, понижать, распускать)
офицерПриглашать и пинать членов
членСтандартный член
набиратьНовый член
предрасположенность Чат-система
Частный чат гильдии: /g <сообщение>
цветной [ЧАТ-ГИЛД] префикс
Публичный чат показывает: [GuildName] Имя игрока: сообщение
Интеллектуальный картографический фильтр
Игроки в гильдии:
Увидеть себя
Видишь? Только члены гильдии
Делай Нет. Видеть других игроков
Игроки без гильдии:
Видеть только себя
Уведомления на экране
Члены Гильдии получают уведомления о:
Присоединяйтесь / Leave
События Kick
Акции / понижения
Гильдия расформирована
Приглашенные или пострадавшие игроки получают персональные уведомления.
️ Команды
/guild create <name>
/guild invite <player>
Гильдия принимает
Отпуск гильдии
/guild kick <player>
Гильдия расформирована
/guild promote <player>
Гильдия Демо
Список гильдий
/guild info
г Разрешения (LuckPerms)
HyGuild полностью поддерживает LuckPerms с гранулированными разрешениями для:
Руководство гильдии
претензии
Чат
Экономика
Административный контроль ()hyguild.admin, Гигильдия. *)
Placeholder API
HyGuild включает в себя встроенный API-интерфейс, который можно использовать в:
Сообщения
Чат форматы
Конфигурационные файлы
Другие плагины
Доступные заполнители включают:
% гигильдия% игроков % гигильдия_uuid% % гигильдиягильдия% % гигильдия_role% % гигильдия% участников % гигильдия_maxmembers% % гигильдия_claims% % гигильдия_деньги% % гигильдия_bank% %hyguild_hasгильдия% %hyguild_is_leader% )️ GUI (в разработке)
Список гильдий Откроется графический интерфейс вместо вывода чата
/guild info Откроет GUI с полной информацией гильдии
GUI будут повторно использовать существующую командную логику (без дублирования логики).
️ Конфигурация
Путь: mods/com.hytale_GuildPlugin/config.json
Языки:
это Итальянский (по умолчанию)
в английский
️️ Перезагрузка сервера требуется после изменения языка.
Технические детали
настойчивость JSON
Структуры данных Thread-safe
Игровой кэш для улучшения производительности
Фильтрация динамических карт
Минимальная заготовка (только ошибки)
Версия и совместимость
Версия: 1.2.0
Совместим с: Hytale Server 2026.01.13+
Языки: Итальянский , английский
Команда HyGuild
Показать оригинальное описание (English)
🏰 HyGuild – Guild Plugin for Hytale Servers
Join our Discord for support, updates, and documentation.
HyGuild is a full-featured guild plugin for Hytale servers, designed for multiplayer and roleplay environments.
It provides a complete guild system with roles, permissions, economy, territory claims, placeholders, and an intelligent map visibility filter that only shows guild members.
The plugin is lightweight, performant, and fully configurable.
✨ Main Features
Guild creation and management
4-level role hierarchy (Leader, Officer, Member, Recruit)
LuckPerms permission support
Internal Placeholder API (usable by other plugins)
Private guild chat (/g)
On-screen notifications for guild events
Intelligent map visibility filter
Guild territory claims
Personal money system and guild bank
JSON data persistence
Multi-language support (Italian & English)
🧩 Guild System
Custom guild names
Configurable maximum members per guild
Invitation-based membership
Persistent storage using JSON
Roles & Permissions
Leader: Full control (invite, kick, promote, demote, disband)
Officer: Invite and kick members
Member: Standard member
Recruit: New member
💬 Chat System
Private guild chat: /g <message>
Colored [CHAT-GUILD] prefix
Public chat shows: [GuildName] PlayerName: message
🗺️ Intelligent Map Filter
Players in a guild:
See themselves
See ONLY guild members
Do NOT see other players
Players without a guild:
See only themselves
📢 On-Screen Notifications
Guild members receive notifications for:
Member join / leave
Kick events
Promotions / demotions
Guild disband
Invited or affected players receive personal notifications.
🛠️ Commands
/guild create <name>
/guild invite <player>
/guild accept
/guild leave
/guild kick <player>
/guild disband
/guild promote <player>
/guild demote
/guild list
/guild info
/g
🔐 Permissions (LuckPerms)
HyGuild fully supports LuckPerms with granular permissions for:
Guild management
Claims
Chat
Economy
Admin override (hyguild.admin, hyguild.*)
🔗 Placeholder API
HyGuild includes a built-in Placeholder API that can be used in:
Messages
Chat formats
Configuration files
Other plugins
Available placeholders include:
%hyguild_player%
%hyguild_uuid%
%hyguild_guild%
%hyguild_role%
%hyguild_members%
%hyguild_maxmembers%
%hyguild_claims%
%hyguild_money%
%hyguild_bank%
%hyguild_has_guild%
%hyguild_is_leader%
🖥️ GUI (In Development)
/guild list will open a GUI instead of chat output
/guild info will open a GUI with full guild information
GUIs will reuse existing command logic (no duplicated logic)
⚙️ Configuration
Path: mods/com.hytale_GuildPlugin/config.json
Languages:
it – Italian (default)
en – English
⚠️ Server restart required after language change.
📦 Technical Details
JSON persistence
Thread-safe data structures
Player cache for improved performance
Dynamic map filtering
Minimal logging (errors only)
📌 Version & Compatibility
Version: 1.2.0
Compatible with: Hytale Server 2026.01.13+
Languages: Italian 🇮🇹, English 🇬🇧
The HyGuild Team
Информация
Авторы:
Категории:
Версии игры:
Создан: 15.01.2026
