如何使用IronyModManager：Paradox游戏模组管理指南

欢迎来到IronyModManager的世界！这是一款专为Paradox系列游戏打造的开源模组管理工具 🎮，能帮你轻松搞定模组安装、冲突解决和版本管理等麻烦事。无论你是刚接触模组的新手，还是资深玩家，这款工具都能让你的游戏体验更顺畅。

项目结构速览

IronyModManager的文件组织清晰直观，就像一个整理得井井有条的工具箱 🧰。让我们快速了解几个核心目录：

• src/：存放所有源代码的"心脏地带"，应用程序的核心功能都在这里实现
• publish/：包含各种平台的发布脚本，帮你把程序打包成可执行文件
• cmd/：命令行工具集合，像清理解决方案、复制依赖这些杂活都能一键搞定
• References/：项目依赖的第三方库，相当于工具需要的"零件箱"

核心目录解析

源代码目录 (src/)

这是项目最核心的部分，就像汽车的发动机舱 🔧：

• IronyModManager/：主应用程序目录，包含界面和主要逻辑
• IronyModManager.Common/：通用功能模块，比如扩展方法和辅助工具
• IronyModManager.Parser/：模组解析器，负责读懂各种模组文件
• IronyModManager.Services/：业务逻辑层，处理各种复杂操作

工具和脚本目录

除了源代码，这些目录也很实用：

• cmd/：命令行脚本集合，比如clean-solution-full.bat可以彻底清理项目
• publish/：发布相关脚本，支持Windows、Linux和macOS等多个平台
• Tools/：辅助工具，比如本地化资源生成器

关键文件详解

解决方案文件 (IronyModManager.sln)

这是整个项目的"总开关" 🔌，用Visual Studio或 Rider打开它，就能看到所有项目结构。新手开发者第一步就是打开这个文件。

版本配置文件 (version.json)

这个简单的JSON文件记录着项目版本号：

{
  "version": "1.26.184"
}

就像给项目贴上的"出生证明"，每次发布新版本都会更新这里。

启动入口 (App.xaml.cs)

应用程序的"起跑线" 🏁，包含了程序启动时的初始化逻辑：

protected override void OnStartup(StartupEventArgs e)
{
    base.OnStartup(e);
    // 应用程序启动逻辑
}

当你双击程序图标，就是从这里开始执行代码。

如何开始使用

获取源代码

首先，你需要把项目"搬"到自己的电脑上：

git clone https://gitcode.com/gh_mirrors/ir/IronyModManager

构建项目

进入项目目录后，用命令行工具执行构建命令。根据你的系统选择合适的发布脚本，比如在Windows上可以运行：

cd publish
publish-win-x64.bat

运行应用程序

构建完成后，在生成的输出目录里找到可执行文件，双击就能启动IronyModManager啦 🚀

配置文件详解

NuGet配置 (nuget.config)

这个文件告诉项目去哪里下载需要的"零件"（第三方库）：

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
</packageSources>

就像给项目配了一张"购物清单"，确保能找到所有需要的依赖。

命令行工具集 (cmd/)

这里有几个超实用的小工具：

• clean-solution-full.bat：彻底清理项目，解决编译问题的"急救箱"
• copy-dependencies.bat：自动复制依赖文件，省去手动操作的麻烦
• update-versioning.bat：更新版本号，让发布更规范

常见问题解决

编译出错怎么办？

试试这几步：

1. 运行cmd/clean-solution-full.bat清理项目
2. 检查References/目录是否有缺失的依赖
3. 确认你的开发环境是否安装了.NET SDK

如何贡献代码？

1. Fork项目仓库（如果你有权限）
2. 创建新的分支进行开发
3. 提交PR前确保所有测试通过
4. 详细描述你的修改内容

IronyModManager作为一款开源项目，欢迎所有人参与改进和完善。无论是修复bug、添加新功能，还是改进文档，你的每一个贡献都很有价值 💪

希望这篇指南能帮你快速了解IronyModManager！现在就去试试，让模组管理变得轻松愉快吧！