【测试分支】1.94更新公告：支持代码插件（BepinEx）

测试分支已更新到1.94版本，集成了BepInEx代码插件，此前 Mod 仅能包含配置表、立绘、音频等数据内容，现在作者可以编写 C# 插件，实现更丰富、更自由的自定义游戏逻辑。

一、玩家指南与常见问题

1、订阅即可使用，无需手动复制

现在从创意工坊订阅支持1.94版本的插件Mod 后，只需在游戏内启用 Mod 并重启游戏，插件就会自动生效，无需再手动解压或放置文件。

注意：旧版本的mod需要作者更新插件目录才能自动生效，具体文件目录见二.1

2、若BepInEx插件无法正常运行，请更新Visual C++运行库：

[p align="start"]建议把 x64 和 x86 两个版本都装上，避免因位数不匹配导致问题。

• x64 版（64位系统/游戏）：https://aka.ms/vc14/vc_redist.x64.exe

• x86 版（32位游戏）：https://aka.ms/vc14/vc_redist.x86.exe

注意：安装完后记得重启电脑再启动游戏试试

3、切换成测试分支的方法：

• 在Steam库中，右键“学生时代”，点击“属性”

• 点击“测试版”，在参与测试中选择“test-测试版"

二、Mod 作者开发指南

1. 将编译好的插件 DLL 放入 Mod 内容目录下的 plugins 文件夹中

[c]你的Mod目录/[/c]

[c]├── preview.jpg           ← Mod 预览图[/c]

[c]├── Cfgs/                  ← 原有数据内容（可选）[/c]

[c]│   └── zh-cn/[/c]

[c]└── plugins/               ← 新增：代码插件放置于此[/c]

[c]    └── MyPlugin.dll[/c]

注意：文件夹名称必须为全小写 plugins，且直接位于 Mod 根目录下，无需多级嵌套 BepInEx\plugins。

2. 插件编写规范（基于 BepInEx 5）

[c]using BepInEx;[/c]

[c]namespace MyMod[/c]

[c]{[/c]

[c]    [BepInPlugin("com.author.modname", "我的插件", "1.0.0")][/c]

[c]    public class MyPlugin : BaseUnityPlugin[/c]

[c]    {[/c]

[c]        private void Awake()[/c]

[c]        {[/c]

[c]            Logger.LogInfo("插件已成功加载！");[/c]

[c]        }[/c]

[c]    }[/c]

[c]}[/c]

• **规范要求：**必须添加 [BepInPlugin] 属性标注，并继承自 BaseUnityPlugin。

• **编译引用：**请引用游戏自带的 BepInEx\core\BepInEx.dll。如需修改或 Hook 游戏底层逻辑，直接引用内置的 0Harmony.dll (Harmony) 即可。

• **平台架构：**编译目标请选择 x64 或 AnyCPU。

3. 发布与打包

将包含 Dll 的 plugins 文件夹随 Mod 一起上传至创意工坊即可。玩家订阅后，插件将跟随 Mod 自动下载并同步加载。

三、注意事项与排查

• 安全须知：代码插件以游戏同等权限运行，请遵守社区规范，严禁发布任何恶意代码。

• 日志排查：如遇到插件运行异常，可前往游戏根目录下的 BepInEx\LogOutput.log 查看详细崩溃与运行日志。

感谢所有为《学生时代》Mod 生态付出心血的作者、测试者和反馈者。正是你们的创意、耐心与分享，让游戏拥有了更多可能。也感谢 BepInEx 等开源工具及其维护者，为代码插件提供了坚实基础。期待未来看到更多优秀作品，也欢迎大家继续反馈建议，共同完善 Mod 支持。