跳到正文
烈焰甘蔗Wiki

命令行

基本信息

属性 值
类 TMCommand（实现 ICommand）
命令名 thaumicmachina
别名 thaumicmachina（与主名重复）、tm
权限等级 2（OP，getRequiredPermissionLevel() 返回常量 2，非可配置）
注册 FMLServerStartingEvent → event.registerServerCommand(new TMCommand())（ThaumicMachina.java:48-51）
子命令 help、wandaugmentation
操作 add、remove、reset

用法

/thaumicmachina help
/thaumicmachina wandaugmentation add    <augmentation>
/thaumicmachina wandaugmentation remove <augmentation>
/thaumicmachina wandaugmentation reset

/tm 是 /thaumicmachina 的别名（lang tm.command.thaumicmachina.hint_alias 会提示）。

行为

wandaugmentation 三个操作直接读写手持法杖的 NBT（CommandBase.getCommandSenderAsPlayer 强制要求命令发送者是玩家）：

操作 行为 前置校验
add <id> WandHelper.addAugmentationsTo(stack, {augment}, false) —— 追加 NBT 字符串到 Augmentations 列表 必须是玩家、手持 ItemWandCasting、augmentationMap.get(args[2]) 非 null、该改装尚未存在
remove <id> WandHelper.removeAugmentationsFrom(...) 同上，但该改装必须已存在
reset NBTHelper.getCompoundFor(stack).removeTag("Augmentations") —— 清空全部 必须是玩家且手持法杖；args.length 必须恰好 2

可用 <id> 来自 WandHelper.augmentationMap 的 5 个主键 + 5 个别名（charge_buffer / Charge Buffer / …）。命令不做研究完成校验，因此可绕过整个研究树直接注入改装。

数值

数值 值
命令名 thaumicmachina
别名数 2（thaumicmachina、tm）
权限等级 2（硬编码）
子命令数 2（help、wandaugmentation）
操作数 3（add / remove / reset）
可操作改装数 5（主键）/ 10（含别名）
reset 要求的参数个数 恰好 2
add / remove 要求的参数个数 恰好 3
读取的手持槽位 getCurrentEquippedItem()（主手）
NBT 键 Augmentations（TAG_List）

交互

触发 行为
/tm（无参） 抛 WrongUsageException，显示 tm.command.thaumicmachina.usage
/tm help 3 条聊天消息：别名提示、命令列表、深绿高亮的 wandaugmentation 用法
/tm wandaugmentation（缺参数） WrongUsageException
/tm <未知子命令> WrongUsageException
控制台执行 wandaugmentation getCommandSenderAsPlayer 抛异常（要求玩家）
非手持法杖 CommandException：tm.command.thaumicmachina.error.no_wand_held
改装名不存在 CommandException：tm.command.thaumicmachina.error.unknown_augment
add 已存在的改装 CommandException：...error.is_present
remove 不存在的改装 CommandException：...error.is_absent

源码缺陷

  • 别名包含自身：ALIASES = ["thaumicmachina", "tm"]（command/TMCommand.java:26）。getCommandName() 已返回 thaumicmachina，别名表里重复登记一次。1.7.10 的 CommandHandler 会同时注册两者，行为上无害但属冗余。
  • Tab 补全不校验权限：addTabCompletionOptions 直接返回 SUBCOMMANDS / OPERATIONS / 改装 ID 列表（:114+），非 OP 玩家在客户端仍可看到完整候选，属信息泄露（低危）。
  • reset 的参数校验反直觉：if (args.length != 2) throw —— 即 /tm wandaugmentation reset 恰好 2 个参数时通过，多打一个 token 就报错。逻辑正确但风格与 add/remove 的「恰好 3」不统一。
  • 主键与别名等价，但 NBT 只存主键：WandHelper.registerAugmentation 把主键和别名都放进 augmentationMap（wand/WandHelper.java:26,30），因此 add Charge Buffer 与 add charge_buffer 都能工作（getAugmentations 按 map 反解为同一 INSTANCE）。但 addAugmentationsTo 写入的永远是 augmentation.getID()（:93），即 NBT 里只会出现 snake_case 主键，别名仅作读取兼容。
  • addAugmentationsTo(stack, ..., false) 不复制栈：直接改写玩家手持法杖，无 markDirty / 同步包。服务端在 tick 结束时通常会同步背包，但在同 tick 内继续执行其他逻辑可能读到半更新状态。
  • getCommandUsage 返回 i18n key 而非已翻译文本：return "tm.command.thaumicmachina.usage";（:42）。WrongUsageException 会把该字符串直接输出给玩家，因此玩家看到的是原始 key而不是翻译后的用法。getCommandUsage(ICommandSender) 契约要求返回已本地化文本。

相关条目

浏览全部模组