Guild Plugin
一个功能完备的 Minecraft 公会 / 阵营系统——包含经济、关系、等级、完整 GUI、模块化 SDK、虚空竞技场和固定地图公会战。免费且开源。支持 Spigot、Paper、Purpur 和 Folia。
亮点
- 公会管理 — 创建、邀请、踢出、晋升/降级、申请、家传送
- 经济 — 通过 Vault 实现公会银行(存款 / 取款 / 转账)
- 关系 — 盟友、敌人、中立、战争、休战(含请求流程)
- 等级 — 可配置的等级、消耗和成员上限
- 完整 GUI — 几乎所有操作都有物品栏菜单;当存在 Geyser + Cumulus 时支持 Bedrock 表单
- 世界与公会战 — 虚空竞技场、法杖选择、
.gws 预设、挑战 → 报名 → 战斗 → 拆除 (/guildworld, /guildwar)
- 模块化 SDK — 运行时热加载模块 (
/guildmodule),EventBus、ServiceContainer、CustomGUI
- 多语言 — 中文、英文及其他 20 多种语言
- 异步数据库 — HikariCP 配合 SQLite 或 MySQL
公会战是固定地图的团队 PVP,而非领地争夺战,并且独立于外交关系类型中的 war。
依赖要求
|
|
| Minecraft |
1.20.1+ |
| Java |
17+ |
| 软依赖 |
Vault (经济), PlaceholderAPI (占位符), Geyser-Spigot / ImagoCore (可选 GUI 扩展) |
| 软件 |
版本 |
| Spigot |
1.20.1+ |
| Paper |
1.20.1+ |
| Purpur |
1.20.1+ |
| Folia |
1.20.1+ (世界创建/加载限制在支持的 Folia 构建版上) |
安装
- 将 JAR 文件放入
plugins/ 目录
- 启动服务器(配置文件会自动生成)
- 根据需要编辑
plugins/GuildPlugin/config.yml
- 运行
/guildadmin reload(或重启服务器)
升级时:请先备份数据。建议重新生成语言文件,以便新的消息键能正确显示。
命令
| 命令 |
别名 |
描述 |
/guild |
/g |
玩家公会 GUI 及命令 |
/guildadmin |
/ga |
管理面板 |
/guildmodule |
/gm |
热加载 / 卸载模块 |
/guildworld |
/gworld |
虚空世界、预设方案、恢复功能 |
/guildwar |
/gwar |
固定地图公会战 |
公会战(快速流程)
/guildwar challenge <公会> [--preset] [--mode first|timed|survive]
/guildwar accept
/guildwar join
/guildwar ready # 双方军官 → 提前开始
胜利模式:first(先达成 N 次击杀)、timed(限时计分)、survive(最后存活的队伍)。
PlaceholderAPI(通用)
| 占位符 |
描述 |
%guild_name% |
公会名称 |
%guild_tag% |
公会标签 |
%guild_membercount% |
成员数量 |
%guild_maxmembers% |
最大成员数 |
%guild_level% |
公会等级 |
%guild_balance% |
余额(保留两位小数) |
%guild_frozen% |
状态 |
%guild_role% |
玩家角色 |
%guild_hasguild% |
是否拥有公会(是/否) |
%guild_isleader% |
是否为会长 |
%guild_caninvite% / %guild_cankick% / … |
权限检查 |
完整列表:项目维基 → PlaceholderAPI 参考文档。
链接
- GitHub
- Issues
- 文档:GuildWorld / GuildWar / SDK 开发者指南(位于仓库的
Wiki/ 中)
许可证
GNU GPL v3.0
Guild Plugin
A feature-complete Minecraft guild / faction system — economy, relations, leveling, full GUI, modular SDK, void-world arenas, and fixed-map guild war. Free and open-source. Supports Spigot, Paper, Purpur, and Folia.
Highlights
- Guild management — create, invite, kick, promote/demote, applications, home teleport
- Economy — guild bank (deposit / withdraw / transfer) via Vault
- Relations — ally, enemy, neutral, war, truce (with request flow)
- Leveling — configurable levels, costs, and member caps
- Full GUI — inventory menus for nearly every action; Bedrock form support when Geyser + Cumulus are available
- Worlds & Guild War — void arenas, wand selection,
.gws presets, challenge → signup → fight → teardown (/guildworld, /guildwar)
- Modular SDK — hot-load modules at runtime (
/guildmodule), EventBus, ServiceContainer, CustomGUI
- Multi-language — Chinese, English, and 20+ other languages
- Async DB — HikariCP with SQLite or MySQL
Guild War is fixed-map team PVP, not claim/territory war, and is separate from diplomatic relation type war.
Requirements
|
|
| Minecraft |
1.20.1+ |
| Java |
17+ |
| Soft depends |
Vault (economy), PlaceholderAPI (placeholders), Geyser-Spigot / ImagoCore (optional GUI extras) |
| Software |
Version |
| Spigot |
1.20.1+ |
| Paper |
1.20.1+ |
| Purpur |
1.20.1+ |
| Folia |
1.20.1+ (world create/load gated to supported Folia builds) |
Installation
- Drop the JAR into
plugins/
- Start the server (configs generate automatically)
- Edit
plugins/GuildPlugin/config.yml as needed
- Run
/guildadmin reload (or restart)
When upgrading: back up data first. Prefer regenerating language files so new message keys appear correctly.
Commands
| Command |
Alias |
Description |
/guild |
/g |
Player guild GUI & commands |
/guildadmin |
/ga |
Admin panel |
/guildmodule |
/gm |
Hot-load / unload modules |
/guildworld |
/gworld |
Void worlds, presets, recovery |
/guildwar |
/gwar |
Fixed-map guild war |
Guild War (quick flow)
/guildwar challenge <guild> [--preset] [--mode first|timed|survive]
/guildwar accept
/guildwar join
/guildwar ready # both officers → start early
Victory modes: first (first to N kills), timed (score by time), survive (last team standing).
PlaceholderAPI (common)
| Placeholder |
Description |
%guild_name% |
Guild name |
%guild_tag% |
Guild tag |
%guild_membercount% |
Member count |
%guild_maxmembers% |
Max members |
%guild_level% |
Guild level |
%guild_balance% |
Balance (2 decimals) |
%guild_frozen% |
Status |
%guild_role% |
Player role |
%guild_hasguild% |
Has guild (Yes/No) |
%guild_isleader% |
Is leader |
%guild_caninvite% / %guild_cankick% / … |
Permission checks |
Full list: project wiki → PlaceholderAPI reference.
Links
- GitHub
- Issues
- Docs: GuildWorld / GuildWar / SDK Developer Guide (in the repository
Wiki/)
License
GNU GPL v3.0
评论 0
登录后参与评分
还没有评论,来抢沙发吧