Team-HomeGUI Plugin

插件

· 作者 Duong2012G

一个轻量级的团队系统,包含团队家园、私人团队聊天、个人家园以及简洁的家园图形界面

0 本站下载 0 关注 更新于 1 周前

最新 1.4.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

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。

安装

  1. 将 teamhomegui-1.4.0.jar 放入 plugins/ 目录。
  2. 启动服务器;系统将创建 plugins/Team-HomeGUI-Plugin/team-config.yml 和 home-config.yml。
  3. 编辑这两个文件并使用 /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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源