KKManager 使用指南：从入门到精通

KKManager 使用指南：从入门到精通

【免费下载链接】KKManagerMod, plugin and card manager for games by Illusion that use BepInEx项目地址: https://gitcode.com/gh_mirrors/kk/KKManager

核心功能概览：为什么选择 KKManager？

KKManager 是一款专为 Illusion 系列游戏（如 Koikatu）设计的模组与卡片管理工具，核心功能围绕三大场景展开：

模组管理：如何高效组织游戏扩展内容？

功能定位：整合模组安装、更新与冲突检测
使用场景：当你需要同时管理数十个模组时，避免手动复制文件导致的覆盖问题
操作建议：通过主界面的「模组分类标签」快速筛选不同类型的扩展内容，支持批量启用/禁用

卡片管理：如何有序存储角色数据？

功能定位：提供角色卡片的导入、预览与重命名工具
使用场景：从社区获取新角色卡片后，需要快速预览效果并归类存储
操作建议：利用「卡片信息查看器」核对角色属性，通过「批量重命名」功能统一命名格式

自动更新：如何保持工具与模组最新状态？

功能定位：后台检测并更新工具本体及已安装模组
使用场景：希望及时获取新功能与兼容性修复，但不想手动检查更新
操作建议：在设置中开启「自动更新」后，工具会在启动时自动完成升级

操作流程详解：从零开始使用 KKManager

第一步：如何获取并启动 KKManager？

1. 克隆项目仓库到本地：
   git clone https://gitcode.com/gh_mirrors/kk/KKManager
2. 进入项目目录后，编译生成可执行文件（需 .NET 环境支持）
3. 运行bin目录下的KKManager.exe启动程序

⚠️注意：首次启动时会提示选择游戏目录，请确保路径正确指向 Illusion 游戏根文件夹（如C:\Games\Koikatu）

第二步：如何安装与管理模组？

1. 通过「模组安装」按钮选择本地 zip/7z 格式的模组文件
2. 工具会自动检测模组兼容性并显示安装路径
3. 在「已安装模组」列表中，可通过右键菜单执行更新/卸载操作

💡技巧：启用「模组冲突检测」功能，会自动标记可能存在冲突的文件并提供解决方案

第三步：如何导入与管理角色卡片？

1. 在「卡片管理」标签页点击「导入」，选择.png格式的角色卡片文件
2. 使用「预览窗口」查看角色信息，确认无误后点击「保存」
3. 通过「分类标签」对卡片进行分组，支持按游戏版本/角色类型筛选

配置指南：如何自定义 KKManager 功能？

关键配置文件在哪里？

程序配置存储在项目根目录的settings.json文件中，主要配置项如下：

如何修改高级配置？

1. 关闭 KKManager 程序
2. 用文本编辑器打开settings.json
3. 修改对应配置项后保存文件
4. 重新启动程序使配置生效

⚠️注意：修改配置文件前建议备份原文件，避免格式错误导致程序无法启动

常见问题速查

Q1：启动程序时提示「游戏目录未找到」怎么办？

A：检查settings.json中的game_directory路径是否正确，确保指向包含游戏可执行文件的文件夹

Q2：模组安装后游戏内不生效如何解决？

A：1. 确认模组与游戏版本兼容
2. 在「模组管理」中检查模组是否已启用
3. 尝试通过「修复安装」功能重新部署模组文件

Q3：如何迁移 KKManager 配置到新电脑？

A：将原安装目录下的settings.json和cards文件夹复制到新电脑的对应路径即可保留所有配置与卡片数据

功能开发核心区：了解项目结构（进阶用户）

对于希望自定义或贡献代码的用户，项目的源代码组织如下：

• 功能开发核心区（src）：包含所有源代码文件，按模块划分为 KKManager、KKManager.Core 等子项目
• 依赖库区（libs）：存放第三方组件，如 SB3UGS 相关工具库
• 测试区（Tests）：单元测试代码，确保功能稳定性

💡技巧：修改代码前建议先查看make_release.ps1脚本，了解编译发布流程

【免费下载链接】KKManagerMod, plugin and card manager for games by Illusion that use BepInEx项目地址: https://gitcode.com/gh_mirrors/kk/KKManager