3 Releases 4 Tags

RSS Feed

• v1.0.0 5028672f38

  Compare

  Gakumas Mod Runtime 1.0.0 Stable

  chihya72 released this 2026-08-12 16:12:57 +08:00 | 1 commits to main since this release

  Gakumas Mod Runtime 1.0.0 — 独立运行时与游戏内 Mod 管理正式版

  本版变动：

  • 以 xinput1_3.dll 代理提供独立 AssetBundle Mod Runtime，统一扫描 gakumas-mod/mods/<mod-id>/mod.json，支持 body、hair 与 Geo_HairProp 多 Renderer 替换；
  • 内置游戏内 Mod 管理界面和 Runtime API v1，支持目录快照、启用状态持久化、同目标冲突保护，以及标准 SkinnedMeshRenderer Mod 的会话内热 OFF/ON；
  • 热切换会保存并恢复原 Mesh、材质、骨绑定和 MaterialPropertyBlock；当前场景尚无目标时按 modId + source 去重排队，在后续资源生命周期事件中重试；
  • 支持 manifest v2、骨架 sidecar、运行时新建骨、摆动物理参数、碰撞体与 ActorSwingChain；runtimeProtocol / buildId 不匹配会在应用前被拒绝；
  • 启动冲突采取 fail-closed：同一目标的多个启用 Mod 会整组关闭；即使 Manifest 写回失败，当前会话也不会静默选择某个优先级赢家；
  • 将初始化移出 DllMain 的 loader lock，并在安装进程级 Hook 前固定模块；共享摇物状态改为锁内快照、锁外调用 Unity/IL2CPP，降低卸载竞态和重入死锁风险；
  • Release x64 打包强制运行 mod_presentation_tests 与 mod_runtime_catalog_tests；Catalog 测试覆盖有效/无效 Manifest、缺 Bundle、多目标、冲突、原子写回和写回失败回滚语义；
  • 发布包包含代理 DLL、默认配置、安装说明、项目许可证和全部第三方许可证。

  当前边界

  • 新增摇物骨或链仍需重新进入场景，活体热 ON 不会为既有角色补建新的骨链；
  • 整对象替换与附加式规则不承诺即时逆转；
  • 冷路径创建的 Mesh/Material 克隆与未进入当前快照的 inactive prefab，仍需后续生命周期治理。

  本地发布验证

  • Release x64 编译通过；
  • mod_presentation_tests 通过；
  • mod_runtime_catalog_tests 通过；
  • Python 工具测试 5/5 通过。

  校验

  gakumas-mod-runtime-1.0.0.zip

  SHA-256：1C3999F4E874E29E09636E1FFC26758101EF3D1EE48C679A5F8B5F8BAD39FA83

  Downloads

  • gakumas-mod-runtime-1.0.0.zip
    331 KiB

    2026-08-12 16:27:16 +08:00
  • Source Code (ZIP)
  • Source Code (TAR.GZ)