文件清理工具

文件清理工具

File Janitor 保持 Valheim 的 BepInEx 文件夹整洁:它会删除已卸载模组遗留的文件,并让每个模组的配置保持最新,且事先备份每个文件。

[color=#FFDA00]适用于 BepInEx 的 Valheim。客户端。[/color]


⭐ 功能

  • 移除的模组不留痕迹 —— 每次启动时,在任何模组加载之前,它见过的已移除模组的文件会移入其备份;被模组管理器禁用的模组仍视为已安装。
  • 列出无主文件 —— 没有已安装模组使用的文件会显示在“启动时发现”下,可删除、备份或忽略;开启“移动无主文件”可自动备份这些文件。
  • 更新后生成全新配置 —— 当模组版本变化时,其配置会被备份,模组会在该次启动时写入新配置,并保留所有仍然存在的设置。
  • 更新报告 —— 对于更新后刷新的配置,菜单会显示哪些设置被保留、哪些被丢弃、哪些是该版本新增的。
  • 过时设置 —— 一旦你在安装该模组的情况下游玩过世界,此后没有任何已安装模组读取过的设置会按配置文件列出;“清理”会备份配置,然后移除它们。
  • 重复模组 —— 安装两次的插件,或两个文件夹中的相同 dll,会在每个副本上标记,以便你删除或备份多余的那个。
  • 缓存清理 —— BepInEx\cache 中的每个文件夹和文件(BepInEx 自身的除外)都会列出其大小,可随时删除;其所属模组会重建所需内容。
  • 一切都会备份 —— 它移动或替换的每个文件都会进入 BepInEx\FileJanitor\Backups,菜单中的“还原”可将其放回原处,从菜单中删除的任何内容都会进入回收站。
  • 一个菜单管理全部 —— 主菜单上的“File Janitor”按钮,或在该处按 Ctrl+F1,会列出所有发现、已备份或已保留的内容,并可对单个文件或多个勾选的文件执行操作。
  • 等待计数 —— 按钮会显示有多少文件在等待你处理,例如 File Janitor (3)。
  • 立即重新扫描 —— 无需重启 Valheim,即可从菜单再次检查 BepInEx 文件夹;它只列出发现的内容,不会移动任何文件。
  • 忽略与永不触碰 —— 可忽略任何发现的文件、重复项、过时配置或缓存,并从“已忽略”组中恢复;列入“永不触碰”的路径不会被处理。
  • 备份整理 —— 菜单会显示备份占用的空间;“X 天后删除备份”或“删除旧备份”会将较旧的备份送入回收站。
  • 更新提示 —— 每次游戏启动时向 alkeari.com 查询其最新版本,仅当有新版本发布时在左上角提示。不会发送其他内容;“更新提示”可将其关闭。

📋 需求

  • 适用于 Valheim 的 BepInExPack。
  • 已在 Valheim 1.0.20 上验证。

📥 安装

  • 先安装适用于 Valheim 的 BepInExPack。
  • 将下载的 zip 解压到 Valheim 的游戏文件夹,使其包含 BepInEx\plugins\FileJanitor\FileJanitor.dll 和 BepInEx\patchers\FileJanitor\FileJanitor.Preloader.dll。

要更新,请将新 zip 解压覆盖旧版本。

⚙️ 配置

每项行为均可在 BepInEx\config\alkeari.valheim.filejanitor.cfg 中或通过配置管理器开启或调整:

  • 移动已移除模组的孤立文件(开)、移动无主文件(关)、永不触碰(空),例如 config/MyMod.cfg。
  • 更新后刷新配置(开)。
  • 查找过时设置、查找重复模组、列出缓存(均开)、读取设置检查秒数(60)。
  • X 天后删除备份(0,永不)。
  • 显示主菜单按钮、显示等待计数(均开)、文件夹预览行数(10)、每格滚轮滚动行数(3)、打开菜单(Ctrl+F1)。
  • 记录每个文件(开)。
  • 更新提示(开)、更新提示延迟秒数(10)、更新提示文本。

🖥️ 兼容性

  • 客户端:仅你需要它,服务器不需要。
  • 它仅在 BepInEx 文件夹中移动和备份文件,绝不会涉及世界或角色。

🐛 支持

  • 请在本页面的“Bugs”标签页报告错误,在“Posts”标签页提问。
  • 请附上你的游戏版本、模组版本以及你安装的其他模组。

📄 许可证

许可证条款见 Alkeari 许可协议。

每个版本、其更改以及如何发送反馈均见项目页面 alkeari.com/projects/file-janitor。

如果你想了解其工作原理,可以在 github.com/Alkeari/FileJanitor-PUBLIC 阅读源代码。