CommandBridge

插件

· 作者 objz

将所有服务器连接在一起,并在整个 Minecraft 网络中桥接命令。

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

需要前置:CommandAPI

最新 3.3.7 · 26.3 · Bukkit / Folia

一键开服(送7天)

CommandBridge

CommandBridge 是一款面向运行在 Velocity 上的 Minecraft 网络的跨服务器命令执行插件。你可以通过浏览器 GUI 设置网络并构建命令,也可以直接在代理端编写 YAML 脚本。CB 会通过 WebSocket 或 Redis 在这些已连接的服务器之间注册和分发这些命令。

玩家在后台服务器运行 /lobby,代理端会捕获该指令。管理员在 Velocity 上运行 /alert,选定的后台服务器便会执行它。命令传递不依赖玩家在线即可发送插件消息。

separator

CommandBridge

separator

在浏览器中设置你的网络

在 Velocity 上运行 /cb setup 并打开它提供的链接。全新安装时,CB 会自动在控制台中打印出设置链接。

页面将引导你为代理命名、选择 WebSocket 或 Redis、配置连接以及添加后台服务器。审查设置后,在代理控制台中运行确认命令以应用更改。

每个后台服务器都会获得一个配对命令。将其复制到该服务器的控制台中,查看显示的代理地址,然后运行 /cbc pair confirm。CB 会自动写入连接设置,包括共享密钥和 TOFU(Trust On First Use)连接的证书指纹。

separator

可视化构建命令

在 Velocity 上运行 /cb editor 并打开链接。你现有的脚本将加载到可视化编辑器中,你可以在画布上连接命令、参数、服务器目标和执行步骤。

选择命令的注册位置、执行它的服务器,以及它是作为控制台、玩家还是操作员运行。通过编辑器添加权限、延迟和冷却时间。你也可以打开 YAML 面板直接编辑脚本。

满意更改后,点击保存。CB 会检查脚本并提供一个 /cb editor confirm <code> 命令。在代理端运行它以写入文件并重新加载脚本。

设置和编辑器流量采用端到端加密。请保持链接私密,并在确认前审查更改。

separator

工作原理

所有内容仍通过存储在 Velocity 上的 YAML 脚本运行。可视化编辑器读取并写入相同的文件,因此你可以在浏览器和手动编辑之间切换。

每个脚本定义命令名称、参数、注册位置以及有人运行时的行为。CB 会在注册前验证脚本。如果某个脚本无效,它会报告问题并跳过该脚本,同时加载其他脚本。

以下是一个禁用的 /example <player> <message> 示例脚本。启用后,它将在名为 client-1 的 Velocity 实例上注册,并在 survival-1 上以控制台身份运行 msg。请将这些 ID 替换为你自己的:

version: 4

name: example
description: An example command script - edit or replace this with your own
enabled: false
aliases: [ex]

permissions:
  enabled: true
  silent: false

register:
  - id: "client-1"
    location: VELOCITY

defaults:
  run-as: CONSOLE
  execute:
    - id: "survival-1"
      location: BACKEND
  server:
    target-required: false
    schedule-online: false
    player-arg: ""
  delay: 0s
  cooldown: 0s

args:
  - name: player
    required: true
    type: STRING
    suggestions: []

  - name: message
    required: true
    type: TEXT
    suggestions: []

commands:
  - command: "msg ${player} ${message}"

separator

平台

一个 jar 包适用于 Velocity 和支持的后台服务器。在每个服务器上安装相同的文件。

6 Platforms

传输协议

WebSocket 是默认选项。如果你已经在使用 Redis 或者它更适合你的网络布局,请选择 Redis。

Transport

WebSocket 模式:Velocity 托管桥接服务器,你的后台服务器连接到它。TLS 内置其中,你不需要单独的消息服务。

Redis 模式:所有实例都连接到你的 Redis 服务器。消息经过签名以检测篡改和重放攻击。签名并不加密其内容,因此请限制对 Redis 的访问,并在需要时使用受保护的网络或加密隧道。

两种模式均支持多代理设置。一个 Velocity 作为主节点,额外的代理以客户端模式连接。

安全性

代理与后台连接使用相互 HMAC-SHA256 认证。双方证明知道共享密钥,而无需在网络上传输它。

Security

WebSocket 连接支持 TOFU、STRICT 和 PLAIN 模式。TOFU 是默认模式。Velocity 在首次启动时生成自签名证书,后台服务器会检查其公钥指纹。通过浏览器辅助配对可将代理的指纹保存到后台配置中。PLAIN 模式禁用 TLS 加密。

浏览器编辑器、设置和配对功能均采用端到端加密。配置更改和编辑器保存需要在代理端确认,后台配对则需要在该后台的控制台中确认。

执行模式

根据你的需求,命令可以在三种上下文中运行。

Execution Modes

CONSOLE 以目标服务器的控制台身份运行。PLAYER 以触发脚本的玩家身份运行。OPERATOR 以拥有命令临时权限授予的玩家身份运行。基于玩家的执行要求该玩家在线于目标服务器上。

参数

参数解析和 Tab 补全使用 CommandAPI。类型涵盖基本字符串和数字,以及 Minecraft 特定值,如玩家、位置、物品和实体。可用类型取决于平台和已安装的可选插件。

22 Argument Types

参数在命令字符串中变为 ${name} 占位符。如果需要外部数据(如玩家统计或经济数值),也支持 PlaceholderAPI。

separator

管理网络

设置每个玩家的冷却时间,并对单个命令应用延迟。一个脚本可以运行多个命令,每个命令都有其各自的目标和设置。

对于需要在特定服务器上有玩家的命令,启用 schedule-online 可将执行排队,直到玩家到达该服务器为止。待处理的计划任务在重启后仍然保留。

使用 /cb reload 重新加载脚本而无需重启 Velocity,或通过浏览器编辑器保存并确认更改。CB 跟踪跨连接服务器的玩家存在状态(包括客户端模式代理),以解析玩家目标和计划执行。

依赖项

Requirements

每台服务器上都必需 CommandAPI。PlaceholderAPI(通过 PapiProxyBridge)和 PacketEvents 为可选。

如果使用 Redis,在升级到 3.3.7 时,需同时更新并重启所有连接的代理和后端服务器。此版本会拒绝旧版的未签名消息。

separator

指标数据

本插件通过 bStats 收集匿名统计数据。您可以在 plugins/bStats/config.yml 中禁用此功能。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源