Team-HomeGUI-Plugin
? English
版本: 1.4.0 | API: Paper 26.1 – 26.3 (Java 25) | 作者: Duong2012G
一款适用于 Paper 服务器的团队系统,包含 GUI 家园管理器:支持拥有角色的团队、团队聊天、团队家园、最多 5 个可通过物品栏菜单管理的个人家园、冷却时间与预热时间、可选的 Vault 收费功能、PlaceholderAPI 占位符以及 EssentialsX 的 /home 命令覆盖。
特性
| 分类 |
功能 |
| 队伍 |
创建、邀请(接受/拒绝)、离开、踢出、解散、重命名、设置颜色、列表、信息 |
| 角色 |
所有者 / 管理员 / 成员。所有者和管理员可邀请和踢出成员,设置队伍出生点并更改设置;只有所有者能踢出或降级管理员、转移所有权或解散队伍。可以踢出、提升、降级离线成员,并授予其所有权。 |
| 队伍聊天 | /team chat enable\|disable(你所有的消息都会发送给队伍)和 /team msg <文本>;全局聊天中可选的 [队伍] 前缀。聊天文本的颜色不会被翻译。 |
| 队伍家园 | /team sethome(仅限拥有者 / 管理员)和 /team home,或者通过 GUI 中的横幅设置。 |
| 个人家园 | GUI 中最多可设置 5 个(可通过名称自定义更多,使用 /sethome <name>);上限由 default-max-homes 配置项及 teamplugin.homes.<n> 权限决定 |
| 家园 GUI | 床图标用于传送,青/红色染料分别用于设置/删除家园;删除前会显示确认菜单;所有物品栏均锁定,禁止点击和拖拽操作 |
| 安全的数据 | 坐标会与世界的主键和名称一起存储,并在你传送时才解析,因此即使世界未加载,家也不会丢失。文件会在后台线程中以原子方式写入。 |
| 冷却与预热 | 每位玩家独立的冷却时间;包含动作栏倒计时,可选冻结功能,移动/传送/死亡时取消。已取消的预热不消耗任何资源。 |
| 经济系统 | Vault 会对设置出生点、传送、创建队伍以及设置队伍出生点进行收费(默认全部关闭) |
| 友军伤害 | 阻止来自所有来源的队友间伤害:近战、箭矢、三叉戟、药水、TNT。你仍然可以对自己造成伤害。 |
| PlaceholderAPI | %team_*% 占位符 |
| EssentialsX | /home、/sethome 和 /delhome(以及 /essentials:home 等)始终调用此插件 |
| 管理工具 | /team admin ...,适用于拥有 teamplugin.admin 权限的用户,并包含一个管理员封禁列表 |
依赖要求
| 依赖项 |
是否必需 |
Paper 26.3(基于 26.3 API 编译;api-version: 26.1,因此 26.1 / 26.2 可能加载它,但仅针对 26.3 进行了目标适配) |
✅ |
| Java 25 |
✅ |
| Vault + 一个经济插件 |
可选(收费功能) |
| PlaceholderAPI |
可选 |
| EssentialsX |
可选(用于覆盖 /home 命令) |
运行在 1.21.x 的服务端必须保持在 1.3.3 版本。仅限 Paper API(不支持 Spigot);未声明支持 Folia。
安装
- 将
teamhomegui-1.4.0.jar 放入 plugins/ 目录。
- 启动服务器;系统将创建
plugins/Team-HomeGUI-Plugin/team-config.yml 和 home-config.yml。
- 编辑这两个文件并使用
/team reload 应用更改(无需重启服务器;但修改管理员团队名称需要重启)。
从 1.3.x 版本升级:请参阅下方的数据与升级部分。
命令
玩家
| 命令 |
描述 |
/team create <name> |
创建团队(3–16 个字母、数字或下划线) |
/team invite <player> |
邀请一名玩家(所有者、管理员以及允许的成员) |
/team invite accept / deny |
接受或拒绝收到的邀请(60 秒后过期) |
/team leave |
离开团队;所有者必须在 30 秒内再次输入此命令以解散团队 |
/team kick <player> |
踢出成员(仅限所有者或管理员执行;只有所有者能踢出管理员) |
/team info [team], /team members [team], /team list [page] |
查看团队信息 |
/team sethome |
设置团队出生点(仅限所有者或管理员) |
/team home |
传送至团队出生点 |
/team menu |
打开出生点 GUI |
/team chat enable|disable |
启用或禁用团队聊天功能 |
/team msg <message> |
发送一条团队消息 |
/team color <color> |
更改团队颜色(仅限所有者) |
/team settings name <name> |
重命名团队 |
/team settings color <color> |
更改颜色 |
/team settings members-can-invite <on|off> |
允许成员进行邀请 |
/team settings promote <player> / demote <player> |
提拔/降级为管理员(降级操作仅限所有者执行) |
/team settings transfer <player> |
将团队所有权转让给另一名成员(仅限所有者) |
/home · /sethome |
打开出生点 GUI |
/home <name> · /sethome <name> · /delhome <name> |
按名称传送至/设置/删除一个出生点 |
别名:使用 /t 代替 /team。
服务器管理员 (teamplugin.admin)
| 命令 |
描述 |
/team admin create |
创建管理员团队(名称格式为 admin.team-name,默认为 Admin) |
/team admin add <player> |
将玩家移入管理员团队(若该玩家拥有其他团队则无法操作) |
/team admin ban <player> / unban <player> |
禁止/允许使用管理员命令(操作员/OP 无法被禁止) |
/team admin manage <team> |
显示某个团队的详细信息 |
/team admin remove <team> |
解散一个团队(不能解散管理员团队) |
/team admin list [page] |
列出所有团队 |
/team admin settings <team> <option> [value] |
更改任意团队的名称、颜色、邀请规则或角色权限 |
/team reload 或 /team admin reload |
重新加载两个配置文件(控制台可使用 /team reload) |
权限
| 权限 |
描述 |
默认值 |
teamplugin.admin |
/team admin ... 和 /team reload |
op |
teamplugin.homes.<n> |
允许设置 <n> 个个人出生点(取最高值;teamplugin.homes.3/4/5 已声明) |
false |
teamplugin.home.nocooldown |
跳过传送至出生点的冷却时间 |
op |
teamplugin.team.nocooldown |
跳过团队出生点的冷却时间 |
op |
teamplugin.player |
为兼容性而声明;该命令不需要此权限 |
true |
所有其他命令对所有人可用。
出生点 GUI
第 1 行:[ ][ ][ ][ ][T][ ][ ][ ][ ] T = 团队基地(旗帜)
第 2 行:[ ][ ][1][2][3][4][5][ ][ ] 个人基地(床图标)
第 3 行:[ ][ ][S][S][S][S][S][ ][ ] S = 为上方基地设置(青染)/ 删除(红染)
第 4 行:填充物
第 5 行:填充物
(确切槽位为 4、11–15 和 20–24;菜单默认有 5 行,gui.rows 接受 3–6。)
删除确认界面在 3 行菜单的中间一行包含红色的 No、床以及绿色的 Yes。
配置
两个文件均为纯 YAML 格式;缺失的键将回退到 jar 包中捆绑的默认值。
home-config.yml
| 键 |
默认值 |
描述 |
default-max-homes |
5 |
每个人可以拥有的基地数量(通过 teamplugin.homes.<n> 提升) |
gui.title, gui.rows, gui.filler-material, gui.show-coordinates |
&0Home &8- &0Menu, 5, GRAY_STAINED_GLASS_PANE, false |
菜单外观 |
teleport.cooldown |
3 |
传送间隔秒数(从你开始传送时计时) |
teleport.warmup |
5 |
倒数秒数(0 = 立即) |
teleport.freeze-on-warmup |
true |
在充能期间将玩家固定在原地 |
teleport.cancel-on-move |
true |
移动时取消(冻结状态下:跳跃或下落时) |
features.personal-homes, features.team-homes, features.sounds |
true |
关闭某项功能 |
disabled-worlds |
world_nether, world_the_end |
无法设置或使用基地的世界(名称或标识符) |
economy.enabled, economy.sethome-cost, economy.teleport-cost |
false, 100, 0 |
Vault 收费 |
messages.* |
|
所有基地消息 |
team-config.yml
| 键 |
默认值 |
描述 |
admin.team-name |
Admin |
管理员团队的名称 |
settings.min-team-name-length / max-team-name-length |
3 / 16 |
名称长度限制 |
settings.max-members |
20 |
每个团队的成员上限 |
settings.invite-timeout-seconds |
60 |
邀请持续时长 |
settings.chat-format, settings.global-format |
见文件 |
聊天布局({team} {player} {message}) |
features.team-chat, features.global-chat-prefix, features.team-homes |
true |
关闭某项功能 |
features.friendly-fire |
false |
true 允许友军伤害 |
damage.disable-pvp-between-members |
true |
当此值为 true 且 features.friendly-fire 为 false 时,阻止成员间的 PVP |
creation.default-invite-only, creation.default-members-can-invite |
true, false |
新团队的设置 |
teleport.cooldown |
3 |
团队基地传送冷却时间 |
economy.enabled, economy.create-cost, economy.sethome-cost |
false, 500, 100 |
Vault 收费(团队基地传送使用 home-config.yml 中的 teleport-cost) |
disabled-worlds |
[] |
额外不可用团队基地的世界 |
messages.* |
|
所有团队消息(& 颜色代码、&#rrggbb 十六进制颜色代码、{占位符}) |
如果启用了收费但不存在 Vault 经济系统,则不会对任何人收费,并记录一次警告。
PlaceholderAPI
| 占位符 |
返回值 |
%team_name%, %team_colored_name%, %team_color% |
团队名称、着色名称、颜色代码 |
%team_role% |
所有者 / 管理员 / 成员 |
%team_count%, %team_owner% |
成员数量、所有者名称 |
%team_has_team%, %team_is_owner%, %team_is_admin% |
yes / no |
%team_has_home%, %team_home_world%, %team_home_x% / _y / _z |
团队基地信息(世界以名称给出,即使未加载) |
%team_homes_count%, %team_homes_max%, %team_homes_list%, %team_has_homes% |
个人基地 |
数据与升级
- 数据存储在
homes.yml 和 teams.yml 中。从 1.4.0 版本起,位置存储为 world-key、world、x、y、z、yaw、pitch。
- 从 1.3.x 版本: 首次启动时旧文件会被转换。原始文件首先被复制到
homes.yml.legacy-backup / teams.yml.legacy-backup。此时未加载的世界中的位置保留在备份文件中,并会在世界加载时自动导入;随后备份文件重命名为 *.legacy-imported-<time>。
- 由 1.4.0 转换的文件 无法被 1.3.3 或更早版本读取。如果需要回退,请保留备份。
- 无法解析的数据文件会被复制到
*.corrupted-<time> 而不是作为空文件加载。
已知限制
- 每位玩家只有一个充能过程:在充能期间发起第二次传送请求将被拒绝。
- 不支持 Folia(该插件使用常规的 Bukkit 调度器)。
- Vault 和 PlaceholderAPI 是可选集成,基于其公共 API 构建;请在你的服务器版本上测试它们。
- Paper 插件通常不支持
/reload;请使用 /team reload 重载配置。
更新日志
请参阅 CHANGELOG.md。
Team-HomeGUI-Plugin
? English
Version: 1.4.0 | API: Paper 26.1 – 26.3 (Java 25) | Author: Duong2012G
A team system with a GUI home manager for Paper servers: teams with roles, team chat, a team home, up to 5
personal homes in an inventory menu, cooldowns and warmups, optional Vault charges, PlaceholderAPI placeholders and an
EssentialsX override for /home.
Features
| Category |
Feature |
| Teams |
Create, invite (accept / deny), leave, kick, disband, rename, colour, list, info |
| Roles |
Owner / Admin / Member. Owners and admins invite, kick members, set the team home and change settings; only the owner can kick or demote an admin, transfer ownership or disband. Offline members can be kicked, promoted, demoted and given ownership. |
| Team chat |
/team chat enable|disable (all your messages go to the team) and /team msg <text>; an optional [team] prefix in global chat. Chat text is never colour-translated. |
| Team home |
/team sethome (owner / admin) and /team home or the banner in the GUI |
| Personal homes |
Up to 5 in the GUI (more by name, with /sethome <name>); the limit comes from default-max-homes and teamplugin.homes.<n> permissions |
| Home GUI |
Bed icons to teleport, lime / red dye to set / delete, a confirmation menu before deleting; all inventories are locked against clicks and drags |
| Safe data |
Positions are stored with the world's key and name and resolved only when you teleport, so a home is never lost because its world is not loaded. Files are written atomically on a background thread. |
| Cooldown & warmup |
Cooldown per player; a warmup with an action-bar countdown, optional freeze, cancel on move / teleport / death. A cancelled warmup costs nothing. |
| Economy |
Vault charges for setting a home, teleporting, creating a team and setting the team home (all off by default) |
| Friendly fire |
Blocks damage between team members from every source: melee, arrows, tridents, potions, TNT. You can still hurt yourself. |
| PlaceholderAPI |
%team_*% placeholders |
| EssentialsX |
/home, /sethome and /delhome (also as /essentials:home ...) always reach this plugin |
| Admin tools |
/team admin ... for people with teamplugin.admin, with an admin ban list |
Requirements
| Dependency |
Required |
Paper 26.3 (compiled against the 26.3 API; api-version: 26.1, so 26.1 / 26.2 may load it, only 26.3 was targeted) |
✅ |
| Java 25 |
✅ |
| Vault + an economy plugin |
Optional (charges) |
| PlaceholderAPI |
Optional |
| EssentialsX |
Optional (the /home override) |
Servers on 1.21.x must stay on 1.3.3. Paper API only (no Spigot); Folia is not declared supported.
Installation
- Put
teamhomegui-1.4.0.jar into plugins/.
- Start the server;
plugins/Team-HomeGUI-Plugin/team-config.yml and home-config.yml are created.
- Edit them and apply with
/team reload (no restart needed; the admin team name needs a restart).
Upgrading from 1.3.x: see Data and upgrading below.
Commands
Players
| Command |
Description |
/team create <name> |
Create a team (3–16 letters, digits, underscores) |
/team invite <player> |
Invite a player (owner, admins, and members if allowed) |
/team invite accept / deny |
Answer the invite you received (expires after 60 s) |
/team leave |
Leave; the owner must repeat it within 30 s to disband the team |
/team kick <player> |
Kick a member (owner or admin; only the owner can kick an admin) |
/team info [team], /team members [team], /team list [page] |
Look at teams |
/team sethome |
Set the team home (owner / admin) |
/team home |
Teleport to the team home |
/team menu |
Open the home GUI |
/team chat enable|disable |
Send everything to team chat, or stop |
/team msg <message> |
One team message |
/team color <color> |
Change the team colour (owner) |
/team settings name <name> |
Rename the team |
/team settings color <color> |
Change the colour |
/team settings members-can-invite <on|off> |
Let members invite |
/team settings promote <player> / demote <player> |
Make / remove an admin (demote: owner only) |
/team settings transfer <player> |
Give the team to another member (owner) |
/home · /sethome |
Open the home GUI |
/home <name> · /sethome <name> · /delhome <name> |
Teleport to / set / delete a home by name |
Alias: /t for /team.
Server admins (teamplugin.admin)
| Command |
Description |
/team admin create |
Create the admin team (name: admin.team-name, default Admin) |
/team admin add <player> |
Move a player into the admin team (not possible while they own another team) |
/team admin ban <player> / unban <player> |
Ban from / allow the admin commands (operators cannot be banned) |
/team admin manage <team> |
Show a team's details |
/team admin remove <team> |
Disband a team (not the admin team) |
/team admin list [page] |
List all teams |
/team admin settings <team> <option> [value] |
Change any team's name, colour, invite rule or roles |
/team reload or /team admin reload |
Reload both config files (the console can use /team reload) |
Permissions
| Permission |
Description |
Default |
teamplugin.admin |
/team admin ... and /team reload |
op |
teamplugin.homes.<n> |
Allows <n> personal homes (the highest wins; teamplugin.homes.3/4/5 are declared) |
false |
teamplugin.home.nocooldown |
Skip the home teleport cooldown |
op |
teamplugin.team.nocooldown |
Skip the team home cooldown |
op |
teamplugin.player |
Declared for compatibility; the commands do not require it |
true |
All other commands are available to everybody.
Home GUI
Row 1: [ ][ ][ ][ ][T][ ][ ][ ][ ] T = Team home (banner)
Row 2: [ ][ ][1][2][3][4][5][ ][ ] personal homes (bed icons)
Row 3: [ ][ ][S][S][S][S][S][ ][ ] S = set (lime dye) / delete (red dye) for the home above
Row 4: filler
Row 5: filler
(The exact slots are 4, 11–15 and 20–24; the menu has 5 rows by default, gui.rows accepts 3–6.)
The delete confirmation has a red No, the bed, and a green Yes in the middle row of a 3-row menu.
Configuration
Both files are plain YAML; keys that are missing fall back to the defaults bundled in the jar.
home-config.yml
| Key |
Default |
Description |
default-max-homes |
5 |
Homes everybody may have (raised by teamplugin.homes.<n>) |
gui.title, gui.rows, gui.filler-material, gui.show-coordinates |
&0Home &8- &0Menu, 5, GRAY_STAINED_GLASS_PANE, false |
Look of the menu |
teleport.cooldown |
3 |
Seconds between teleports (starts when you teleport) |
teleport.warmup |
5 |
Countdown in seconds (0 = instant) |
teleport.freeze-on-warmup |
true |
Hold the player in place during the warmup |
teleport.cancel-on-move |
true |
Cancel on movement (when frozen: on jumping or falling) |
features.personal-homes, features.team-homes, features.sounds |
true |
Switch a feature off |
disabled-worlds |
world_nether, world_the_end |
Worlds (name or key) where homes cannot be set or used |
economy.enabled, economy.sethome-cost, economy.teleport-cost |
false, 100, 0 |
Vault charges |
messages.* |
|
All home messages |
team-config.yml
| Key |
Default |
Description |
admin.team-name |
Admin |
Name of the admin team |
settings.min-team-name-length / max-team-name-length |
3 / 16 |
Name length |
settings.max-members |
20 |
Members per team |
settings.invite-timeout-seconds |
60 |
How long an invite lasts |
settings.chat-format, settings.global-format |
see file |
Chat layouts ({team} {player} {message}) |
features.team-chat, features.global-chat-prefix, features.team-homes |
true |
Switch a feature off |
features.friendly-fire |
false |
true allows friendly fire |
damage.disable-pvp-between-members |
true |
Friendly fire is blocked when this is true and features.friendly-fire is false |
creation.default-invite-only, creation.default-members-can-invite |
true, false |
Settings of new teams |
teleport.cooldown |
3 |
Team home cooldown |
economy.enabled, economy.create-cost, economy.sethome-cost |
false, 500, 100 |
Vault charges (a team home teleport uses home-config.yml's teleport-cost) |
disabled-worlds |
[] |
Extra worlds where the team home is unavailable |
messages.* |
|
All team messages (& colours, &#rrggbb hex colours, {placeholders}) |
If charging is enabled but no Vault economy exists, nobody is charged and a warning is logged once.
PlaceholderAPI
| Placeholder |
Returns |
%team_name%, %team_colored_name%, %team_color% |
Team name, coloured name, colour code |
%team_role% |
Owner / Admin / Member |
%team_count%, %team_owner% |
Member count, owner name |
%team_has_team%, %team_is_owner%, %team_is_admin% |
yes / no |
%team_has_home%, %team_home_world%, %team_home_x% / _y / _z |
Team home information (the world is given by name, even if not loaded) |
%team_homes_count%, %team_homes_max%, %team_homes_list%, %team_has_homes% |
Personal homes |
Data and upgrading
- Data lives in
homes.yml and teams.yml. From 1.4.0 positions are stored as world-key, world, x, y, z, yaw, pitch.
- From 1.3.x: on first start the old files are converted. The original file is first copied to
homes.yml.legacy-backup / teams.yml.legacy-backup. Positions in worlds that are not loaded at that moment stay in the backup
and are imported automatically as soon as the world loads; then the backup is renamed *.legacy-imported-<time>.
- Files converted by 1.4.0 cannot be read by 1.3.3 or older. Keep the backups if you might go back.
- A data file that cannot be parsed is copied to
*.corrupted-<time> instead of being loaded as empty.
Known limitations
- One warmup per player: a second teleport request during a warmup is refused.
- Folia is not supported (the plugin uses the regular Bukkit scheduler).
- Vault and PlaceholderAPI are optional integrations that were built against their public APIs; test them on your server version.
/reload is not supported by Paper plugins in general; use /team reload for the configs.
Changelog
See CHANGELOG.md.
评论 0
登录后参与评分
还没有评论,来抢沙发吧