QWorlds - 脚本化工具

插件

原名 QWorlds - Scripted Utils · 作者 CreoFlow

QWorlds 3.0 是一款适用于 Paper 1.21.11 的虚拟虚空大厅、匹配队列和脚本事件控制插件,具备原生对话框 UI、按玩家选择的 @box 选择法杖、冻结法杖、百分比队伍分配、4 种自定义大厅神器以及 5 种死亡路线。

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

最新 3.0.0 · 26.3 · Paper / Purpur

一键开服(送7天)

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 非常重要 支持外部世界导入和自定义环境标志。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源