QTeams - 脚本化工具

插件

原名 QTeams - Scripted Utils · 作者 CreoFlow

QTeams 2.0 是一款基于 Paper 1.21.11 的团队协作、战斗路线规划与 PacketEvents 可视化控制插件,具备原生对话框 UI、实时按队伍划分的标签页列表缓冲区、6 通道标签/隐身颜色伪装、3 模式 PvP 矩阵、自定义选择器以及防泄漏功能。

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

最新 2.0.0 · 26.3 · Paper / Purpur

一键开服(送7天)

QTeams

QTeams 是一款面向竞技锦标赛、内容创作者生存多人游戏(SMP)以及大规模脚本化事件的生产级 Paper/Purpur 1.21.11 团队管理、战斗路由和包级别视觉过滤插件。在 Version 2.0 中,QTeams 使用 Mojang 的原生对话框 UI (io.papermc.paper.dialog) 和 Netty 级别的 PacketEvents 2.7+ 引擎 取代了传统的箱子菜单和 ProtocolLib 挂钩,实现了零延迟方块掩蔽、实时每队标签页计数缓冲、6 通道显示/颜色欺骗、3 模式战斗矩阵、大厅踢出/禁言棒以及可自定义的死亡音效。


QWorlds & QKits 生态系统集成

QTeams 2.0 原生桥接 QWorlds(虚拟虚空大厅与事件控制)和 QKits(无损装备分发):

  • 跨插件导航栏: 从原生对话框顶栏直接跳转到 /qt、/qw 和 /qk。
  • 大厅团队准入: 通过 /qt admit <@team|all> 将等待在 QWorlds 虚空大厅中的单个 @teams 或所有组队玩家直接接纳到活跃录制世界中。
  • 统一的 @team 与 @box 目标选择器: 在 /tp、/give、/effect、/gamemode、/qk give 和 /qw 中使用 @<team>、@box(按玩家 Pos1/Pos2 选择魔杖)以及分数选择器(如 @red[50%]、@box[1/2])。

服务器架构与核心机制

1. 原生对话框 UI 与小大写字母排版(2.0 新增)

  • 零箱子原生对话框: 基于 Paper 1.21.11 的 DialogType.multiAction 接口构建,采用自定义小大写字母排版(sc(...))、紧凑的 280px 布局、12x12 图标、交互式复选框(☑/☐)、文本输入框和数字滑块。
  • 6 标签顶部导航栏: 一键即时切换 ★ Teams、⚔ PvP & God、? PlayerView、? Worlds & Messages、? Death Sound 和 ⚡ Kick/Ban Stick。
  • 实时团队复制与重命名: 复制任何团队的完整配置(/qt duplicate <@team>,自动递增 @red -> @red1)或实时重命名团队(/qt rename <@team> <new_name>),并自动迁移盟友、对手和记分板。

2. PacketEvents 标签页缓冲与隐身发光/颜色欺骗(2.0 更新)

  • 每队在线标签页缓冲: 注入实时的 PacketEvents PLAYER_INFO_UPDATE 标题行(00_qb_<team>),立即排序在每个团队名单(%03d_%s_0 位于 %03d_%s_1 上方)之上,严格根据该特定团队的在线玩家数量显示 ✦ @TeamName (X online)。
  • 查看者特定的发光过滤: 在 Netty 线程上拦截 ENTITY_METADATA 数据包,动态切换每个查看者的 0x40 发光标志(No One、Everyone、Teammates、Allies、Server OPs 或特定 @teams)。
  • 6 通道显示矩阵与隐身头顶颜色: 独立切换 [Team] 前缀和团队颜色,涵盖 6 个通道:Nametag、Tablist、Chat、Killfeed、Join/Leave 和 Commands(加上 Color Chat Text 和 Nametag Visibility)。启用 Stealth Overhead Color 会欺骗 TEAMS 数据包,使得只有允许的发光查看者能看到团队的头顶颜色/标签,而对手看到纯白色名称。

3. Netty 零延迟无泄漏过滤器(2.0 更新)

  • 包级别区块与方块掩蔽: 在 PacketEvents 中拦截发出的 CHUNK_DATA、BLOCK_CHANGE 和 MULTI_BLOCK_CHANGE 数据包,将实心地下/基础方块掩蔽为普通石头,同时保留楼梯/台阶/按钮/压力板等方块状态。
  • 功能性方块排除: 自动保留矿石、箱子、潜影盒、桶、熔炉、铁砧、锻造台、床、门、玻璃、树叶、梯子、水/岩浆和工作站。
  • 交错半径刷新与挖掘暴露: 切换 No-Leak 会平滑刷新已加载区块,避免主线程峰值;破坏方块会立即掩蔽新暴露的相邻面。

4. 3 模式战斗矩阵、PvP 豁免与不死性(2.0 更新)

  • 3 模式关系矩阵: 针对 Teammates、Allied Teams 和 Specific Rival Teams 独立配置战斗规则,使用三种模式:
    • NO_PVP — 完全取消战斗伤害。
    • REDUCED — 允许命中和击退,同时按可配置的倍数缩放伤害(10%、25%、50%、75%)。
    • NORMAL — 完整的原版 PvP 伤害。
  • 4 级 PvP 豁免(每队及每人):
    • DEFAULT — 遵循标准全局和团队 PvP 规则。
    • GOD_ATTACKER — 可以攻击任何人(绕过 NO_PVP),但不能受到玩家伤害。
    • FORCE_PVP — 可以攻击和被任何人攻击,覆盖 NO_PVP。
    • PACIFIST — 不能造成或接收任何 PvP 伤害。
  • 不死性(God Mode): 可按团队或玩家切换(/qt immortal <@team|player>),将致命伤害钳制在不低于 0.5 颗心(1.0 HP)。

5. 大厅踢出棒(1s)与定时禁言棒(2.0 新增)

  • 自定义管理员魔杖(/qt kickstick): 点击或右键点击任何玩家将其踢回大厅(默认 1s)或应用限时的大厅禁令(30s、1m、5m、10m、30m、1h、Perm)。
  • 快捷控制: Shift + 右键空气 循环切换禁令持续时间;Shift + 左键空气 打开魔杖设置与活跃禁令对话框。

6. 可自定义死亡音效与世界消息/私聊路由(2.0 新增)

  • 死亡音效引擎(/qt deathsound): 在玩家死亡时播放自定义声音,提供 8 种内置预设(wither、thunder、bell、totem、warden、anvil、goat_horn、dragon)、自定义声音 ID、音量/音调滑块(0.1–2.0)以及受众路由(Same World、All Worlds、Killer & Victim Only、OPs Only)。
  • 全黄色加入/离开/世界消息与私聊静音: 广播干净、100% 黄色的 joined/left the game 和 joined/left the world 消息。在 /qt joinleave 中静音某个世界的消息也会阻止非 OP 在该世界中发送 /msg、/tell、/w、/whisper、/r 和 /teammsg。

7. 增强的 /tp 指令与双向玩家视图剔除

  • 内置 /tp & /teleport 路由器: 为在线玩家、@a、@p、@r、@s、@box、@<team>、随机非 OP 玩家 r(注:原文为 r,通常指 random)、QWorlds 传送点以及相对坐标 ~ 提供即时的多参数 Tab 补全功能。
  • 双向玩家视图豁免: 为队伍和单个玩家分别提供“目标豁免”(始终对其他人可见)和“查看者豁免”(无视距离/数量上限,能看到所有玩家)的切换选项。

指令与权限参考

所有管理指令均需具备 qteams.admin 权限或服务器管理员(OP)状态。

核心与队伍管理

  • /qt [gui] — 打开原生 QTeams 对话框仪表板。
  • /qt create <name> [color] — 使用 16 种 Minecraft 颜色之一创建新队伍。
  • /qt rename <@team> <new_name> — 重命名现有队伍并迁移所有相关引用。
  • /qt duplicate <@team> — 将队伍设置克隆为自动编号的副本(例如 @red1)。
  • /qt delete <@team> — 删除队伍并注销其记分板条目。
  • /qt add <player> <@team> / /qt remove <player> — 将玩家添加或移除出队伍。
  • /qt clear <@team> — 清空队伍中的所有成员。
  • /qt list / /qt info <@team> — 列出活跃队伍或检查队伍的完整配置。

战斗、视觉、音频与世界工具

  • /qt pvp [on|off|toggle] — 在录制世界中切换全局 PvP。
  • /qt pvp <@team> <teammates|allies|@rival> <NO_PVP|REDUCED|NORMAL> — 配置三模式战斗矩阵。
  • /qt pvp exempt <@team|player> [DEFAULT|GOD_ATTACKER|FORCE_PVP|PACIFIST] — 设置 PvP 豁免规则。
  • /qt immortal <@team|player> — 切换上帝模式无敌状态。
  • /qt ally <@team1> <@team2> — 在两支队伍之间切换相互结盟状态。
  • /qt display <@team> [all|prefixes|colors|nametag|tablist|chat|killfeed|joinleave|commands|spoofcolor] — 配置六通道显示矩阵。
  • /qt glow <@team> <on|off|color> / /qt color <@team> <color> — 更新队伍发光效果和颜色。
  • /qt noleak <@team> <on|off> / /qt voice <@team> <on|off> — 切换无泄漏屏蔽或 Simple Voice Chat 说话功能。
  • /qt deathsound [gui|on|off|test|sound_key] [volume] [pitch] [audience] — 配置死亡音效引擎。
  • /qt kickstick [gui|give|time|unban|@team|player] [duration] — 管理大厅踢人/封禁棒。
  • /qt admit <all|@team|gui> [world] — 将被编队的玩家从大厅接入录制世界。
  • /qt joinleave / /qt gamemode <ops|recording|lobby|@team> [mode] — 配置世界消息和自动加入的游戏模式。
  • /qt pv <gui|toggle|dist|limit|renderdist|exempt|info> — 配置玩家视图剔除和区块上限。
  • /tp <target|@team|@box|r|x y z> [destination|warp|x y z] — 带有完整多参数 Tab 补全功能的增强型传送指令。

服务器要求与依赖项

  • 服务器软件: Paper 或 Purpur 1.21.11。
  • Java 运行时: Java 21。
  • 依赖项:
    • packetevents-spigot (2.7.0+) — 必需,用于 Netty 无泄漏区块屏蔽、按查看者的发光/潜行颜色欺骗以及标签页队伍缓冲区。
    • QWorlds (可选) — 启用 @box 区域选择器、传送点和大厅接入功能。
    • QKits (可选) — 启用 @team 和 @box 装备分发功能。
    • Simple Voice Chat (可选) — 启用按队伍的 voicechat.speak 静音功能。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源