模组包助手

模组包助手

模组包开发者和管理员的服务器端命令工具。可以扫描矿石和生物群系分布，模拟战利品、生成和挖掘产出，审计配方、标签和不可制作物品，清除或排空区域，以及治疗、无敌、修复和维度旅行。

整合包助手

面向整合包开发与服务器管理的服务端命令。涵盖世界检查、区域编辑、战利品与生成模拟、配方与标签审计，以及常见的服务器管理便利功能。

整合包助手不添加任何方块、物品、实体或 GUI。其所有功能均通过命令实现，因此可无缝加入整合包且不会干扰其他内容，也可随时从整合包中添加或移除。

原版客户端可直接连接并使用全部功能。唯一的客户端附加功能是自动复制到剪贴板——当客户端未安装本模组时，则退化为点击聊天消息复制。

分析与报告

只读扫描，将报告文件写入 logs/modpackassistant/ 目录下。

命令 用途
/ma scanOres <区块半径> [最小y] [最大y] 按方块和高度统计矿石分布
/ma mapBiomes <半径> [间隔] [y] 查看区域内的生物群系覆盖情况，不加载区块
/ma simulateLoot <迭代次数> <战利品表> [幸运值] 统计任意战利品表的掉落概率
/ma simulateSpawns <生物群系> <维度> <游戏刻> 估算自然生成情况，不会向世界添加实体
/ma findConflicts [类型] 查找消耗相同输入材料的配方冲突
/ma findUncraftables [命名空间] 查找没有配方、战利品表或交易来源的物品
/ma auditUnification [命名空间] 审计包含多个或零个物品的材料标签
/ma exportTags <物品/方块/实体/流体> [json/csv] 导出所有已注册对象及其标签

模拟命令会声明其预期结果，并列出所有无法评估的规则。

世界编辑

命令 用途
/ma clear <半径> [keep <ores/ores_and_modded/nothing> / remove <条件谓词>] [protect_bedrock] 在区块区域内批量删除方块
/ma drain [位置] <半径> 洪水填充式移除相连的流体块
/ma kill <类型> 或 /ma kill by <实体> 批量移除实体
/ma minearea <半径> [harvest] 模拟开采区域内所有矿石，并将掉落物存入桶中
/ma testStructureLoot <结构> [样本数] 按结构战利品表生成对应箱子战利品并放置告示牌标记，附带 clear 命令可精确清除所放置的内容
/ma cancel 中止当前正在运行的长时操作

区域命令统一使用半径约定：半径 0 表示单个区块，半径 n 表示每边 (2n+1) 个区块。消息中始终显示实际的区块跨度，而非原始参数。基岩保护默认开启，批量实体移除遵循数据包保护的标签，且除非使用明确的玩家目标类型，否则绝不会误伤玩家。

管理便利功能

命令 用途
/toggledownfall 在主世界晴天与雨天之间切换
/ma devenv <true/false> 冻结或恢复昼夜循环、天气和生物生成
/ma opsword 给予一把附魔至 255 级的下界合金剑
/ma enchant add <附魔> <0-255> 为主手物品附上超出常规上限的附魔
/ma enchant remove <附魔> 移除主手物品上的一个附魔
/ma repair [玩家] 修复手持物品
/ma heal [玩家]、/ma feed [玩家] 恢复生命值与饥饿值
/ma god [玩家] 切换无敌状态
/ma nightvision 切换永久夜视效果
/ma tpd <维度> [目标] 安全地将实体传送至其他维度

物品数据提取

/ma hand、/ma print <来源> 和 /ma copy <来源> [格式] 可读取八种物品来源（主手、副手、快捷栏、背包、背包加快捷栏、盔甲栏、全部物品，以及指定玩家的背包），并输出为九种格式：纯文本、组件、NBT、SNBT、JSON、KubeJS、KubeJS 原生、CraftTweaker 和 CSV。该功能便于将精确物品堆栈直接粘贴到脚本或配方中，无需手写组件语法。

长时操作的行为机制

区域清理、矿物勘察、开采模拟和流体排空均会被分解为逐区块任务，交由共享的刻调度器处理。任何操作都不会在单个游戏刻内扫描或编辑整个区域。同一时间仅允许一个长时任务运行，会实时更新进度报告、拒绝重叠任务，并可通过 /ma cancel 终止。

配置

config/modpackassistant-common.toml 文件包含物品检查所需的权限等级、各高开销命令的半径/迭代/方块数量上限、报告输出目录及任务间隔时间。

管理命令默认需要的权限等级为 2。

环境要求

  • Minecraft 26.1.2
  • NeoForge 26.1.2.73 或更新版本
  • Java 25
  • 服务端模组。客户端安装为可选项，仅用于启用自动剪贴板复制功能。

链接