QWorlds
Paper / Purpur 1.21.11 · Java 21 · 原生对话框 UI (io.papermc.paper.dialog)
虚拟化虚空大厅网格、匹配队列以及实时脚本化事件编排。
QWorlds 是一款面向竞技锦标赛、内容创作者 SMP 服务器以及大规模录制会话的生产就绪型大厅管理、匹配队列和脚本化事件控制插件。它通过将个人玩家枢纽整合到单个虚拟化虚空网格世界(qwlobby_hub)中,消除了多代理大厅的开销,同时为操作员提供了一套完整的实时事件编排工具。
[!IMPORTANT]
3.0 版本新增功能:
QWorlds 3.0 引入了 Mojang 的原生对话框 UI、带有客户端粒子轮廓的每位玩家 @box 选择法杖、冻结法杖、百分比队伍分割器(/qw split)、操作员传送点、世界聊天与私聊(/msg)屏蔽、近距离聊天、分数目标选择器(@team[50%], @box[1/2]),以及第 4 个古代大厅遗迹(FlightCharge)。
? QTeams & QKits 生态系统集成
QWorlds 3.0 构成了 QWorlds + QTeams + QKits 事件堆栈的核心:
| 功能 |
生态系统行为 |
| 跨插件对话框栏 |
从原生对话框顶部导航栏直接跳转到 /qw、/qt 和 /qk。 |
| 自动组队队列小队 |
配置开放世界队列(/qw open <world> [limit] [@team]),以便在玩家进入时自动将其分配到目标 QTeams 小队。 |
| 百分比队伍分割器 |
将来自 @box、lobby、@a 或现有 @team 的玩家按精确百分比/权重分割到多个 QTeams 队伍中(例如 royal:50 corrupt:30 chicken:20),并可选择将每个玩家传送到其队伍的出生点。 |
| 通用与分数选择器 |
在 /tp、/give、/effect、/gamemode、/qk give 和 /qw 中使用 @box、@<team> 和分数修饰符(@box[50%]、@red[1/2]、@a[25%]、@box[r])。 |
⚙️ 服务器架构与核心机制
1. 原生 Paper 1.21.11 对话框 UI 与 6 标签控制器
- 零箱子原生对话框: 基于 Paper 1.21.11 的
DialogType.multiAction API 构建,采用自定义小型大写字母排版、紧凑的 280px 布局、12x12 图标、交互式复选框(☑ / ☐)和文本输入框。
- 6 标签顶部导航栏: 一键即时切换所有管理模块:
? Worlds — 管理录制世界、队列配额、自动队伍以及各世界的死亡模式。
⚡ Warps & Split — 管理操作员传送点、@box 法杖以及百分比队伍分割器。
❄ Freeze & Chat — 控制冻结法杖、世界聊天/私聊屏蔽、队伍隔离以及近距离聊天。
? Relics — 配置和分发 4 个大厅遗迹及基座。
? Pool — 监控和预生成虚拟化虚空大厅槽位。
? Players — 检查在线玩家、传送到个人大厅槽位或管理大厅封禁。
2. 事件控制套件:每位玩家 @box 法杖、队伍分割器与传送点
- 每位玩家
@box 区域选择法杖(/qw boxwand): 给操作员一把附魔的风暴之棒。左键点击方块设置 Pos 1,右键点击方块设置 Pos 2。每位操作员都有独立的 @box 选择渲染,显示为客户端青色尘埃粒子轮廓(大厅模板法杖为金色尘埃轮廓),仅对该操作员可见。
- 通用与分数选择器引擎: 挂钩 Paper 的
AsyncPlayerSendCommandsEvent 和 AsyncPlayerSendSuggestionsEvent,使 /tp、/give、/effect、/clear、/gamemode 和 /qk 在一个统一列表中建议在线玩家名称以及 @a、@p、@r、@s、@box、@<team> 和传送点——并在 @box 或 @team 之后继续提示后续参数。
- 百分比队伍分割器(
/qw split): 随机打乱源组(@box、lobby、@a 或 @<team>),并使用最大余数法将玩家分配到目标队伍,确保 100% 的玩家被干净地分配。自动在 QTeams 中创建缺失的队伍,并根据配置将每个玩家传送到其队伍匹配的传送点。
- 操作员传送点(
/qw setwarp、/qw warp、/qw delwarp): 保存命名的事件传送点,并通过 GUI、/qw warp <name> [target] 或 /tp <target> <warp> 将自己、单个玩家、@box 或任何 @team(包括分数选择器)传送到该位置。
3. 玩家冻结引擎、冻结法杖与世界聊天/私聊过滤器
- 冻结法杖(
/qw freezewand)与 /qw freeze: 给操作员一把定制的蓝冰法杖。击中或右键点击玩家以切换其冻结状态,或Shift + 右键点击空气以冻结你 @box 内的所有人。被冻结的玩家移动、跳跃、战斗、破坏/放置方块、丢弃物品、点击物品栏以及执行命令都被锁定,同时看到实时的 ❄ 你已被操作员冻结 ❄ 操作栏警报。
- 世界聊天静音与私聊(
/msg)阻止: 在 ❄ Freeze & Chat 标签页中按世界静音文本聊天。当某个世界的聊天或消息被静音(或当玩家处于虚空大厅时),非 OP 玩家的私人耳语(/msg、/tell、/w、/whisper、/r、/reply、/teammsg)将被自动阻止。
- 仅限队伍隔离、允许聊天的队伍与近距离聊天: 限制全局聊天,使只有特定的
@teams 可以说话;隔离聊天,使玩家只能听到队友的声音;或启用近距离聊天(半径 15m、30m、50m、100m)并支持可切换的 OP 聊天间谍功能。
4. 虚拟化虚空网格 (qwlobby_hub) & 碰撞安全的虚空救援
- 网格区块分配: 将
qwlobby_hub 划分为 10 列的网格,在 Y=64 处设置 256 区块的偏移量,强制实施隔离的 5 区块视距和模拟距离,使得处于个人大厅中的玩家无法在标签页列表中看到彼此、听到彼此的聊天消息或加载外部实体。
- 交错式预生成池 (
/qw pregen): 使用区块票证异步预生成并缓存大厅槽位,同时显示实时的 OP 进度条。
- 三次贝塞尔曲线虚空救援弧线: 当掉落至
Y=44 以下时,会启动一条平滑的三次贝塞尔飞行曲线,水平方向扫过模板的包围盒,并在升至最高屋顶方块上方 26 格后,落在该槽位的出生点。
5. 四大古代大厅遗物 (relics.yml) & 蝙蝠小游戏
| 遗物 ID |
默认名称 |
机制与亮点 |
bow |
ParrotX2 之弓 |
无限弹药的大厅爆炸弓,对方块/实体零伤害,支持蝙蝠小游戏命中判定,并在第 17 格栏位设有防复制锁定的箭袋充能。 |
trident |
Treasure Trident |
忠诚 V 三叉戟,具备即时虚空召回检测,长距离投掷期间保持区块加载,命中时带有装饰性闪电特效。 |
cannon |
Orbital Strike Cannon |
自定义钓鱼竿(3 秒冷却),召唤 3 圈同心落下的 TNT 火球(6、10 和 14 个实体加上中心打击),对方块零伤害。 |
flightcharge |
FlightCharge (新增) |
无限风之符文遗物。在半空中且面朝正下方(俯仰角 >= 70°)时右键点击,可触发空中连段加速,伴有阵风粒子效果和风声音频。 |
- 神器完成电影效果: 集齐三叉戟和大炮会在整个槽位范围内触发周界闪电序列、山羊号角音效提示以及 Toast 横幅通知。
- 视线阻挡蝙蝠小游戏: 为每个活跃的大厅槽位生成 6 只经光线追踪处理的蝙蝠,其高度限制在玩家眼睛下方(
Y+0.2 至 Y+1.55)。达成 10 连击连续命中后,该槽位内的所有蝙蝠将依次引爆。
6. 定向信息全息图 (info_signs.yml) & 自定义 NPC (custom_npcs.yml)
- 无实体告示牌的全息图与网页链接: 放置在大厅模板内的物理告示牌充当坐标和旋转锚点。当粘贴大厅槽位时,物理告示牌方块会被清除(
Material.AIR),替换为与偏航角对齐的 TextDisplay 全息图(Billboard.FIXED),并附带不可见的 Interaction 碰撞箱。注视全息图可显示文本内容,右键点击则会在聊天栏发送一个可点击的 open_url 链接。
- 基于反射的 FancyNpcs 集成: 通过反射机制生成队列 NPC(
/qw spawnnpc)和自定义档案 NPC(/qw spawnplayer),无需任何硬编译依赖。
7. 5 种模式玩家死亡路由 & 自动队伍剥离
配置全局或按录制世界设定,以处理事件期间的玩家死亡行为:
| 模式 ID |
GUI 标签 |
玩家死亡时的行为 |
NOTHING |
不做任何操作 |
玩家在录制世界中正常重生,并保留其所属队伍。 |
LOBBY |
传送至大厅 |
剥离玩家的 QTeams 小队身份,撤销世界访问权限,并将其传送至个人虚空大厅。 |
LOBBY_WITH_LEAVE |
大厅 + 离开消息 |
向世界广播 100% 黄色的 <Player> left the game 消息,剥离其队伍身份,并将其传送至大厅。 |
KICK |
从服务器踢出 |
剥离玩家队伍身份,并将被淘汰的玩家从服务器踢出。 |
BAN |
死亡即大厅封禁 |
剥离玩家队伍身份,施加永久的大厅封禁,并将其锁定在个人虚空大厅内。 |
? 命令与权限参考
玩家命令
| 命令 |
描述 |
/qw lobby |
将玩家返回至其分配的个人虚空大厅槽位。 |
/qw join <world> |
进入开放录制世界的匹配队列。 |
/qw leave |
离开当前世界队列。 |
操作员指令 (OP)
| 指令 |
说明 |
/qw [gui] |
打开 Native QWorlds 对话框控制面板。 |
/qw boxwand |
授予操作员个人 Pos 1 / Pos 2 @box 选择法杖。 |
/qw freezewand |
授予操作员 Freeze Wand(点击玩家或 Shift+点击 用于 @box)。 |
/qw freeze <target|all|clear|wand> |
冻结或解冻目标玩家、@teams 或 @box。 |
/qw setwarp <name> |
将当前位置和朝向保存为操作员传送点。 |
/qw warp <name> [target] |
将自己或目标(player、@team、@box、@a[50%])传送到某个传送点。 |
/qw delwarp <name> |
删除已保存的操作员传送点。 |
/qw split <source> <team:%>... [warp] |
按百分比将 @box、lobby、@a 或 @team 拆分为 QTeams。 |
/qw chat |
打开冻结、世界聊天静音、队伍隔离及近距离聊天对话框。 |
/qw open <world> [limit] [@team] |
开启一个世界队列,可选设置玩家配额和自动分配队伍。 |
/qw recording <world> |
将世界锁定为录制模式,阻止新的队列加入。 |
/qw close <world> |
关闭世界会话,移除非 OP 队伍,并将玩家疏散至大厅。 |
/qw tp <world> [target] |
将自己或目标组传送到录制世界。 |
/qw addworld <name> [env] |
创建或导入目标世界(normal、nether、the_end)。 |
/qw setspawn <world> |
设置你所处世界的到达出生点坐标。 |
/qw wand / /qw savetemplate |
授予大厅模板法杖或保存所选的大厅结构。 |
/qw setlobby |
根据你所在的大厅或法杖框更新模板出生点偏移量。 |
/qw setpedestal <bow|trident|cannon|flightcharge> |
将选中的物品展示框转换为交互式圣物基座。 |
/qw <bow|trident|cannon|flightcharge> |
在自己的物品栏中切换大厅圣物的启用状态。 |
/qw giverelic <relic> <target> |
强制向玩家、all 或 @box 的物品栏中添加圣物。 |
/qw removerelic <relic> <target> |
撤销圣物解锁并从目标处移除该物品。 |
/qw spawnnpc <world> [skin] |
生成与录制世界关联的队列 NPC。 |
/qw setskin <world> <skin> |
更新世界队列 NPC 的皮肤用户名。 |
/qw spawnplayer <id> / /qw removenpc |
从 custom_npcs.yml 生成自定义 NPC 或移除附近的 NPC。 |
/qw pregen [amount] |
在 qwlobby_hub 中预生成额外的大厅槽位。 |
/qw lobbylist / /qw lobbytp <player> |
打开玩家目录对话框或传送到玩家的私人大厅槽位。 |
/qw sendlobby <player|@team|@box> |
强制将玩家或群体送回其私人虚空大厅。 |
| /qw lobbyban <玩家> <持续时间\|永久> | 将玩家锁定在其个人大厅中(支持 10m、2h、1d、perm)。 |
| /qw unlobbyban <玩家> | 解除对玩家的活跃的大厅锁定。 |
| /qw reload | 重新加载所有 YAML 配置文件、圣物名称、传送点、全息图和共享槽位。 |
? 配置文件 (plugins/QWorlds/)
1. config.yml
存储主引擎设置、全局与按世界划分的五种死亡模式路由、预生成池大小、缓存的大厅模板数据(方块、告示牌、物品展示框、基座及 NPC 偏移量)、传送点、每位玩家的 @box 选择、世界聊天/邻近聊天规则、玩家神器解锁状态以及活跃的大厅封禁列表。
global_death_mode: "LOBBY"
pool:
target_size: 10
built_slots: 10
chat:
muted_worlds:
- "event_arena"
allowed_teams: []
team_only_isolation: false
proximity_enabled: false
proximity_radius: 30.0
op_spy: true
warps:
arena_red:
world: "world"
x: 120.5
y: 72.0
z: -45.5
yaw: 90.0
pitch: 0.0
worlds:
world:
state: "CLOSED"
open_limit: -1
auto_team: "NONE"
death_mode: "LOBBY_WITH_LEAVE"
npc_skin: "Notch"
2. relics.yml
自定义四种古老大厅神器的显示名称、十六进制颜色渐变(gradient_start 和 gradient_end)以及锁定的箭袋箭矢标题。更改通过 /qw reload 命令实时生效。
relics:
bow:
name: "Bow of ParrotX2"
gradient_start: "#FBBF24"
gradient_end: "#EF4444"
quiver_name: "ParrotX2 Quiver Charge (Locked)"
trident:
name: "Treasure"
gradient_start: "#FFFFFF"
gradient_end: "#38BDF8"
cannon:
name: "Orbital Strike Cannon"
gradient_start: "#F43F5E"
gradient_end: "#FBBF24"
flightcharge:
name: "FlightCharge"
gradient_start: "#38BDF8"
gradient_end: "#E0F2FE"
3. info_signs.yml
控制浮动方向性 TextDisplay 全息图、MiniMessage 文本格式以及可点击的网页链接(open_url)。在大厅模板内,使用大厅模板法杖(/qw wand)Shift + 右键点击告示牌并输入告示牌 ID(例如 welcome)即可将其链接。
signs:
welcome:
link: "[https://example.com](https://example.com)"
lines:
- "<gradient:#EF4444:#F59E0B><bold>SERVER NETWORK</bold></gradient>"
- "<gray>Scripted Events and Tournaments</gray>"
- ""
- "<yellow>Click to open our Website</yellow>"
4. custom_npcs.yml
声明带有 MiniMessage 姓名标签和皮肤用户名的自定义玩家 NPC 档案,操作员可使用 /qw spawnplayer <id> 在任何地方生成这些 NPC。
npcs:
host:
name: "<gradient:#FDE047:#F59E0B><bold>Event Host</bold></gradient>"
skin: "Steve"
moderator:
name: "<gradient:#38BDF8:#7DD3FC><bold>Staff Coordinator</bold></gradient>"
skin: "MHF_Question"
? 服务器要求与软依赖
| 需求 / 依赖 |
版本 / 状态 |
用途 |
| Paper / Purpur |
1.21.11 (必需) |
提供原生对话框 API 以及现代化的实体/区块 API。 |
| Java Runtime |
Java 21 (必需) |
用于编译和运行 Paper 1.21.11 插件。 |
| QTeams |
2.0.0+ (推荐) |
启用实时的 @team 选择器、百分比队伍拆分以及跨插件导航功能。 |
| QKits |
1.0.0+ (推荐) |
启用 @box 和 @team 的套装分发以及虚空大厅领地保护。 |
| FancyNpcs |
可选 |
通过反射渲染自定义玩家模型 NPC 和皮肤。 |
| Multiverse-Core |
非常重要 |
支持外部世界导入和自定义环境标志。 |
QWorlds
Paper / Purpur 1.21.11 · Java 21 · Native Dialog UI (io.papermc.paper.dialog)
Virtualized Void Lobby Grid, Matchmaking Queues, and Live Scripted Event Orchestration.
QWorlds is a production-ready lobby management, matchmaking queue, and scripted event control plugin built for competitive tournaments, content creator SMPs, and large-scale recording sessions. It eliminates multi-proxy lobby overhead by consolidating personal player hubs into a single virtualized void grid world (qwlobby_hub), while equipping operators with a complete suite of live event orchestration tools.
[!IMPORTANT]
What's New in Version 3.0:
QWorlds 3.0 introduces Mojang's Native Dialog UI, Per-Player @box Selection Wands with client-sided particle outlines, a Freeze Wand, a Percentage Team Splitter (/qw split), Operator Warps, World Chat & Whisper (/msg) Muting, Proximity Chat, Fractional Target Selectors (@team[50%], @box[1/2]), and a 4th Ancient Lobby Relic (FlightCharge).
? QTeams & QKits Ecosystem Integration
QWorlds 3.0 forms the core of the QWorlds + QTeams + QKits event stack:
| Feature |
Ecosystem Behavior |
| Cross-Plugin Dialog Bar |
Jump directly between /qw, /qt, and /qk from the Native Dialog top navigation bar. |
| Automated Queue Squads |
Configure open world queues (/qw open <world> [limit] [@team]) to automatically assign admitted players to a target QTeams squad upon arrival. |
| Percentage Team Splitter |
Split players from @box, lobby, @a, or an existing @team into multiple QTeams by exact percentages/weights (e.g., royal:50 corrupt:30 chicken:20) and optionally warp each player to their team's spawn. |
| Universal & Fractional Selectors |
Use @box, @<team>, and fractional modifiers (@box[50%], @red[1/2], @a[25%], @box[r]) across /tp, /give, /effect, /gamemode, /qk give, and /qw. |
⚙️ Server Architecture & Core Mechanics
1. Native Paper 1.21.11 Dialog UI & 6-Tab Controller
- Zero-Chest Native Dialogs: Built on Paper 1.21.11's
DialogType.multiAction API with custom small-caps typography, compact 280px layouts, 12x12 icons, interactive checkboxes (☑ / ☐), and text inputs.
- 6-Tab Top Navigation Bar: Instant 1-click switching across all administrative modules:
? Worlds — Manage recording worlds, queue quotas, auto-teams, and per-world death modes.
⚡ Warps & Split — Manage Operator Warps, @box wands, and the Percentage Team Splitter.
❄ Freeze & Chat — Control the Freeze Wand, World Chat/Whisper Muting, Team Isolation, and Proximity Chat.
? Relics — Configure and distribute the 4 Lobby Relics and pedestals.
? Pool — Monitor and pre-generate virtualized void lobby slots.
? Players — Inspect online players, teleport to personal lobby slots, or manage Lobby Bans.
2. Event Control Suite: Per-Player @box Wand, Team Splitter & Warps
- Per-Player
@box Area Selector Wand (/qw boxwand): Gives operators an enchanted Breeze Rod where Left-Click Block sets Pos 1 and Right-Click Block sets Pos 2. Every operator has an independent @box selection rendered with client-sided cyan dust particle outlines (and gold dust outlines for the Lobby Template Wand) visible only to that operator.
- Universal & Fractional Selector Engine: Hooks into Paper's
AsyncPlayerSendCommandsEvent and AsyncPlayerSendSuggestionsEvent so /tp, /give, /effect, /clear, /gamemode, and /qk suggest online player names alongside @a, @p, @r, @s, @box, @<team>, and warps in one unified list—and continue prompting subsequent arguments after @box or @team.
- Percentage Team Splitter (
/qw split): Randomly shuffles a source group (@box, lobby, @a, or @<team>) and distributes players across target teams using largest-remainder math so 100% of players are assigned cleanly. Automatically creates missing teams in QTeams and teleports each player to their team's matching warp if configured.
- Operator Warps (
/qw setwarp, /qw warp, /qw delwarp): Save named event warps and teleport yourself, a single player, @box, or any @team (including fractional selectors) via the GUI, /qw warp <name> [target], or /tp <target> <warp>.
3. Player Freeze Engine, Freeze Wand & World Chat/Whisper Filters
- Freeze Wand (
/qw freezewand) & /qw freeze: Gives operators a custom Blue Ice wand. Hit or Right-Click a player to toggle their freeze state, or Shift + Right-Click Air to freeze everyone inside your @box. Frozen players have movement, jumping, combat, block breaking/placing, item dropping, inventory clicks, and commands locked while seeing a live ❄ YOU ARE FROZEN BY AN OPERATOR ❄ actionbar alert.
- World Chat Mute & Whisper (
/msg) Blocking: Mute text chat per world in the ❄ Freeze & Chat tab. When a world's chat or messages are muted (or while a player is in the Void Lobby), private whispers (/msg, /tell, /w, /whisper, /r, /reply, /teammsg) are automatically blocked for non-OP players.
- Team-Only Isolation, Allowed Chat Teams & Proximity Chat: Restrict global chat so only specific
@teams can speak, isolate chat so players only hear teammates, or enable Proximity Chat (15m, 30m, 50m, 100m radius) with toggleable OP Chat Spy.
4. Virtualized Void Grid (qwlobby_hub) & Collision-Safe Void Rescue
- Grid Chunk Allocation: Partitions
qwlobby_hub into a 10-column grid with 256-block offsets at Y=64, enforcing isolated 5-chunk view and simulation distances so players in personal lobbies cannot see each other on the tablist, hear each other's chat, or load outside entities.
- Staggered Pre-Gen Pooling (
/qw pregen): Pre-generates and caches lobby slots asynchronously with chunk tickets and a live OP progress bar.
- Cubic Bezier Void Rescue Arc: Falling past
Y=44 launches a smooth cubic Bezier flight curve that sweeps horizontally past the template's bounding box and climbs 26 blocks above the highest roof block before landing at the slot's spawn point.
5. Four Ancient Lobby Relics (relics.yml) & Bat Minigame
| Relic ID |
Default Name |
Mechanics & Highlights |
bow |
Bow of ParrotX2 |
Infinite explosive lobby bow with zero block/entity damage, bat minigame hit registration, and an anti-dupe locked quiver charge in slot 17. |
trident |
Treasure Trident |
Loyalty V trident with instant void-recall checks, chunk ticketing during long throws, and cosmetic lightning strikes on impact. |
cannon |
Orbital Strike Cannon |
Custom fishing rod (3s cooldown) that calls down 3 concentric rings of falling primed TNT (6, 10, and 14 entities + center strike) with zero block damage. |
flightcharge |
FlightCharge (New) |
Infinite Wind Charge relic. Looking straight down (pitch >= 70°) while mid-air and right-clicking triggers a Mid-Air Chain Boost with gust particles and wind burst audio. |
- Artifact Completion Cinematic: Collecting both the Trident and Cannon triggers a slot-wide perimeter lightning sequence, goat horn audio cue, and toast banner.
- Line-of-Sight Bat Minigame: Spawns 6 raytraced bats per active lobby slot clamped below eye level (
Y+0.2 to Y+1.55). Reaching a 10-hit combo streak sequentially detonates all bats in the slot.
6. Directional Info Holograms (info_signs.yml) & Custom NPCs (custom_npcs.yml)
- Sign-Free Holograms & Web Links: Physical signs placed inside the lobby template act as coordinate and rotation anchors. When a lobby slot is pasted, the physical sign blocks are cleared (
Material.AIR) and replaced with yaw-aligned TextDisplay holograms (Billboard.FIXED) paired with invisible Interaction hitboxes. Looking at a hologram reveals its text, and right-clicking it sends a clickable open_url link in chat.
- Reflection-Based FancyNpcs Integration: Spawns queue NPCs (
/qw spawnnpc) and custom profile NPCs (/qw spawnplayer) via reflection with zero hard compile dependencies.
7. 5-Mode Player Death Routing & Automatic Team Stripping
Configure globally or per recording world how player deaths are handled during events:
| Mode ID |
GUI Label |
Behavior on Player Death |
NOTHING |
Do Nothing |
Player respawns normally inside the recording world and keeps their team. |
LOBBY |
Send to Lobby |
Strips the player's QTeams squad, revokes world admission, and sends them to their personal void lobby. |
LOBBY_WITH_LEAVE |
Lobby + Leave Msg |
Broadcasts a 100% yellow <Player> left the game message to the world, strips their team, and sends them to their lobby. |
KICK |
Kick from Server |
Strips the player's team and kicks the eliminated player from the server. |
BAN |
Lobby-Ban on Death |
Strips the player's team, applies a permanent Lobby Ban, and locks them inside their personal void lobby. |
? Command & Permission Reference
Player Commands
| Command |
Description |
/qw lobby |
Returns the player to their assigned personal void lobby slot. |
/qw join <world> |
Enters the matchmaking queue for an open recording world. |
/qw leave |
Leaves the current world queue. |
Operator Commands (OP)
| Command |
Description |
/qw [gui] |
Opens the Native QWorlds Dialog Control Panel. |
/qw boxwand |
Gives the operator their personal Pos 1 / Pos 2 @box Selection Wand. |
/qw freezewand |
Gives the operator the Freeze Wand (Click player or Shift+Click for @box). |
/qw freeze <target|all|clear|wand> |
Freezes or unfreezes target players, @teams, or @box. |
/qw setwarp <name> |
Saves an Operator Warp at your current location and orientation. |
/qw warp <name> [target] |
Warps yourself or a target (player, @team, @box, @a[50%]) to a warp. |
/qw delwarp <name> |
Deletes a saved Operator Warp. |
/qw split <source> <team:%>... [warp] |
Splits @box, lobby, @a, or @team into QTeams by percentage. |
/qw chat |
Opens the Freeze, World Chat Mute, Team Isolation & Proximity Chat Dialog. |
/qw open <world> [limit] [@team] |
Opens a world queue with optional player quota and auto-team assignment. |
/qw recording <world> |
Locks a world into Recording Mode, preventing new queue joins. |
/qw close <world> |
Closes the world session, strips non-OP teams, and evacuates players to lobbies. |
/qw tp <world> [target] |
Teleports yourself or a target group into a recording world. |
/qw addworld <name> [env] |
Creates or imports a target world (normal, nether, the_end). |
/qw setspawn <world> |
Sets the arrival spawn coordinates for the world you are standing in. |
/qw wand / /qw savetemplate |
Gives the Lobby Template Wand or saves the selected lobby structure. |
/qw setlobby |
Updates the template spawn offset relative to your lobby or wand box. |
/qw setpedestal <bow|trident|cannon|flightcharge> |
Converts the targeted Item Frame into an interactive Relic Pedestal. |
/qw <bow|trident|cannon|flightcharge> |
Toggles a Lobby Relic in your own inventory. |
/qw giverelic <relic> <target> |
Forces a relic into the inventory of a player, all, or @box. |
/qw removerelic <relic> <target> |
Revokes a relic unlock and removes the item from the target. |
/qw spawnnpc <world> [skin] |
Spawns a queue NPC linked to a recording world. |
/qw setskin <world> <skin> |
Updates the skin username for a world's queue NPC. |
/qw spawnplayer <id> / /qw removenpc |
Spawns a custom NPC from custom_npcs.yml or removes nearby NPCs. |
/qw pregen [amount] |
Pre-generates additional personal lobby slots in qwlobby_hub. |
/qw lobbylist / /qw lobbytp <player> |
Opens the Player Directory Dialog or teleports into a player's lobby slot. |
/qw sendlobby <player|@team|@box> |
Forces a player or group back to their personal void lobby. |
/qw lobbyban <player> <duration|perm> |
Locks a player in their personal lobby (10m, 2h, 1d, perm). |
/qw unlobbyban <player> |
Lifts an active Lobby Ban from a player. |
/qw reload |
Reloads all YAML configs, relic names, warps, holograms, and pooled slots. |
? Configuration Files (plugins/QWorlds/)
1. config.yml
Stores main engine settings, global and per-world 5-mode death routing, pre-generation pool sizes, cached lobby template data (blocks, signs, item frames, pedestals, and NPC offsets), Operator Warps, per-player @box selections, world chat/proximity chat rules, player relic unlocks, and active lobby bans.
global_death_mode: "LOBBY"
pool:
target_size: 10
built_slots: 10
chat:
muted_worlds:
- "event_arena"
allowed_teams: []
team_only_isolation: false
proximity_enabled: false
proximity_radius: 30.0
op_spy: true
warps:
arena_red:
world: "world"
x: 120.5
y: 72.0
z: -45.5
yaw: 90.0
pitch: 0.0
worlds:
world:
state: "CLOSED"
open_limit: -1
auto_team: "NONE"
death_mode: "LOBBY_WITH_LEAVE"
npc_skin: "Notch"
2. relics.yml
Customizes the display names, hex color gradients (gradient_start and gradient_end), and locked quiver arrow titles for all four ancient lobby relics. Changes apply live via /qw reload.
relics:
bow:
name: "Bow of ParrotX2"
gradient_start: "#FBBF24"
gradient_end: "#EF4444"
quiver_name: "ParrotX2 Quiver Charge (Locked)"
trident:
name: "Treasure"
gradient_start: "#FFFFFF"
gradient_end: "#38BDF8"
cannon:
name: "Orbital Strike Cannon"
gradient_start: "#F43F5E"
gradient_end: "#FBBF24"
flightcharge:
name: "FlightCharge"
gradient_start: "#38BDF8"
gradient_end: "#E0F2FE"
3. info_signs.yml
Controls floating directional TextDisplay holograms, MiniMessage text formatting, and clickable web links (open_url). Link a sign inside your lobby template by Shift + Right-Clicking it with the Lobby Template Wand (/qw wand) and typing the sign ID (e.g., welcome).
signs:
welcome:
link: "[https://example.com](https://example.com)"
lines:
- "<gradient:#EF4444:#F59E0B><bold>SERVER NETWORK</bold></gradient>"
- "<gray>Scripted Events and Tournaments</gray>"
- ""
- "<yellow>Click to open our Website</yellow>"
4. custom_npcs.yml
Declares custom player NPC profiles with MiniMessage nametags and skin usernames that operators can spawn anywhere using /qw spawnplayer <id>.
npcs:
host:
name: "<gradient:#FDE047:#F59E0B><bold>Event Host</bold></gradient>"
skin: "Steve"
moderator:
name: "<gradient:#38BDF8:#7DD3FC><bold>Staff Coordinator</bold></gradient>"
skin: "MHF_Question"
? Server Requirements & Soft Dependencies
| Requirement / Dependency |
Version / Status |
Purpose |
| Paper / Purpur |
1.21.11 (Required) |
Provides the Native Dialog API and modern entity/chunk APIs. |
| Java Runtime |
Java 21 (Required) |
Required for compiling and running Paper 1.21.11 plugins. |
| QTeams |
2.0.0+ (Recommended) |
Enables live @team selectors, percentage team splitting, and cross-plugin navigation. |
| QKits |
1.0.0+ (Recommended) |
Enables @box and @team kit distribution and Void Lobby claim protection. |
| FancyNpcs |
Optional |
Renders custom player-model NPCs and skins via reflection. |
| Multiverse-Core |
VERY IMPORTANT |
Supports external world imports and custom environment flags. |
评论 0
登录后参与评分
还没有评论,来抢沙发吧