YKGuilds
专为你的 Minecraft 服务器打造的完整公会系统。

? 简介
YKGuilds 是一款功能丰富、完全可配置的公会(氏族)插件。玩家可以创建公会、邀请好友、占领领地、共享保险箱和银行、参与公会战争、提升公会等级,甚至召唤并挑战 公会首领 以获取奖励。
它是广受欢迎的 Guilds 插件(由 Glare 开发)的一个现代化、独立分支——已为新版服务器重新构建,且 无需任何外部库 jar 文件。
✨ 特性
- 公会全面管理 — 创建、邀请、踢出、加入、离开、转让、重命名、设置前缀、每日公告(MOTD)、删除
- 公会银行 — 与 Vault 集成的共享经济余额,支持存入/取出并具备权限检查功能
- 公会仓库 — 每个公会独立的共享存储,可通过层级进行升级
- 公会等级与经验值(NEW!) — 公会通过击杀怪物、玩家以及在线时长获取经验值;可配置的等级曲线
- 排行榜(NEW!) —
/guilds leaderboard GUI,显示按等级或银行余额排名的顶级公会
- 公会首领(NEW!) — 生成袭击首领,玩家为其造成最高伤害以获取排名,并可获得可配置的控制台命令奖励
- 领地认领 — 围绕公会家园认领区块(基于 WorldGuard),支持认领告示牌及进出消息提示
- 公会战争与竞技场 — 挑战其他公会,追踪得分,自定义竞技场
- 联盟 — 与其他公会结盟并共享联盟聊天频道
- 公会增益效果 — 可从增益效果 GUI 购买临时增益效果(可配置)
- 邀请码 — 分享邀请码以便玩家轻松加入你的公会
- 公会聊天与监听 — 独立的聊天频道以及管理员聊天监听功能
- 多层级与角色 — 完全可配置的层级晋升与角色权限系统
- 精美 GUI 界面 — 信息、成员、列表、仓库、增益效果和排行榜菜单,全部可配置
- 多语言支持 — 内置多种语言的翻译文件
- PlaceholderAPI 支持 — 将公会数据暴露给任何兼容 PAPI 的插件
- 管理套件 — 涵盖所有公会操作的管理员命令,以及完整的备份/迁移系统
? 快速开始
- 将
YKGuilds-3.5.7.3-YKStudios.jar 放入服务器的 plugins 文件夹中
- 重启服务器
- 运行
/guilds create <name> 创建你的第一个公会
无需外部依赖项 —— Vault(用于经济系统)、WorldGuard(用于领地认领)和 PlaceholderAPI 均为可选集成组件。
? 命令
所有命令也可使用 /guild 别名执行。
| 指令 |
说明 |
/guilds create <name> |
创建公会 |
/guilds invite <player> |
邀请玩家加入你的公会 |
/guilds accept / /guilds decline |
接受/拒绝公会邀请 |
/guilds leave / /guilds kick <player> |
离开公会/将玩家踢出公会 |
/guilds info |
打开公会信息 GUI |
/guilds members |
打开成员列表 GUI |
/guilds list |
浏览所有公会 |
/guilds leaderboard |
按等级或金库余额查看顶级公会 |
/guilds bank balance / deposit / withdraw |
管理公会银行 |
/guilds vault |
打开公会保险箱 |
/guilds sethome / /guilds home / /guilds delhome |
管理公会出生点 |
/guilds claim / /guilds unclaim |
认领/取消认领领地 |
/guilds war challenge <guild> |
向其他公会发起战争挑战 |
/guilds ally add <guild> |
添加公会成为盟友 |
/guilds code create |
创建邀请码 |
/guilds level |
查看公会等级和经验值进度 |
/guilds boss tp |
传送至当前活跃的公会首领 |
/guilds upgrade |
升级你的公会层级 |
/guilds help |
显示帮助菜单 |
在游戏中运行 /guilds 可查看完整列表。
?️ 权限
每个玩家命令都使用 guilds.command.<command> 节点。它们均包含在默认的 guilds.group.member 权限中,管理员则拥有完整的 guilds.group.admin 组:
guilds.group.member:
default: true # 自动授予所有玩家
guilds.group.admin:
default: op # 完全访问权限(包含所有内容)
示例:
guilds.command.create # 创建公会
guilds.command.bank # 银行相关命令
guilds.command.boss # 首领相关命令
guilds.command.admin # 管理员命令树
? 占位符 (PlaceholderAPI)
所有占位符均采用 %guilds_<placeholder>% 格式:
| 占位符 |
描述 |
%guilds_name% |
玩家的公会名称 |
%guilds_prefix% |
玩家公会的标签前缀 |
%guilds_master% |
公会会长名称 |
%guilds_balance% |
公会金库余额(格式化显示) |
%guilds_balance_raw% |
公会金库余额(原始数值) |
%guilds_member_count% |
成员数量 |
%guilds_members_online% |
在线成员数量 |
%guilds_role% |
玩家在公会中的职位/身份 |
%guilds_tier% |
公会的等级级别 |
%guilds_tier_name% |
公会的等级名称 |
%guilds_status% |
公会的状态(公开/私有) |
%guilds_formatted% |
完整的格式化公会标签([前缀] 名称) |
%guilds_member_1% |
第 1 位成员的名称(member_2%、member_3%,以此类推) |
%guilds_top_wins_name_1% |
按胜场数排名第 1 的公会名称 |
%guilds_top_wins_amount_1% |
排名第 1 的公会胜场数 |
%guilds_top_losses_name_1% |
按负场数排名第 1 的公会名称 |
%guilds_top_losses_amount_1% |
排名第 1 的公会负场数 |
%guilds_top_wlr_name_1% |
按胜负比排名第 1 的公会名称 |
%guilds_top_wlr_amount_1% |
排名第 1 的公会胜负比 |
%guilds_code_amount% |
有效邀请码的数量 |
%guilds_max_members% |
该公会等级允许的最大成员数 |
%guilds_max_balance% |
该公会等级允许的金库最大余额 |
%guilds_challenge_wins% / %guilds_challenge_loses% |
战争挑战得分 |
%guilds_motd% |
公会的每日公告 (MOTD) |
%guilds_spying% |
玩家是否开启了聊天监听功能 |
? 兼容性
- Minecraft: 26.1+
- 依赖项: 无(自包含的 shaded jar 文件)
- 软依赖项(可选):
⚙️ 配置
所有设置均在 plugins/YKGuilds/config.yml 中进行配置:
- 所有 GUI 名称、物品、材质和描述文本 (lore)
- 创建/重命名/设置公会主屋的费用
- 冷却时间与预热时间
- 等级及其解锁条件(tiers.yml)
- 角色权限(roles.yml)
- 公会 Boss(启用状态、生成位置、类型、时间限制、奖励)
- XP 来源与经验曲线
- 领地半径、消息及禁用的世界
- 语言文件 (
plugins/YKGuilds/languages/)
消息使用现代化的 {@@key} 引用系统 —— 每条消息均可在语言文件中编辑。
? 支持与反馈
YKGuilds 是开源 Guilds 插件的一个修改分支,根据 MIT 许可证发布。
YKGuilds
The complete Guild system for your Minecraft server.

? About
YKGuilds is a feature-rich, fully configurable guild (clan) plugin. Players can create guilds, invite their friends, claim land, share vaults and banks, fight in guild wars, level up their guild, and even summon and fight a Guild Boss for rewards.
It is a modernized, self-contained fork of the popular Guilds plugin by Glare — rebuilt for newer server versions, with no external library jar required.
✨ Features
- Full Guild Management — create, invite, kick, join, leave, transfer, rename, prefix, MOTD, delete
- Guild Banks — shared economy balance with Vault support, deposit/withdraw with permission checks
- Guild Vaults — per-guild shared storage, upgradeable through tiers
- Guild Levels & XP (NEW!) — guilds earn XP from mob kills, player kills and playtime; configurable level curve
- Leaderboards (NEW!) —
/guilds leaderboard GUI showing top guilds by level or by bank balance
- Guild Boss (NEW!) — spawn a raid boss, players fight it for top-damage placement and configurable console-command rewards
- Land Claims — claim chunks around your guild home (WorldGuard based), claim signs, enter/exit messages
- Guild Wars & Arenas — challenge other guilds, score tracking, custom arenas
- Alliances — ally with other guilds and share an ally chat
- Guild Buffs — temporary buffs purchasable from the buff GUI (configurable)
- Invite Codes — share codes so players can join your guild easily
- Guild Chat & Spy — separate chat channels plus admin chat-spy
- Multiple Tiers & Roles — fully configurable tier upgrades and role permissions
- Beautiful GUIs — info, members, list, vaults, buffs and leaderboard menus, all configurable
- Multi-language — a wide range of bundled translations
- PlaceholderAPI support — expose guild data to any PAPI-compatible plugin
- Admin Suite — admin commands for every guild action, plus a complete backup/migrate system
? Getting Started
- Drop
YKGuilds-3.5.7.3-YKStudios.jar into your server's plugins folder
- Restart the server
- Run
/guilds create <name> to create your first guild
No external dependencies are required — Vault (for economy), WorldGuard (for claims) and PlaceholderAPI are optional integrations.
? Commands
All commands are also available under the /guild alias.
| Command |
Description |
/guilds create <name> |
Create a guild |
/guilds invite <player> |
Invite a player to your guild |
/guilds accept / /guilds decline |
Accept / decline a guild invite |
/guilds leave / /guilds kick <player> |
Leave / kick from the guild |
/guilds info |
Open the guild info GUI |
/guilds members |
Open the member list GUI |
/guilds list |
Browse all guilds |
/guilds leaderboard |
View top guilds by level or bank |
/guilds bank balance / deposit / withdraw |
Manage the guild bank |
/guilds vault |
Open the guild vault |
/guilds sethome / /guilds home / /guilds delhome |
Manage the guild home |
/guilds claim / /guilds unclaim |
Claim / unclaim land |
/guilds war challenge <guild> |
Challenge another guild to war |
/guilds ally add <guild> |
Add a guild as an ally |
/guilds code create |
Create an invite code |
/guilds level |
View guild level and XP progress |
/guilds boss tp |
Teleport to the active Guild Boss |
/guilds upgrade |
Upgrade your guild tier |
/guilds help |
Show the help menu |
Run /guilds in-game for the full list.
?️ Permissions
Every player command uses the guilds.command.<command> node. All of them are included in the default guilds.group.member permission, and admins get the full guilds.group.admin group:
guilds.group.member:
default: true # granted to every player automatically
guilds.group.admin:
default: op # full access (includes everything)
Examples:
guilds.command.create # create a guild
guilds.command.bank # bank commands
guilds.command.boss # boss commands
guilds.command.admin # admin command tree
? Placeholders (PlaceholderAPI)
All placeholders use the %guilds_<placeholder>% format:
| Placeholder |
Description |
%guilds_name% |
The player's guild name |
%guilds_prefix% |
The player's guild prefix |
%guilds_master% |
The guild's master name |
%guilds_balance% |
The guild bank balance (formatted) |
%guilds_balance_raw% |
The guild bank balance (raw number) |
%guilds_member_count% |
Number of members |
%guilds_members_online% |
Number of members online |
%guilds_role% |
The player's role in the guild |
%guilds_tier% |
The guild's tier level |
%guilds_tier_name% |
The guild's tier name |
%guilds_status% |
The guild's status (public/private) |
%guilds_formatted% |
The full formatted guild tag ([Prefix] Name) |
%guilds_member_1% |
The 1st member name (member_2%, member_3%, ...) |
%guilds_top_wins_name_1% |
Name of the #1 guild by wins |
%guilds_top_wins_amount_1% |
Win count of the #1 guild |
%guilds_top_losses_name_1% |
Name of the #1 guild by losses |
%guilds_top_losses_amount_1% |
Loss count of the #1 guild |
%guilds_top_wlr_name_1% |
Name of the #1 guild by win/loss ratio |
%guilds_top_wlr_amount_1% |
Win/loss ratio of the #1 guild |
%guilds_code_amount% |
Number of active invite codes |
%guilds_max_members% |
Max members for the guild's tier |
%guilds_max_balance% |
Max bank balance for the guild's tier |
%guilds_challenge_wins% / %guilds_challenge_loses% |
War challenge score |
%guilds_motd% |
The guild's MOTD |
%guilds_spying% |
Whether the player has chat spy enabled |
? Compatibility
- Minecraft: 26.1+
- Dependencies: none (self-contained shaded jar)
- Soft-dependencies (optional):
⚙️ Configuration
Everything is configurable in plugins/YKGuilds/config.yml:
- All GUI names, items, materials and lore
- Guild creation / rename / home costs
- Cooldowns and warmups
- Tier levels and their unlocks (tiers.yml)
- Role permissions (roles.yml)
- Guild Boss (enabled, spawn location, type, time limit, rewards)
- XP sources and level curve
- Claim radius, messages and disabled worlds
- Language files (
plugins/YKGuilds/languages/)
Messages use the modern {@@key} referencing system — every message is editable in the language files.
? Support & Feedback
- Want a new feature? Let us know on the Discord
YKGuilds is a modified fork of the open-source Guilds plugin, released under the MIT license.
评论 0
登录后参与评分
还没有评论,来抢沙发吧