|
|
转自n网：https://www.nexusmods.com/nioh3/mods/90
Loose File Loader lets Nioh 3 load loose files directly from disk, so you can override assets without repacking archives.
Loose File Loader 允许《仁王 3》直接从磁盘加载松散文件，这样你可以覆盖资源而不需重新打包归档。
It allows you to replace files stored in the game's archives with your own modded versions.
它允许你用自己修改过的版本替换游戏存档中存储的文件。
It also allows the game to load unpacked, loose files from outside game archives.
它还允许游戏加载来自外部游戏档案的解压松散文件。
This means players can install asset mods by copying files, and mod authors can iterate much faster when testing models, textures, and gameplay data.
这意味着玩家可以通过复制文件来安装素材模组，模组作者在测试模型、纹理和游戏数据时可以更快地迭代。
What This Plugin Does 这个插件的作用
- Loads asset overrides from <Nioh3>/mods.
加载资产覆盖，来源于 <Nioh3>/mods。 - Supports any asset type that the game can normally deserialize (models, textures, animation/data files, etc.).
支持游戏通常可以反序列化的任何资产类型（模型、纹理、动画/数据文件等）。 - Keeps vanilla behavior when no override exists.
当没有覆盖时，保持原版行为。 - Provides deterministic conflict handling when multiple mods modify the same file.
当多个模组修改同一个文件时，提供确定性冲突处理。
Why It Is Useful 它的实用性
For players: 给玩家：
- Install or remove mods with simple file copy/delete.
通过简单的文件复制/删除安装或移除模组。 - No archive repack workflow required.
不需要归档重新打包的工作流程。
For modders: 对于模组制作者：
- Replace assets quickly for preview/testing.
快速替换资源以便预览和测试。 - Iterate on the same file path and validate in-game behavior faster.
在同一条文件路径上进行迭代，并更快地验证游戏内的行为。 - Avoid full package rebuild + full game restart for every small tweak.
避免每次小调整都重构全包+重启游戏。 - Combine archive extraction and runtime logging to locate target resource IDs faster.
结合归档提取和运行时日志，以更快地定位目标资源 ID。 - Shorten the full dev loop (find target -> edit -> test -> adjust) during mod creation.
在创建模组时缩短完整的开发循环（寻找目标 -> 编辑 -> 测试 ->调整）。
Installation 安装
- Ensure the required Nioh 3 plugin loader is installed
确保安装了所需的《仁王3》插件加载器 - Copy LooseFileLoader.dll to <Nioh3>/plugins/.
把 LooseFileLoader.dll 复制到 <Nioh3>/plugins/。 - Create <Nioh3>/mods/ if missing.
如果缺少，可以创建 <Nioh3>/mods/。 - Launch the game once to confirm the plugin initializes.
启动游戏一次确认插件是否初始化。
Usage (Players) 使用情况（球员）
- Put mod files in <Nioh3>/mods/ or <Nioh3>/mods/<ModName>/
把 mod 文件放在 <Nioh3>/mods/ 或 <Nioh3>/mods/<ModName>/ - Start the game. 开始游戏。
- Example: 示例：
/mods/0xA1B2C3D4.g1m
/mods/MyModPack1/0x11A34982.g1t
/mods/MyModPack1/0x7DC6EBD9.g1t
/mods/MyModPack2/0x6E7A0710.g1t
/mods/MyModPack2/0x695BBBFB.g1t
/mods/MyModPack2/0xA0B0DD1D.g1m
Conflict and Load Order 冲突与加载顺序
If multiple mods modify the same file, the plugin keeps the first candidate in this deterministic order:
如果多个模组修改了同一个文件，插件会按照确定性顺序保留第一个候选文件：
- Files directly inside mods root.
模组里直接有文件，root。 - Then first-level subfolders, sorted alphabetically (case-insensitive).
然后是一级子文件夹，按字母顺序排序（不区分大小写）。
Usage (Mod Authors) 使用情况（模组作者）
Finding Resource IDs (RDB Explorer + Logs)
查找资源 ID（RDB 资源管理器+日志）
- You can use RDB Explorer to browse/extract assets from game archives.
你可以用 RDB Explorer 浏览/提取游戏归档中的资源。 - LooseFileLoader writes runtime asset-loading information to the plugin log while the game is running.
LooseFileLoader 在游戏运行时将运行时资产加载信息写入插件日志。 - Modders can use these log entries to identify resource IDs (fileId) that are actively read in the current scene, then export those assets from archives and replace them as loose files.
模组制作者可以利用这些日志条目识别当前场景中被主动读取的资源 ID（fileId），然后从归档中导出这些资源，并将其替换为散乱文件。 - Workflow: identify ID in logs -> export from archive -> edit -> drop into mods -> verify in game.
工作流程：在日志中识别 ID——> 从档案导出——> 编辑——>，放入模组，-> 在游戏中验证。
Log File Location 日志文件位置
- Main log file: C:\Users\<YourUserName>\Documents\LooseFileLoader.log 主日志文件： C:\Users\<YourUserName>\Documents\LooseFileLoader.log
- The logger uses file rotation, so you may also see rotated history files (for example .1).
日志记录器使用文件轮换，所以你也可能看到旋转过的历史文件（例如 .1）。 - Asset loading logs are disabled by default. To print resource loading logs, set EnableAssetLoadingLog=1 in /plugins/LooseFileLoader.ini
资产加载日志默认是被禁用的。要打印资源加载日志，请在 /plugins/LooseFileLoader.ini 中设置 EnableAssetLoadingLog=1
Iteration Workflow 迭代工作流程
- Keep the same filename/path and overwrite file contents while testing.
保持相同的文件名/路径，测试时覆盖文件内容。 - Trigger asset reload in-game (scene reload, map change, equipment/menu refresh, etc.) to preview updates.
在游戏内触发资源加载（场景加载、地图切换、装备/菜单刷新等），以预览更新。 - If you add entirely new override files (new hashes), restart game so startup indexing includes them.
如果你添加了全新的覆盖文件（新的哈希），请重启游戏，这样启动索引时也包含这些。
Uninstall 卸载
- Remove LooseFileLoader.dll from <Nioh3>/plugins/.
把 LooseFileLoader.dll 从 <Nioh3>/plugins/ 中移除。 - Remove any files you added under <Nioh3>/mods/ (optional).
删除你在 <Nioh3>/mods/（可选）下添加的文件。 - After uninstall, the game falls back to original packaged assets.
卸载后，游戏会回到原始的打包资源。
Troubleshooting 故障排除
- Override not loading: 覆盖未加载：
Verify filename stem is exactly 8 hex digits (0x prefix optional), verify file is in mods root or a first-level subfolder, and verify another mod is not taking precedence for the same hash.
Verify 文件名词干正好是 8 位十六进制（ 前缀可选），验证文件在 mod 的根目录或一级子文件夹中，并且 verify 另一个 mod 没有优先处理同一哈希值。 - Crashes or broken visuals:
崩溃或画面损坏：
Replacement payload format may not match the target asset type.
替换有效载荷格式可能与目标资产类型不匹配。 - Added file not detected during current session:
当前会话中未检测到新增文件：
Restart game (index is built at startup).
重启游戏（索引在启动时构建）。 - No asset loading logs in LooseFileLoader.log:
LooseFileLoader.log 中没有资产加载日志：
Make sure <Nioh3>/plugins/LooseFileLoader.ini has EnableAssetLoadingLog=1 under [LooseFileLoader].
确保 <Nioh3>/plugins/LooseFileLoader.ini 在 [LooseFileLoader] 下设置了 EnableAssetLoadingLog=1。
Notes 注释
- This plugin does not repack archive files; it only redirects reads to loose files when hashes match.
该插件不会重新打包归档文件;只有当哈希匹配时，它才会将读取重定向到松散的文件。
Credits 制作人员
|
|
发表于 2026-2-25 08:42
收藏
楼主