
文档 · Discord · 源代码与问题反馈
玩家真正愿意组建的团队
Donut Teams 是一款免费、开源的团队插件,适用于 Paper、Folia 和 Purpur,支持 Minecraft 1.20.1 至 26.3。
玩家只需几秒钟即可创建团队(在 1.21.7+ 版本中为原生输入对话框),通过可点击的 [接受] 邀请好友,并共享 出生点、银行和金库。团队可以为成员 升级职位,通过 升级 来增加人数上限,建立 盟友与敌对关系,并在 属于你世界的排行榜 上竞争。所有功能均可通过 menus.yml 自定义菜单进行重塑。
2.0 “The Alliance Update” 是一次全面重写:
- 职位系统与十二种成员权限;
- 盟友、敌人、盟友聊天及盟友间伤害豁免;
- 团队金库、团队等级与共享团队箱子;
- 带有标题倒计时功能的命名出生点;
- 可点击的邀请、加入请求及公开团队;
- 击杀统计、排行榜及浮动顶级团队展示板;
- 全功能菜单、原生对话框、支持关系占位符的 PlaceholderAPI、LuckPerms 上下文以及 MariaDB/MySQL 数据库支持。
每个版本均在 15 个运行 1.20.1 至 26.3 版本的 Paper 和 Folia 服务器上进行机器人测试,包括从 1.0.1 版本的升级路径。




/team 打开一个包含所有内容的菜单:成员、出生点、银行、金库、盟友与敌人、等级、排行榜、团队聊天和设置。没有团队的玩家将看到一个用于创建团队的菜单,查看他们的邀请,浏览所有团队或查看顶级团队。
- 所有菜单均位于
menus.yml 中:包括标题、大小、槽位、物品、名称和描述,长列表支持分页。
- 所有功能也都有对应的命令,并支持 Tab 补全:
/team invite、/team home、/team deposit 2.5k...
- 在 1.21.7 及更高版本 中,名称和金额直接在 原生对话框 中输入,而非聊天栏。


- 所有者、官员和成员。 使用
/team promote 和 /team demote,或在成员菜单中双击操作。
- 十二种权限:邀请、踢出、使用出生点、设置出生点、团队聊天、友军伤害、存入、取出、金库、外交、设置和升级。每种职位在
config.yml 中都有默认值;所有者可以为任何成员更改其中任意一项。
- 成员可以踢出、晋升或降级低于自己职位的成员,但不能高于自己的职位。所有权变更使用
/team transfer。


/team ally Sunfire 发起请求;对方通过可点击的 [Ally] 按钮接受。/team enemy Ravens 宣战,无需征得同意。/team neutral 达成和平。
- 盟友聊天 (
/ac) 可同时发送给你的团队和所有盟友。
- 盟友之间无法互相伤害,除非两个团队都开启了盟友伤害。队友也受到同样的保护:近战、箭矢、三叉戟、宠物和有害药水。
- 关系占位符会在标签页和名称标签中将队友显示为绿色,盟友显示为青色,敌人显示为红色。


- 团队金库,通过 Vault 或 VaultUnlocked 实现:
/team deposit 2.5k、/team withdraw 1m,或在银行菜单中使用预设和手动输入的金额,并记录最新交易及操作者。
- 等级 可从银行购买:每升一级都会提高成员上限、出生点数量以及团队金库的行数。默认为五级,你可以设置任意数量。
- 创建团队也可以花费资金。当团队解散时,所有者将获得银行中的余额。


/team chest(或 /team ec):一至六行,由团队等级决定。
- 在 Paper 上,多个队友可以同时使用;在 Folia 上,一次只能一人使用,从而避免重复领取。
- 关闭时保存,并在开启状态下每分钟保存一次,采用 Paper 的版本化物品格式,确保物品能跨 Minecraft 版本保留。解散团队时,物品归所有者所有。


- 命名出生点:
/team sethome farm、/team home farm,以及出生点菜单。团队等级决定可用数量。
- 标题栏和操作栏上的倒计时。离开所在方块或受到伤害会取消倒计时。
- 可选的冷却时间、音效、粒子效果,以及禁用团队出生点的世界配置。



- 可点击的邀请:聊天窗口中直接显示 [接受] 和 [拒绝] 按钮,并设有邀请菜单。
- 加入请求:执行
/team request Nightbeam;官员会收到 [接受] 和 [拒绝] 按钮。
- 公开团队:执行
/team open,任何人都可以 /team join(加入)。
- 官员可以从在线玩家头像列表中进行邀请。


- 团队聊天与盟友聊天:使用
/tc 和 /ac 发送消息,可作为切换功能,或附带可选的快速前缀(如 @hello)。
- 当成员上线或离线时,队友会收到通知;加入时他们会看到团队的 每日公告 (motd)。
- 管理员可以使用
/donutteams spy 阅读所有团队和盟友聊天内容。


- 玩家的击杀和死亡数计入团队总分(队友和盟友的不计入)。每个团队都有独立的 KDR(击杀死亡比)。
/team top:按击杀数、银行余额、等级或成员数量排名的最佳团队。
- 世界内的排行榜板:执行
/donutteams board create spawn kills 会在出生点放置一个自动更新的浮动顶级团队排行榜,大小由你设定。无需任何全息图插件。
- 用于计分板和全息图的占位符:
%donutteams_top_kills_1_name%。


- 团队可以选择 颜色、图标(手持任意物品均可,旗帜效果极佳)、标签、描述 以及 每日公告 (motd)。
- 规则由你制定:名称长度限制、屏蔽词、创建费用、职位权限、等级系统、出生点等待时间与冷却时间、盟友上限、银行总额上限等。
- 每条消息均支持 MiniMessage 格式(或
& 代码),位于 messages.yml 中;每个菜单配置位于 menus.yml 中;每个音效设置位于 config.yml 中。


以下所有集成均为可选:
| 插件 |
Donut Teams 的功能 |
| Vault (或 VaultUnlocked) |
团队银行、等级、创建费用 |
| PlaceholderAPI |
40+ 个占位符、排行榜,以及用于 Tab 栏和名字标签的关系型占位符 |
| LuckPerms |
上下文节点:donutteams:has-team、donutteams:role、donutteams:team |
| MariaDB 或 MySQL |
替代 SQLite 的存储方案,支持表前缀 |
| DonutCore |
显示名称 |
面向开发者:提供 DonutTeamsApi(包含团队、成员、职位、关系)以及十一个可取消的事件,从 TeamCreateEvent 到 TeamRelationChangeEvent、TeamBankTransactionEvent 和 TeamHomeTeleportEvent。


替换 jar 文件并重启服务器。Donut Teams 会在启动时自动升级你的 1.x 安装数据:
- 团队、成员、邀请和出生点数据将保留。 1.x 版本的“家”现在称为
home;友伤设置保持不变。
config.yml 会保留你的原有值(旧文件将被保存为 config-1.x.yml)。
messages.yml 会被新消息模板替换(你的原文件将被保存为 messages-1.x.yml)。
- 1.x 版本的 8 人上限已移除:现在通过等级和
donutteams.slots.<n> 权限来设定人数上限。


| 服务端 |
Minecraft 版本 |
Java 版本 |
| Paper, Purpur 及其他 Paper 分支 |
1.20.1 – 1.20.4 |
17 |
| Paper, Purpur 及其他 Paper 分支 |
1.20.5 – 1.21.11 |
21 |
| Paper, Purpur 及其他 Paper 分支 |
26.1 – 26.3 |
25 |
| Folia |
1.20.1 – 26.3 |
17 – 25 |
一个 jar 文件适用于上述所有服务端。原生对话框需要 1.21.7 或更高版本;较旧的服务端将在聊天窗口中提示。不支持 Spigot 和 Bukkit(它们缺乏 Paper API):插件会明确提示并停止运行。
每个发布版本均在 Paper 1.20.1、1.20.4、1.20.6、1.21.1、1.21.4、1.21.8、1.21.11、26.1.2、26.2 和 26.3,以及 Folia 1.20.4、1.21.4、1.21.11 和 26.3 上经过机器人自动化测试,并使用 SQLite 和 MariaDB 数据库进行验证:每项测试约包含 30 个检查步骤,涵盖从创建团队到解散团队的全过程,包括从 1.0.1 版本升级以及重启测试。控制台必须保持无错误状态。

| 命令 |
说明 |
/team |
打开团队菜单 |
/team create [name] [tag] |
创建团队 |
/team invite <player>, join <team>, request <team>, accept <player>, deny <player> |
加入相关操作 |
/team leave, kick, promote, demote, transfer <player>, disband |
成员管理 |
/team chat [msg] (/tc), allychat [msg] (/ac) |
聊天功能 |
/team home [name], sethome [name], delhome [name], homes |
出生点管理 |
/team bank, deposit <amount>, withdraw <amount>, level [up], chest |
银行、等级、储物箱 |
/team ally <team>, enemy <team>, neutral <team>, relations |
外交关系 |
/team pvp, allypvp, open, color, icon, tag, rename, description, motd |
设置选项 |
/team info [team], list, top [kills|balance|level|members] |
信息与排行榜 |
/donutteams reload|info|disband|join|kick|setowner|rename|bank|level|chest|spy|board|purge |
管理员命令 |
| 权限 |
默认值 |
说明 |
donutteams.use, .create, .chat, .home |
everyone |
玩家功能 |
donutteams.slots.<n> |
nobody |
队长所属的队伍可以拥有 n 名成员 |
donutteams.bypass.cost, .cooldown |
op |
免费组队,无队伍创建冷却 |
donutteams.bypass.warmup, .friendlyfire |
nobody |
立即传送至队伍出生点,仍可伤害队友 |
donutteams.admin, donutteams.admin.spy |
op |
管理员指令,聊天监听 |

需要 Vault 吗? 仅用于银行、消耗金钱的经验等级以及创建队伍的费用。其他功能无需 Vault 即可运行。
支持 Folia 吗? 是的,所有功能均支持。在 Folia 上,队伍箱子同一时间只能由一名玩家使用。
我可以自定义菜单吗? 所有的标题、槽位、物品、名称和描述行都在 menus.yml 中。将某个槽位设置为 -1 即可隐藏该物品。
如何在标签页列表中为队友着色? 在使用关系占位符的标签页或名字标签插件中使用 %rel_donutteams_relation_color%。
多服务器环境? 每个服务器使用一个独立的数据库。跨网络共享队伍是 NightTeams Pro 的功能。
我的 1.x 版本队伍会保留吗? 会的。新版本启动时会自动升级;但无论如何,请事先备份 plugins/DonutTeams/ 目录。







运营服务器? NightBeam 的高级插件已上架 BuiltByBit:NightWatch Pro 反作弊、ELO 排名排行榜等更多产品。
NightBeam Studio 的其他作品
关注: YouTube · Instagram · X · Facebook

Docs · Discord · Source and issues
Teams your players will actually build around
Donut Teams is a free, open-source team plugin for Paper, Folia and Purpur, from Minecraft 1.20.1 to 26.3.
Players start a team in a few seconds (on 1.21.7+ in a native input dialog), invite friends with a clickable
[Accept], and share homes, a bank and a chest. Teams rank up their members, level up for more room,
make allies and enemies, and race up leaderboards that stand in your world. Everything works from menus you can
reshape in menus.yml.
2.0 "The Alliance Update" is a full rewrite:
- ranks and twelve per-member permissions;
- allies, enemies, ally chat and no ally damage;
- a team bank, team levels and a shared team chest;
- named homes with a title countdown;
- clickable invites, join requests and open teams;
- kills, leaderboards and floating top-teams boards;
- menus for everything, native dialogs, PlaceholderAPI with relational placeholders, LuckPerms contexts and
MariaDB/MySQL.
Each release is played by bots on 15 Paper and Folia servers from 1.20.1 to 26.3, including upgrades from 1.0.1.




/team opens one menu with everything: members, homes, the bank, the chest, allies and enemies, levels, the
leaderboard, team chat and settings. Players without a team get a menu to create one, see their invites, browse
every team or check the top teams.
- Every menu is in
menus.yml: titles, sizes, slots, items, names and lore, with pages for long lists.
- Commands exist for everything too, with tab completion:
/team invite, /team home, /team deposit 2.5k...
- On 1.21.7 and newer, names and amounts are typed in a native dialog instead of chat.


- Owner, Officer and Member.
/team promote and /team demote, or two clicks in the member menu.
- Twelve permissions: invite, kick, use homes, set homes, team chat, friendly fire, deposit, withdraw, chest,
diplomacy, settings and level up. Each rank has defaults in
config.yml; the owner can switch any of them for any
member.
- Members can kick, promote or demote ranks below their own, never above. Ownership changes with
/team transfer.


/team ally Sunfire asks; they accept with a clickable [Ally] button. /team enemy Ravens declares war, no
consent needed. /team neutral makes peace.
- Ally chat (
/ac) reaches your team and every ally.
- Allies can't hurt each other, unless both teams switch ally damage on. Teammates are protected the same way:
melee, arrows, tridents, pets and harmful potions.
- Relational placeholders colour teammates green, allies aqua and enemies red in your tab list and name tags.


- A team bank through Vault or VaultUnlocked:
/team deposit 2.5k, /team withdraw 1m, or preset and typed
amounts in the bank menu, with the latest moves and who made them.
- Levels bought from the bank: each one raises the member cap, the number of homes and the rows of the team chest.
Five by default, as many as you like.
- Teams can also cost money to create. When a team disbands, the owner gets the bank.


/team chest (or /team ec): one to six rows, set by the team level.
- On Paper several teammates can use it at once; on Folia, one at a time, so nothing is ever duplicated.
- Saved when it closes and every minute while open, in Paper's versioned item format, so items survive Minecraft
updates. Disbanding gives the items to the owner.


- Named homes:
/team sethome farm, /team home farm, and a homes menu. The team level sets how many.
- A countdown on a title and the action bar. Moving off your block or taking damage cancels it.
- Optional cooldown, sounds, particles, and worlds where team homes are off.



- Clickable invites: [Accept] and [Decline] right in chat, and an invites menu.
- Join requests:
/team request Nightbeam; officers get [Accept] and [Deny] buttons.
- Open teams:
/team open and anyone can /team join.
- Officers invite from a menu of online players' heads.


- Team chat and ally chat:
/tc and /ac with a message, as a toggle, or with an optional quick prefix (@hello).
- Teammates are told when members come online or leave, and see the team's message of the day when they join.
- Staff can read every team and ally chat with
/donutteams spy.


- Player kills and deaths count for the team (teammates and allies don't). KDR for every team.
/team top: the best teams by kills, bank, level or members.
- Boards in the world:
/donutteams board create spawn kills puts up a floating top-teams board that updates
itself, at the size you set. No hologram plugin needed.
- Leaderboards for your scoreboards and holograms:
%donutteams_top_kills_1_name%.


- Teams pick a colour, an icon (hold any item, banners look great), a tag, a description and a
message of the day.
- You set the rules: name length, blocked words, create cost, rank permissions, levels, home warmup and cooldown,
ally limits, the bank cap.
- Every message is MiniMessage (or
& codes) in messages.yml; every menu is in menus.yml; every sound is in
config.yml.


All of these are optional:
| Plugin |
What Donut Teams does with it |
| Vault (or VaultUnlocked) |
Team bank, levels, create cost |
| PlaceholderAPI |
40+ placeholders, leaderboards, and relational ones for tab and name tags |
| LuckPerms |
Contexts: donutteams:has-team, donutteams:role, donutteams:team |
| MariaDB or MySQL |
Storage instead of SQLite, with a table prefix |
| DonutCore |
Display names |
For developers: DonutTeamsApi (teams, members, ranks, relations) and eleven cancellable events, from
TeamCreateEvent to TeamRelationChangeEvent, TeamBankTransactionEvent and TeamHomeTeleportEvent.


Replace the jar and restart. Donut Teams upgrades your 1.x install when it starts:
- Teams, members, invites and homes are kept. The 1.x home is now called
home; friendly fire settings stay.
config.yml keeps your values (the old file is saved as config-1.x.yml).
messages.yml is replaced with the new messages (yours is saved as messages-1.x.yml).
- The 8-member cap of 1.x is gone: levels and
donutteams.slots.<n> set it now.


| Server |
Minecraft |
Java |
| Paper, Purpur and other Paper forks |
1.20.1 – 1.20.4 |
17 |
| Paper, Purpur and other Paper forks |
1.20.5 – 1.21.11 |
21 |
| Paper, Purpur and other Paper forks |
26.1 – 26.3 |
25 |
| Folia |
1.20.1 – 26.3 |
17 – 25 |
One jar for all of them. Native dialogs need 1.21.7 or newer; older servers ask in chat. Spigot and Bukkit are not
supported (they lack Paper's API): the plugin says so and stops.
Each release is played by bots on Paper 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.8, 1.21.11, 26.1.2, 26.2 and
26.3 and Folia 1.20.4, 1.21.4, 1.21.11 and 26.3, with SQLite and MariaDB: about 30 checks each, from creating a team
to disbanding it, including an upgrade from 1.0.1 and a restart. The console must stay free of errors.

| Command |
|
/team |
The team menu |
/team create [name] [tag] |
Start a team |
/team invite <player>, join <team>, request <team>, accept <player>, deny <player> |
Joining |
/team leave, kick, promote, demote, transfer <player>, disband |
Members |
/team chat [msg] (/tc), allychat [msg] (/ac) |
Chat |
/team home [name], sethome [name], delhome [name], homes |
Homes |
/team bank, deposit <amount>, withdraw <amount>, level [up], chest |
Bank, levels, chest |
/team ally <team>, enemy <team>, neutral <team>, relations |
Diplomacy |
/team pvp, allypvp, open, color, icon, tag, rename, description, motd |
Settings |
/team info [team], list, top [kills|balance|level|members] |
Info and leaderboards |
/donutteams reload|info|disband|join|kick|setowner|rename|bank|level|chest|spy|board|purge |
Staff |
| Permission |
Default |
|
donutteams.use, .create, .chat, .home |
everyone |
The player features |
donutteams.slots.<n> |
nobody |
The owner's team can have n members |
donutteams.bypass.cost, .cooldown |
op |
Free teams, no home cooldown |
donutteams.bypass.warmup, .friendlyfire |
nobody |
Instant homes, hurt teammates anyway |
donutteams.admin, donutteams.admin.spy |
op |
Staff commands, chat spy |

Does it need Vault? Just for the bank, levels that cost money, and a create cost. Everything else works without
it.
Folia? Yes, every feature. The team chest is used by one player at a time on Folia.
Can I change the menus? Every title, slot, item, name and lore line is in menus.yml. Set a slot to -1 to hide
an item.
How do I colour teammates in the tab list? Use %rel_donutteams_relation_color% in a tab or name tag plugin that
supports relational placeholders.
Several servers? Use one database per server. Teams shared across a network are NightTeams Pro's job.
Will my 1.x teams survive? Yes. They are upgraded when the new version starts; back up plugins/DonutTeams/ beforehand anyway.







Running a server? NightBeam's premium plugins are on BuiltByBit: NightWatch Pro anti-cheat, Elo ranked leaderboards and more.
More from NightBeam Studio
Follow: YouTube · Instagram · X · Facebook
评论 0
登录后参与评分
还没有评论,来抢沙发吧