Developer postOriginal post (opens in a new tab)

【测试分支】1.94更新公告:支持代码插件(BepinEx)

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

一、玩家指南与常见问题

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

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

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

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

建议把 x64 和 x86 两个版本都装上,避免因位数不匹配导致问题。

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

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

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

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

二、Mod 作者开发指南

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

你的Mod目录/

├── preview.jpg           ← Mod 预览图

├── Cfgs/                  ← 原有数据内容(可选)

│   └── zh-cn/

└── plugins/               ← 新增:代码插件放置于此

    └── MyPlugin.dll

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

2. 插件编写规范(基于 BepInEx 5)

using BepInEx;

namespace MyMod

{

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

    public class MyPlugin : BaseUnityPlugin

    {

        private void Awake()

        {

            Logger.LogInfo("插件已成功加载!");

        }

    }

}

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

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

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

3. 发布与打包

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

三、注意事项与排查

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

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

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

Build and release context

Steam update times within 24 hours of this post. Matching dates do not confirm which build it describes.

  • Build 25320018 · test branch

    Steam updated · First observed