松散文件加载器

创作者: kassent
已更新:2026-02-28 21:31:59
433KB

前置 MOD

使用 松散文件加载器 时将自动安装

关于此 MOD

允许游戏从外部档案加载未打包的散装文件。
松散文件加载器可让《仁王3》直接从磁盘读取散装文件,无需重新打包即可覆盖游戏资源。

它允许你用自己的修改版文件替换游戏存档中的原有文件。
它还允许游戏从外部存档加载未打包的松散文件。

这意味着玩家可以通过复制文件来安装资源模组,模组作者在测试模型、贴图和游戏数据时也能更快速地迭代更新。

此插件功能
  • 从资源覆盖中加载 《仁王3》/模组.
  • 支持游戏正常反序列化的任意资源类型(模型、贴图、动画/数据文件等)。
  • 未覆盖时保持原版行为。
  • 多个模组修改同一文件时,提供确定的冲突处理方式。


实用之处

给玩家:
  • 通过简单的文件复制/删除即可安装或移除模组。
  • 无需执行存档重新打包流程。


给模组制作者:
  • 快速替换资源以进行预览/测试。
  • 对同一文件路径进行迭代,更快验证游戏内表现。
  • 避免因细微调整而重新打包整个游戏并重启客户端。
  • 结合存档解包与运行时日志,可更快定位目标资源ID。
  • 缩短模组制作中的完整开发循环(定位目标 → 编辑 → 测试 → 调整)。


安装
  • 确保已安装所需的《仁王3》插件加载器
  • 请提供需要翻译的文本内容。 LooseFileLoader.dll 至 《仁王3》/plugins/.
  • 创建 《仁王3》/mods/ 缺少物品。
  • 启动游戏一次以确认插件初始化。

使用(玩家)

  • 将模组文件放入 《仁王3》/mods/ 或 《仁王3》/模组/<模组名称>/
  • 开始游戏。
  • I see you haven't provided the specific text for translation. Could you please paste the game content you'd like me to translate? I'm ready to help with game localization. 

    /mods/0xA1B2C3D4.g1m

    /mods/MyModPack1/0x11A34982.g1t
    /mods/MyModPack1/0x7DC6EBD9.g1t

    /mods/MyModPack2/0x6E7A0710.g1t
    /mods/MyModPack2/0x695BBBFB.g1t
    /mods/MyModPack2/0xA0B0DD1D.g1m


冲突与加载顺序

当多个模组修改同一文件时,插件将按此确定顺序保留首个候选:
  • 文件直放于此 模组 root. 根目录/主界面
  • 然后是按字母顺序(不区分大小写)排列的一级子文件夹。


使用说明(模组作者)

《仁王3》g1m <-> g1t 映射表: 
《仁王3》模型贴图映射数据库

查找资源ID(RDB资源管理器 + 日志)
  • 你可以使用 RDB 浏览器 浏览/提取游戏档案中的资源。
  • 你可以使用这个脚本 g1t工具 将g1t/g1ts文件提取为DDS文件。
  • 运行时,LooseFileLoader 会将资源加载信息写入插件日志。
  • 模组制作者可通过这些日志条目识别资源ID(文件ID当前场景中正在读取的资产,将其从归档中导出并替换为散文件。
  • 工作流程:日志中识别ID → 从存档导出 → 编辑 → 放入 模组 在游戏中验证。


日志文件位置
  • 主要日志文件: C:\Users\<用户名>\Documents\LooseFileLoader.log
  • 日志记录器使用文件轮转机制,因此你可能会看到轮转生成的历史文件(例如 .1道歉了
  • 默认情况下,资源加载日志处于关闭状态。如需打印资源加载日志,请设置 EnableAssetLoadingLog=1 启用资源加载日志=1 进入 /plugins/LooseFileLoader.ini

迭代工作流
  • 在测试时保持文件名/路径不变,并覆盖文件内容。
  • 在游戏中触发资源重载(如场景重载、地图切换、装备/菜单刷新等)以预览更新内容。
  • 如果你添加了全新的覆盖文件(新哈希值),请重启游戏,以便启动时索引将它们包含在内。


卸载
  • 移除 LooseFileLoader.dll 来自 《仁王3》/plugins/.
  • 移除你在下方添加的所有文件 <Nioh3>/模组/ (可选)
  • 卸载后,游戏将恢复为原始安装包资源。

故障排除
  • 覆盖未加载:
    验证文件名主干是否为8位十六进制字符(0倍 (可选前缀),请确认文件位于 模组 根目录或一级子文件夹,并确认没有其他模组优先占用同一哈希值。
  • 崩溃或画面异常:
    替换的负载格式可能与目标资产类型不匹配。
  • 本次会话期间未检测到新增文件:
    重新开始游戏(索引在启动时构建)
  • 未加载资产日志 LooseFileLoader.log:
    确认 《仁王3》/插件/LooseFileLoader.ini 有 EnableAssetLoadingLog=1 下方 [松散文件加载器].

备注

  • 此插件不会重新打包归档文件,仅在哈希匹配时将读取重定向至散文件。


制作人员

使用 Xmod 解锁 仁王3 的全部潜力 — 今天就探索这些顶级 MOD!