Kanan 新版安装与使用指南
1. 项目目录结构及介绍
Kanan 新版是一个专为游戏《Mabinogi》重写的模组工具,采用 C++ 实现。以下是其主要的目录结构及其简要介绍:
- [master]分支: 虽然提到的主分支名,在文档撰写时可能已更改或被归档。
- [github/workflows]: 包含了GitHub Actions的工作流程文件,用于自动化构建等任务。
- [Core]: 核心代码模块,包含了主要的功能实现。
- [Kanan]: 直接与模组功能相关的代码。
- [Launcher]: 启动器相关代码,用于加载和管理模组。
- [Loader]: 加载器部分,负责将模组注入到《Mabinogi》游戏中。
- [Scripts]: 存放脚本或特定功能实现的文件夹。
- [clang-format], [coafile], [gitignore], [CMakeLists.txt]: 开发辅助文件,如代码格式化配置、忽略文件列表、构建系统配置。
- [LICENSE]: 许可证文件,该项目遵循的是Unlicense协议。
- [Mabinogi], [rcnet], [README.md], 其他源码及配置文件: 直接参与编译或与游戏逻辑紧密相关的文件。
2. 项目的启动文件介绍
-
Loader.exe: 项目的核心启动程序,作为管理员运行此文件至关重要。它自动检测《Mabinogi》的游戏进程,并将Kanan.dll注入其中。用户无需手动干预游戏进程即可激活模组功能。
操作步骤:
- 确保已经正确构建项目(在Release模式下)。
- 右键点击
Loader.exe
并选择“以管理员身份运行”。
3. 项目的配置文件介绍
尽管直接提及的配置文件不是特别突出,但通常这类项目会依赖CMakeLists.txt作为构建配置文件,以及潜在的自定义设置文件。在开发或特定场景下,可能需要调整CMakeLists.txt来改变编译选项或者查找路径。
-
CMakeLists.txt: 这是CMake的配置脚本,用于指导如何生成构建系统(例如Visual Studio解决方案或Makefile)。它包含了项目所需的库、目标、编译标志等关键信息。
-
潜在的配置文件: 项目运行过程中可能不需要用户直接编辑的配置文件,但开发者或高级用户可能会创建或修改某些设置文件以适应个性化需求。这些文件可能隐藏于特定的子目录中或由用户自行添加,例如对于环境设置或模组特性的开关。
构建与配置步骤摘要
- 准备开发环境: 确保拥有Visual Studio 2017-2022及CMake。
- 生成项目: 使用命令行,执行
cmake -B build -G "Visual Studio 17 2022" -A x64
来创建构建环境。 - 构建: 接着通过
cmake --build build --config Release
编译项目,然后使用cmake --install build --prefix out
安装。 - 运行: 在获得Loader.exe之后,以管理员身份运行它,享受Mabinogi游戏中的增强体验。
请注意,具体配置细节可能随项目更新而变化,建议参照最新版本的GitHub仓库说明进行操作。