Skip to content

Admin Commands_CN

Jump to bottom
MIAOKATZE edited this page Jul 12, 2026 · 2 revisions

管理员命令

⚠️ 重要警告 / Important Warning

本页命令仅限极端特殊情况下由管理员（OP 等级 4）使用，普通游玩请勿使用。

These commands are for extreme edge cases only and should be used by admins (OP level 4). Do not use them during normal gameplay.

  • global_energy_trans 仅用于玩家换账户（正版转第三方等）导致 UUID 变化后迁移 EU——日常游玩请使用游戏内正常机制。
  • global_energy_join 仅用于多人共享电网的明确需求——单机或普通多人游玩无需使用。

1. 命令概览

GTSWN 提供一个管理员命令根节点 /gtswn，含 2 个子命令：

项目 说明
命令名 /gtswn
权限要求 OP 等级 4
Tab 补全 第一参数可补全子命令名
子命令数量 2 个（global_energy_trans、global_energy_join）

2. global_energy_trans

用法

/gtswn global_energy_trans <fromUUID> <toUUID>

功能

一次性将 fromUUID 网络的所有 EU 迁移到 toUUID 网络。

使用场景

玩家换账户（正版转第三方等）导致 UUID 变化后迁移 EU。

⚠️ 极端特殊情况专用 / For Extreme Edge Cases Only

此命令仅用于 UUID 变更（如换账户）导致 EU 余额无法找回的极端情况。普通游玩（包括换设备、重装游戏、服务器迁移等）请勿使用——这些情况下 UUID 不变，EU 余额会自动保留。误用可能导致 EU 数据丢失或重复。

参数

参数 说明
fromUUID 源玩家 UUID
toUUID 目标玩家 UUID

执行逻辑

  1. 读取源网络 EU 余额
  2. 先扣除源网络 EU（setUserEU(fromUUID, sourceEU.subtract(eu))）
  3. 再增加目标网络 EU（setUserEU(toUUID, targetEU.add(eu))）
  4. 若读取后源 EU 被其他操作改变导致不足，转全部当前余额

成功消息（绿色 + 青色）

§a迁移成功: <eu> EU
§a从: <fromUUID>
§a到: <toUUID>
§b目标网络当前总量: <toUUID 当前 EU> EU

失败消息

场景 消息
UUID 格式错误 §cUUID 格式错误,请检查参数
源 = 目标 §e源 UUID 与目标 UUID 相同,无需迁移
源无 EU §e源网络无 EU 可迁移

**安全说明：**先扣除源再增加目标，避免非原子性导致 EU 凭空增加。若扣除与增加之间源 EU 被其他操作改变，则按当前余额全部转出，确保不超发。

3. global_energy_join

用法

/gtswn global_energy_join <memberUUID> <leaderUUID>

功能

通过 GT5U 团队系统（SpaceProjectManager）将成员网络永久加入队长网络。

使用场景

多人共享电网，成员的无线 EU 操作自动解析到队长网络。

参数

参数 说明
memberUUID 成员玩家 UUID
leaderUUID 队长玩家 UUID

执行逻辑

  1. UUID 解析与校验
  2. 同一 UUID 检测（无需加入）
  3. 调用 SpaceProjectManager.getLeader(leaderUUID) 确保队长已注册
  4. 循环检测：若 memberUUID 是 leaderUUID 的队长，拒绝（避免循环）
  5. 级联提示：若 leaderUUID 自己也在别人的队里，提示实际加入的网络
  6. 执行加入：SpaceProjectManager.putInTeam(memberUUID, leaderUUID)

成功消息

gtswn.command.join.success：§a加入成功: %s 已加入 %s 的无线网络
gtswn.command.join.network_eu：§b目标网络当前总量: %s EU

失败 / 警告消息

场景 消息
同一 UUID §e成员UUID与队长UUID相同，无需加入
循环检测 §c循环检测: %s 是 %s 的队长，无法加入
级联提示 §e注意: %s 的队长为 %s，%s 将加入 %s 的网络

4. 使用示例

示例 1：换账户迁移 EU

**场景：**玩家 A 从正版账户迁移到第三方账户，UUID 从 AAAA 变为 BBBB。

/gtswn global_energy_trans AAAA BBBB

**结果：**AAAA 网络的 EU 全部迁移到 BBBB 网络。

示例 2：多人共享电网

**场景：**玩家 B 想加入玩家 C 的无线电网。

/gtswn global_energy_join B-UUID C-UUID

**结果：**B 的无线 EU 操作自动解析到 C 的网络。

示例 3：级联加入

**场景：**玩家 D 加入玩家 E，但 E 已加入 F。

/gtswn global_energy_join D-UUID E-UUID

**结果：**D 实际加入 F 的网络（级联提示显示）。

Clone this wiki locally