HyGuild

🏰 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 &ndash; Italian (default)

en &ndash; 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