HyGuild

HyGuild

为Hytale服务器设计的完整公会系统，包含角色权限、私人公会聊天、屏幕通知和智能地图筛选功能。

实用

🏰 HyGuild – Hytale 服务器公会插件

加入我们的 Discord 以获取支持、更新和文档。

HyGuild 是一款用于 Hytale 服务器的全功能公会插件，专为多人游戏和角色扮演环境设计。它提供了一个完善的公会系统，包含角色、权限、经济、领土声明、占位符以及一个仅显示公会成员的智能地图可见性过滤器。

该插件轻量、高效且完全可配置。

✨ 主要功能

  • 公会的创建和管理
  • 4 级角色层级（会长、官员、成员、新兵）
  • LuckPerms 权限支持
  • 内部占位符 API（可供其他插件使用）
  • 私密公会聊天 (/g)
  • 公会事件的屏幕通知
  • 智能地图可见性过滤器
  • 公会领地声明
  • 个人金钱系统和公会银行
  • JSON 数据持久化
  • 多语言支持（意大利语和英语）

🧩 公会系统

  • 自定义公会名称
  • 每个公会可配置的最大成员数
  • 基于邀请的成员身份
  • 使用 JSON 进行持久化存储

角色与权限

  • 会长：完全控制权（邀请、踢出、晋升、降级、解散）
  • 官员：可以邀请和踢出成员
  • 成员：标准成员
  • 新兵：新加入的成员

💬 聊天系统

  • 私密公会聊天：/g <消息>
  • 带有颜色的 [CHAT-GUILD] 前缀
  • 公开聊天显示：[公会名称] 玩家名: 消息

🗺️ 智能地图过滤器

  • 有公会的玩家：
    • 可以看到自己
    • 仅能看到公会成员
    • 不能看到其他玩家
  • 没有公会的玩家：
    • 只能看到自己

📢 屏幕通知

公会成员会收到以下事件的通知：

  • 成员加入/离开
  • 踢出事件
  • 晋升/降级
  • 公会解散
  • 被邀请或受影响的玩家会收到个人通知。

🛠️ 命令

/guild create <名称>
/guild invite <玩家>
/guild accept
/guild leave
/guild kick <玩家>
/guild disband
/guild promote <玩家>
/guild demote
/guild list
/guild info
/g

🔐 权限 (LuckPerms)

HyGuild 完全支持 LuckPerms，为以下方面提供细粒度权限：

  • 公会管理
  • 领地声明
  • 聊天
  • 经济
  • 管理员覆盖 (hyguild.admin, hyguild.*)

🔗 占位符 API

HyGuild 包含一个内置的占位符 API，可用于：

  • 消息
  • 聊天格式
  • 配置文件
  • 其他插件

可用的占位符包括：

%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（开发中）

  • /guild list 将打开一个 GUI 而非聊天输出
  • /guild info 将打开一个显示完整公会信息的 GUI
  • GUI 将重用现有的命令逻辑（无重复逻辑）

⚙️ 配置

路径： mods/com.hytale_GuildPlugin/config.json

语言：

  • it – 意大利语（默认）
  • en – 英语

⚠️ 更改语言后需要重启服务器。

📦 技术细节

  • JSON 持久化
  • 线程安全的数据结构
  • 玩家缓存以提高性能
  • 动态地图过滤
  • 最小化日志记录（仅错误）

📌 版本与兼容性

  • 版本： 1.2.0
  • 兼容性： Hytale Server 2026.01.13+
  • 语言： 意大利语 🇮🇹，英语 🇬🇧

HyGuild 团队