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 静音功能。
QTeams
QTeams is a production-ready Paper/Purpur 1.21.11 team management, combat routing, and packet-level visual filtering plugin built for competitive tournaments, content creator SMPs, and large-scale scripted events. In Version 2.0, QTeams replaces legacy chest menus and ProtocolLib hooks with Mojang's Native Dialog UI (io.papermc.paper.dialog) and a Netty-level PacketEvents 2.7+ engine, delivering zero-lag block masking, real-time per-team tablist count buffers, 6-channel display/color spoofing, a 3-mode combat matrix, a Lobby Kick/Ban Stick, and customizable death sounds.
QWorlds & QKits Ecosystem Integration
QTeams 2.0 natively bridges with QWorlds (virtualized void lobbies & event control) and QKits (lossless kit distribution):
- Cross-Plugin Navigation Bar: Jump directly between
/qt, /qw, and /qk from the Native Dialog top bar.
- Lobby Team Admission: Admit individual
@teams or all teamed players waiting in the QWorlds Void Lobby directly into the active recording world via /qt admit <@team|all>.
- Unified
@team & @box Target Selectors: Use @<team>, @box (per-player Pos1/Pos2 selection wand), and fractional selectors (@red[50%], @box[1/2]) across /tp, /give, /effect, /gamemode, /qk give, and /qw.
Server Architecture & Core Mechanics
1. Native Dialog UI & Small-Caps Typography (New in 2.0)
- Zero-Chest Native Dialogs: Built on Paper 1.21.11's
DialogType.multiAction interface with custom small-caps typography (sc(...)), compact 280px layouts, 12x12 icons, interactive checkboxes (☑/☐), text inputs, and number sliders.
- 6-Tab Top Navigation Bar: Instant 1-click switching between
★ Teams, ⚔ PvP & God, ? PlayerView, ? Worlds & Messages, ? Death Sound, and ⚡ Kick/Ban Stick.
- Live Team Duplication & Renaming: Duplicate any team's full configuration (
/qt duplicate <@team>, auto-incrementing @red -> @red1) or rename teams live (/qt rename <@team> <new_name>) with automatic ally, rival, and scoreboard migration.
2. PacketEvents Tablist Buffers & Stealth Glow/Color Spoofing (Updated in 2.0)
- Per-Team Online Tablist Buffers: Injects real-time PacketEvents
PLAYER_INFO_UPDATE header rows (00_qb_<team>) sorted immediately above each team's roster (%03d_%s_0 above %03d_%s_1), displaying ✦ @TeamName (X online) based strictly on that specific team's online player count.
- Viewer-Specific Glow Filtering: Intercepts
ENTITY_METADATA packets on the Netty thread to dynamically toggle the 0x40 glowing flag per viewer (No One, Everyone, Teammates, Allies, Server OPs, or specific @teams).
- 6-Channel Display Matrix & Stealth Overhead Color: Independently toggle
[Team] prefixes and team colors across 6 channels: Nametag, Tablist, Chat, Killfeed, Join/Leave, and Commands (plus Color Chat Text and Nametag Visibility). Enabling Stealth Overhead Color spoofs TEAMS packets so only permitted glow viewers see a team's overhead color/tag while rivals see plain white names.
3. Netty Zero-Lag No-Leak Filter (Updated in 2.0)
- Packet-Level Chunk & Block Masking: Intercepts outgoing
CHUNK_DATA, BLOCK_CHANGE, and MULTI_BLOCK_CHANGE packets in PacketEvents to mask solid underground/base blocks as plain stone while preserving stair/slab/button/pressure-plate block states.
- Functional Block Exclusions: Automatically preserves ores, chests, shulker boxes, barrels, furnaces, anvils, crafters, beds, doors, glass, leaves, ladders, water/lava, and workstations.
- Staggered Radius Refresh & Mining Exposure: Toggling No-Leak refreshes loaded chunks smoothly without main-thread spikes, and breaking blocks immediately masks newly exposed adjacent faces.
4. 3-Mode Combat Matrix, PvP Exemptions & Immortality (Updated in 2.0)
- 3-Mode Relationship Matrix: Configure combat rules independently for Teammates, Allied Teams, and Specific Rival Teams using three modes:
NO_PVP — Cancels combat damage completely.
REDUCED — Allows hits and knockback while scaling damage by a configurable multiplier (10%, 25%, 50%, 75%).
NORMAL — Full vanilla PvP damage.
- 4-Tier PvP Exemptions (Per-Team & Per-Player):
DEFAULT — Follows standard Global & Team PvP rules.
GOD_ATTACKER — Can attack anyone (bypassing NO_PVP), but cannot be damaged by players.
FORCE_PVP — Can attack and be attacked by anyone, overriding NO_PVP.
PACIFIST — Cannot deal or receive any PvP damage.
- Immortality (
God Mode): Toggleable per team or per player (/qt immortal <@team|player>), clamping fatal damage so the player never drops below 0.5 hearts (1.0 HP).
5. Lobby Kick Stick (1s) & Timed Ban Stick (New in 2.0)
- Custom Admin Wand (
/qt kickstick): Hit or Right-Click any player to kick them back to the Lobby (1s default) or apply a timed Lobby Ban (30s, 1m, 5m, 10m, 30m, 1h, Perm).
- Quick Controls:
Shift + Right-Click Air cycles ban duration; Shift + Left-Click Air opens the Stick Settings & Active Bans Dialog.
6. Customizable Death Sound & World Message/Whisper Routing (New in 2.0)
- Death Sound Engine (
/qt deathsound): Play custom sounds on player deaths with 8 built-in presets (wither, thunder, bell, totem, warden, anvil, goat_horn, dragon), custom sound IDs, volume/pitch sliders (0.1–2.0), and audience routing (Same World, All Worlds, Killer & Victim Only, OPs Only).
- Full-Yellow Join/Leave/World Messages & Whisper Muting: Broadcasts clean, 100% yellow
joined/left the game and joined/left the world messages. Muting messages for a world in /qt joinleave also blocks /msg, /tell, /w, /whisper, /r, and /teammsg for non-OPs in that world.
7. Enhanced /tp Command & 2-Way PlayerView Culling
- Built-In
/tp & /teleport Router: Provides instant multi-argument tab-completion for online players, @a, @p, @r, @s, @box, @<team>, r (random non-OP player), QWorlds warps, and relative ~ coordinates.
- 2-Way PlayerView Exemptions: Separate
Target Exempt (always visible to others) and Viewer Exempt (sees all players regardless of distance/count caps) toggles for both teams and individual players.
Command & Permission Reference
All administrative commands require qteams.admin or Server Operator (OP) status.
Core & Team Management
/qt [gui] — Opens the Native QTeams Dialog Dashboard.
/qt create <name> [color] — Creates a new team with one of the 16 Minecraft colors.
/qt rename <@team> <new_name> — Renames an existing team and migrates all references.
/qt duplicate <@team> — Clones a team's settings into an auto-numbered copy (e.g., @red1).
/qt delete <@team> — Deletes a team and unregisters its scoreboard entries.
/qt add <player> <@team> / /qt remove <player> — Adds or removes a player from a team.
/qt clear <@team> — Clears all members from a team.
/qt list / /qt info <@team> — Lists active teams or inspects a team's full configuration.
Combat, Visuals, Audio & World Tools
/qt pvp [on|off|toggle] — Toggles Global PvP across recording worlds.
/qt pvp <@team> <teammates|allies|@rival> <NO_PVP|REDUCED|NORMAL> — Configures the 3-mode combat matrix.
/qt pvp exempt <@team|player> [DEFAULT|GOD_ATTACKER|FORCE_PVP|PACIFIST] — Sets PvP exemptions.
/qt immortal <@team|player> — Toggles God Mode immortality.
/qt ally <@team1> <@team2> — Toggles a mutual alliance between two teams.
/qt display <@team> [all|prefixes|colors|nametag|tablist|chat|killfeed|joinleave|commands|spoofcolor] — Configures the 6-channel display matrix.
/qt glow <@team> <on|off|color> / /qt color <@team> <color> — Updates team glow and color.
/qt noleak <@team> <on|off> / /qt voice <@team> <on|off> — Toggles No-Leak masking or Simple Voice Chat speaking.
/qt deathsound [gui|on|off|test|sound_key] [volume] [pitch] [audience] — Configures the death sound engine.
/qt kickstick [gui|give|time|unban|@team|player] [duration] — Manages the Lobby Kick/Ban Stick.
/qt admit <all|@team|gui> [world] — Admits teamed players from the Lobby into a recording world.
/qt joinleave / /qt gamemode <ops|recording|lobby|@team> [mode] — Configures world messages and auto-join gamemodes.
/qt pv <gui|toggle|dist|limit|renderdist|exempt|info> — Configures PlayerView culling and chunk caps.
/tp <target|@team|@box|r|x y z> [destination|warp|x y z] — Enhanced teleport command with full multi-argument tab-completion.
Server Requirements & Dependencies
- Server Software: Paper or Purpur 1.21.11.
- Java Runtime: Java 21.
- Dependencies:
packetevents-spigot (2.7.0+) — Required for Netty No-Leak block masking, per-viewer Glow/Stealth Color spoofing, and Tablist Team Buffers.
QWorlds (Optional) — Enables @box area selectors, warps, and Lobby admission.
QKits (Optional) — Enables @team and @box kit distribution.
Simple Voice Chat (Optional) — Enables per-team voicechat.speak muting.
评论 0
登录后参与评分
还没有评论,来抢沙发吧