chihya72/gakumas-mod-runtime
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

3 Releases 4 Tags

RSS Feed
  • v1.0.0 5028672f38
    Compare

    Gakumas Mod Runtime 1.0.0
    Some checks failed
    release / build (push) Has been cancelled
    Details
    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
  • v0.3.0 e1da13e82c
    Compare

    Gakumas Mod Runtime 0.3.0
    Some checks failed
    release / build (push) Has been cancelled
    Details
    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
  • 0.2.0 565d318c89
    Compare

    Gakumas Mod Runtime 0.2.0 Stable

    chihya72 released this 2026-08-05 09:54:14 +08:00 | 4 commits to main since this release

    Gakumas Mod Runtime 0.2.0

    学园偶像大师本地 AssetBundle Mod Runtime 正式版。

    主要内容

    • Runtime 版本统一为 0.2.0；
    • 修复反复开关 Mod 时因缓存已销毁的 Unity 对象引用导致游戏崩溃的问题；
    • 标准服装与发型 Mod 支持当前会话内 ON/OFF 热切换；
    • 保留 Mesh、材质、骨骼绑定和 Animation Rig 的恢复与重应用；
    • Runtime 与游戏内 Mod 管理界面继续由同一个 xinput1_3.dll 提供；
    • 发布包包含项目许可证和第三方组件许可证。

    已知行为

    热开启 Mod 后直接返回主页时，颜色可能暂时未刷新。此时进入一次换装页面即可重新走完整替换流程并恢复正确颜色。

    该问题仍作为后续开发重点，目前不影响标准 Mod 的热切换稳定性。

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

    安装

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