Description
🏰 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