5分钟上手Scarab：《空洞骑士》模组管理神器完全指南 🛡️

Scarab是一款专为《空洞骑士》玩家打造的开源模组管理工具，基于Avalonia框架开发，提供一站式模组安装、更新和冲突解决方案。通过直观的界面设计和智能依赖管理系统，即使是新手也能轻松驾驭各类模组，让你的圣巢冒险之旅更加丰富多彩。

为什么选择Scarab？三大核心竞争力

安全透明的开源架构

作为完全开源的项目，Scarab的源代码接受社区监督，杜绝恶意代码和隐私收集。所有功能免费开放，无任何付费墙或隐藏功能，让玩家使用更放心。核心依赖检查系统（实现于Scarab/Services/ReverseDependencySearch.cs）确保模组间和谐共存。

跨平台自适应能力

无论你使用Windows、macOS还是Linux系统，Scarab都能完美适配。程序会自动检测操作系统类型（定义在Scarab/Settings.cs的GamePlatform枚举），并优化相应的安装策略，例如Linux系统下会自动区分原生版与Proton兼容版游戏。

智能自动化体验

内置的游戏目录侦探系统能自动扫描常见安装路径（如Steam/steamapps/common/Hollow Knight），省去手动配置的麻烦。支持中文、英文、法文等多语言界面（语言资源文件位于Scarab/Resources.zh.resx等），并提供亮色/暗色主题切换（定义在Scarab/Models/Theme.cs）。

快速部署：两种安装方式任选

普通用户方案：直接运行

1. 访问项目仓库下载最新版本压缩包
2. 解压至任意目录（建议选择无中文路径）
3. 根据系统双击对应可执行文件：
   • Windows：直接运行Scarab.exe
   • macOS：进入Scarab.app/Contents/MacOS/目录运行Scarab
   • Linux：终端中执行chmod +x Scarab后运行

开发者方案：源码构建

1. 克隆项目代码库：

   git clone https://gitcode.com/gh_mirrors/sc/Scarab
   

2. 进入项目根目录：

   cd Scarab
   

3. 使用.NET SDK构建解决方案：

   dotnet build Scarab.sln
   

4. 构建完成后可在Scarab/bin/Debug目录找到可执行文件

初次使用：3步完成基础配置

游戏目录设置

启动Scarab后，程序会首先尝试自动检测《空洞骑士》安装位置。如果检测失败：

1. 点击主界面右上角齿轮图标打开设置
2. 在"游戏路径"选项卡点击"浏览"按钮
3. 导航至游戏安装目录（需包含hollow_knight_Data文件夹）
4. 点击"验证"按钮确认路径有效性

程序支持多种常见安装路径的自动扫描，包括Steam、GOG和Xbox Game Pass版本，Windows系统下还会检查注册表信息辅助定位。

个性化界面配置

在设置面板中完成个人偏好调整：

• 语言选择：支持中文、英文、法文、匈牙利文等多语言
• 主题切换：可在亮色/暗色模式间切换，跟随系统或手动指定
• 界面缩放：根据显示器分辨率调整UI元素大小，优化视觉体验

基础功能熟悉

主界面分为四个核心区域：

• 导航栏：切换不同功能模块（发现、已安装、更新、设置）
• 模组列表：显示当前分类下的模组，支持排序和筛选
• 详情面板：展示选中模组的详细信息、版本历史和依赖关系
• 操作区：提供安装/卸载/更新等快捷操作按钮

模组管理全攻略

发现与安装模组

Scarab提供三种灵活的模组获取方式：

浏览发现：在"发现"标签页中，系统会展示社区推荐的精选模组，按 popularity、更新日期或下载量排序。每个模组卡片显示关键信息：名称、作者、评分和大小，点击即可查看详情。

精准搜索：使用右上角搜索框可快速定位特定模组，支持按名称、作者或标签（如"地图"、"战斗"）筛选。搜索结果会实时更新，无需额外点击。

本地导入：通过"本地模组"按钮可导入已下载的.zip格式模组文件。程序会自动验证文件完整性，并检查与当前游戏版本的兼容性。

高级管理技巧

掌握这些技巧让模组管理更高效：

批量操作：按住Ctrl键（macOS为Cmd键）可多选模组，实现一键批量安装/卸载。特别适合重新安装游戏后快速恢复模组配置。

版本控制：每个模组的详情页都提供"历史版本"选项，可查看所有可用旧版本并随时切换。当新版本存在兼容性问题时非常实用。

依赖可视化：在模组详情页的"依赖Mods"部分（XAML_Dependencies资源项定义），可查看该模组所依赖的其他模组以及依赖它的模组，用层级结构清晰展示关系网络。

冲突解决方案：当安装可能冲突的模组时，系统会显示红色警告图标。点击图标可查看冲突原因和建议解决方案，如禁用冲突模组或安装特定兼容版本。

问题诊断：常见故障排除指南

路径设置问题

若收到"无效的空洞骑士路径"错误（PU_InvalidPath资源项）：

1. 确认所选目录包含hollow_knight_Data文件夹
2. 检查路径中是否有中文或特殊字符
3. 尝试以管理员权限运行Scarab
4. 手动指定完整路径，如D:\Games\Hollow Knight

安装失败处理

当模组安装失败时，可按以下步骤排查：

1. 确保《空洞骑士》已完全关闭（包括后台进程）
2. 检查网络连接，部分模组需要在线下载依赖
3. 在设置中开启日志显示，查看具体错误信息
4. 尝试清除缓存（设置→高级→清除下载缓存）

性能优化建议

如果Scarab运行缓慢：

1. 减少同时启用的模组数量（过多模组会增加加载时间）
2. 在设置中降低"预览图质量"
3. 定期清理不再使用的模组安装包
4. 确保程序所在硬盘有至少1GB可用空间

模组推荐：打造个性化游戏体验

新手必备组合

探索增强包：

• Map Markers：在地图上显示未探索区域和关键物品
• ItemChanger：自定义物品位置和获取方式
• Quick Cast：优化法术施法操作，支持快捷键

难度调整包：

• Debug Mod：提供无敌、飞行等调试功能，适合探索
• Save State：添加快速存档/读档功能，减少重复探索
• Simple Charms：简化护符系统，降低入门门槛

进阶玩家之选

随机挑战组合：

• Randomizer 4：随机化游戏内所有物品位置
• RandoSettingsManager：自定义随机化规则和难度
• Practice Tool：添加练习模式，可自由设置测试场景

视觉增强组合：

• Skin Customizer：自定义主角外观和颜色
• Better Menus：美化游戏菜单界面，支持自定义背景
• Particle Tweaks：增强游戏粒子效果，提升视觉体验

参与贡献：让工具更完善

Scarab的成长离不开社区支持，你可以通过以下方式参与：

报告问题

遇到bug或功能问题时：

1. 在项目仓库提交issue，详细描述问题现象
2. 附上相关日志文件（可在设置中导出）
3. 提供系统信息和复现步骤

翻译支持

帮助完善多语言支持：

1. 复制Resources.resx创建新的语言文件（如Resources.de.resx）
2. 翻译其中的字符串资源
3. 提交PR到项目仓库

代码贡献

开发者可关注以下核心模块：

• 依赖管理系统：Scarab/Services/ReverseDependencySearch.cs
• 安装逻辑：Scarab/Services/Installer.cs
• 界面组件：Scarab/Views/目录下的AXAML文件

总结：释放《空洞骑士》无限可能

Scarab作为一款专注于《空洞骑士》的模组管理工具，通过直观的界面设计和智能的后台处理，让每个玩家都能轻松享受模组带来的游戏增强体验。无论是想简化探索难度、添加新内容，还是彻底改变游戏玩法，Scarab都能成为你探索圣巢的得力助手。

记住，模组社区的活力在于分享与互助。发现有趣的模组组合？遇到实用的使用技巧？欢迎在社区中分享，让更多玩家享受定制化游戏的乐趣！现在就启动Scarab，开启你的个性化《空洞骑士》冒险吧！