3 Releases 4 Tags

RSS Feed

• v0.3.0 e1da13e82c

  Compare

  Gakumas Mod Runtime 0.3.0 Stable

  chihya72 released this 2026-08-09 06:04:35 +08:00 | 2 commits to main since this release

  Gakumas Mod Runtime 0.3.0

  学园偶像大师本地 AssetBundle Mod Runtime。本版专注修复游戏内热开关的显示与稳定性问题，
  0.2.0 的「已知行为」（热开启后需进一次换装页面刷新颜色）已解决。

  主要内容

  • Runtime 版本统一为 0.3.0；
  • 修复热开启 Mod 后直接返回主页颜色不正确：换网格空间时法线与切线没有跟随顶点一起变换，
    导致活动角色的着色与几何脱节；现在开启后直接回主页即为正确颜色，无需再进入换装页面；
  • 修复开机时处于关闭状态的 Mod 中途开启不生效：热重应用的目标 identity 改为在资源加载时记录，
    不再要求「本次启动内先关过一次」；
  • 修复关闭 Mod 后贴图未还原：关闭时先注销贴图覆盖再写回原始贴图，避免被自身的贴图钩子拦截；
  • 修复反复开关导致内存持续增长：每次热开启克隆的网格在关闭时释放并销毁；
  • 修复摆动骨注册异常打断开关流程：游戏侧 RegisterBones 抛出的异常不再中断整个开关，
    Manifest 写回与界面状态保持一致；
  • 日志新增 [ModAudit] 诊断行，记录每个被替换 Renderer 当前挂载的网格、材质与贴图状态
    （仅在 logLevel 为 "info" 时输出，默认不产生任何开销）；
  • Runtime 与游戏内 Mod 管理界面继续由同一个 xinput1_3.dll 提供；
  • 发布包包含项目许可证和第三方组件许可证。

  已知行为

  源专属新增骨的摆动物理尚未生效。装饰件当前按刚性跟随父骨表现，不会飘动。
  这属于打包侧的数据缺口（导出的骨架 sidecar 未包含摆动参数与链尾骨），不影响换装本身。

  关闭 Mod 后，本次游戏进程内已经加载过的资源仍保留替换结果，
  再次进入换装页面可能仍显示 Mod 外观；重启游戏必定恢复原版。

  整对象替换和附加式规则不保证即时逆转，必要时可能需要重新加载资源、场景或重启游戏。

  安装

  1. 关闭游戏；
  2. 将 xinput1_3.dll 解压到 gakumas.exe 所在的游戏根目录；
  3. 已有 gakumas-mod\config.json 时请保留原文件，不要覆盖；
  4. Mod 放置在：

  gakumas-mod\mods\<mod-id>\
    mod.json
    <mod-id>.bundle
  

  Downloads

  • gakumas-mod-runtime-0.3.0.zip
    320 KiB

    2026-08-09 06:12:29 +08:00
  • Source Code (ZIP)
  • Source Code (TAR.GZ)