Guild 玩家公会插件

Guild Plugin 插件介绍
概述

Guild Plugin 是一款面向现代 Minecraft 服务端的功能完整的公会（Guild / Faction）系统插件，由 chenasyd 开发。它为玩家提供从公会创建、成员管理、经济系统、公会关系、等级成长到公会战争的一站式社交生态，几乎所有操作都可通过全图形化 GUI 完成，无需记忆复杂命令。插件完全免费开源，支持 Spigot / Paper / Purpur / Folia 等主流服务端，并可通过模块化 SDK 扩展功能。
插件名称：Guild Plugin
开发者：chenasyd
最新版本：1.6.6（Modrinth 页面版本迭代中，以各发布渠道为准）
许可协议：AGPL-3.0-or-later（免费开源）
兼容版本：Minecraft Java Edition 1.20.1+（原生 GUI / 模块化）；Minecraft 1.21.x、26.1.x、26.2 已验证
运行平台：Spigot、Paper、Purpur、Folia（Bukkit 兼容）；BungeeCord 环境可配合跨服使用
项目地址：
Modrinth：https://modrinth.com/plugin/guild-plugin
SpigotMC：https://www.spigotmc.org/resources/guild-plugin.127996/
GitHub：https://github.com/chenasyd/-GuildPlugin
官方文档：仓库 Wiki（用户指南 / 快速开始 / SDK 开发指南 / GuildWorld / GuildWar）
核心特性
完整的公会管理
支持创建、解散、编辑公会（名称、标签、描述），成员邀请、踢出、升降职，基于「会长（Leader）/ 官员（Officer）/ 成员（Member）」的三级角色权限体系；可设置与传送公会家园，并配备申请/邀请机制、操作日志与成员贡献追踪，全方位覆盖公会日常运营。
公会经济系统
内置公会银行，支持存款、取款、转账；创建费用与升级费用均可配置；通过 Vault 无缝对接绝大多数经济插件（Essentials、PlayerPoints 等），实现灵活的资金体系。
公会关系网络
支持公会之间建立同盟（ally）、敌对（enemy）、中立（neutral）、战争（war）、休战（truce）等多种关系，附带请求→接受/拒绝的完整流程与过期机制，状态变更实时通知，战争警报一目了然。
等级与成长
公会等级可配置成长曲线与升级费用，等级提升不仅扩大成员上限，还可解锁更多公会功能，激励成员共同经营、持续活跃。
全图形化界面
几乎所有操作均可通过库存 GUI 完成，直观易用；铁砧输入等交互设计让玩家告别背命令。同时支持 Geyser + Cumulus 环境下的基岩版表单（Form），Java 版与基岩版玩家均可顺畅使用。
公会世界与公会战争
内置 /guildworld 虚空世界生命周期管理（魔杖选区、.gws 预设导出、A/B/旁观锚点、崩溃恢复）与 /guildwar 固定地图公会战（挑战→报名→倒计时→开战→结算→销毁实例），支持 first（先到 N 击杀）、timed（按时间计分）、survive（淘汰生存）三种胜利模式，并支持自定义友好 fire、保留背包、队伍规模与并发比赛。公会战争为固定地图团队 PVP，与外交关系中的「war」相互独立。
模块化 SDK
提供模块化 SDK 与完整 API，支持通过 /guildmodule 在运行时热加载 / 卸载模块，无需重启服务器；配套 EventBus（模块间解耦通信）、ServiceContainer（依赖注入）、CustomGUI 系统（模块独立注册/打开/卸载界面），卸载时自动清理监听器、任务、命令、GUI 与占位符，并含 Folia 兼容守卫与 ClassLoader 泄漏检测。
异步数据库与高性能
所有数据库操作均通过 HikariCP 连接池异步执行，支持 SQLite 与 MySQL 灵活切换，确保不阻塞主线程、不影响服务器性能。
丰富的占位符变量
深度集成 PlaceholderAPI，提供大量变量，涵盖公会信息（%guild_name%、%guild_tag%、%guild_membercount%、%guild_maxmembers%、%guild_level%、%guild_balance%、%guild_frozen%）、玩家信息（%guild_role%、%guild_joined%、%guild_contribution%）、状态判定（%guild_hasguild%、%guild_isleader%、%guild_isofficer%、%guild_ismember%）及权限检查（%guild_caninvite%、%guild_cankick%、%guild_canpromote%、%guild_candemote%、%guild_cansethome%、%guild_canmanageeconomy%）等。
多语言支持
内置 20+ 套语言包，涵盖简体中文、繁體中文、English、Deutsch、Français、Español、日本語、한국어、Polski、Português (Brasil)、Tiếng Việt、Türkçe、Українська 等，轻松适配国际化服务器。
软依赖集成
可选软依赖：Vault（经济支持）、PlaceholderAPI（占位符支持）、Geyser-Spigot / ImagoCore（基岩表单 / 图像模式 GUI 增强）。核心功能开箱即用，按需扩展。
安装方法
环境要求
服务端：Spigot / Paper / Purpur 1.20.1+（推荐最新版以获得最佳体验）；Folia 1.20.1+（虚空世界创建/加载仅在白名单版本中可用）
Java：JDK 17+（Paper / Folia 高版本服务端建议 Java 21）
可选依赖：Vault（经济对接）、PlaceholderAPI（占位符）、Geyser-Spigot / ImagoCore（GUI 增强）
数据库：默认 SQLite 即可；多服集中存储可使用 MySQL
标准安装
从 Modrinth / SpigotMC / GitHub Releases 下载 guild-plugin-X.X.X.jar。
将 JAR 文件放入服务端的 plugins/ 目录。
启动或重启服务器，插件会自动生成 plugins/GuildPlugin/ 下的配置文件。
（可选）安装 Vault、PlaceholderAPI 等软依赖以解锁扩展功能。
按需编辑 config.yml、messages.yml、gui.yml、database.yml 等配置文件。
执行 /guildadmin reload（或重启服务器）使配置生效。

> ⚠️ 升级提醒：升级插件前务必先备份配置与数据；建议删除旧的 messages_.yml 让插件重新生成，以确保包含所有新增消息键、避免显示异常。