模组安装教程

模组比地图多一道门槛：游戏得先能跑 C# 脚本。

! 先确认你的游戏能装模组，再往下看。官方的所有安卓安装包都装不了模组，这是引擎决定的，不是操作问题。判断方法见「我该装哪个版本」。

1三个东西的关系

装模组不是「把 zip 丢进去」这么简单，中间有三层：

层	是什么	谁负责
游戏本体	必须支持 C# 脚本（Mono 后端）	你下载的那一版游戏
前置框架	NeoModLoader —— 模组加载器本体	前置框架页下载
模组	一个个 `.dll` 或源码包	模组页下载

缺任何一层都不行。最常见的情况是：游戏版本不对，装什么都白搭；其次是漏了 NeoModLoader，模组文件在但没人去加载它。

2Android：用启动器装（推荐）

启动器会自动做三件事，省掉所有手工步骤：

把 NeoModLoader.dll 放进模组目录
把下载的 zip 解压成「一个模组一个文件夹」的正确结构
识别源码模组（有些模组只有 .cs 源码，要在手机上现场编译）

「模组」页里点下载就行。装完在启动器里能看到开关，能随时启用/禁用。

3Android：手动装

模组放在：

/sdcard/Android/data/com.mkarpenko.worldbox/files/mods/

结构必须是「一个模组一个文件夹」，而且文件夹里直接就是模组内容，不能再套一层：

files/mods/
├── NeoModLoader.dll          ← 加载器本体
├── PowerBox/                 ← 一个模组
│   ├── mod.json
│   └── PowerBox.dll
└── RulerBox/                 ← 另一个模组
    ├── mod.json
    └── RulerBox.dll

! 这里有个特别容易踩的坑：很多模组包解压后会变成 mods/PowerBox/PowerBox/mod.json —— 多套了一层同名目录。NeoModLoader 只扫模组的直接子目录，多一层它就认为这个文件夹里没有模组，表现是「装好了但游戏里什么都没有」。手动装的话，确认 mod.json 就在第一层。

4PC 版怎么装

Steam 版的世界盒子是 Mono 后端，天生支持模组，装法也简单：

先装 NeoModLoader（前置框架页下载，按游戏版本挑）
模组解压到游戏根目录下的 Mods/ 文件夹
同样是「一个模组一个文件夹」

5装了没效果？分三种情况

① 游戏里完全看不到任何变化

先查前置框架有没有装好。判断方法：游戏启动时如果 NeoModLoader 生效，加载界面会有它的提示文字，或者游戏目录下会生成 NML/ 文件夹。都没有，说明加载器根本没跑起来。

② 别的模组都正常，就这一个没反应

大概率是模组本身的问题，不是你的操作。最常见的是版本不匹配：老模组调用了新版本已经没有的接口，编译时就失败。启动器在安装前会标注适配版本，装之前看一眼。

! 有一个反直觉的现象：某个模组装坏了，会让所有模组的界面一起消失。因为 NeoModLoader 是顺序加载的，前一个模组在初始化阶段抛异常，后面的注册就全被打断了。所以「全都失效」时，先怀疑最近装的那一个。

③ 模组生效了，但手机上没入口

这跟模组的实现方式有关，分两类：

类型	表现	手机上能用吗
注册了底部标签页	游戏底部多出一个标签，点进去是功能面板	可以
自绘浮动窗口 + 快捷键	按某个键（如 K）弹出面板，代码里监听的是键盘	不行

第二类在手机上没有物理键盘，代码里的 Input.GetKeyDown(KeyCode.K) 永远不会触发，所以功能是「装了但用不了」。这不是安装失败，是模组本身没考虑移动端。