CWTools 使用教程

1. 项目介绍

CWTools 是一个开源库，用于解析、编辑和验证 Paradox Interactive 游戏的脚本文件。它支持所有现代 Paradox Interactive 游戏，并且针对 .NET Standard 2.0 进行了优化。CWTools 提供了一套强大的工具，使得开发者能够更轻松地处理游戏内的脚本文件。

2. 项目快速启动

以下是一个简单的快速启动示例，展示如何使用 CWTools 加载、修改和打印一个事件文件。

首先，确保你已经安装了 .NET 环境。

然后，你可以使用以下 C# 代码来开始：

// 支持 UTF-8 编码
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

// 解析事件文件
var parsed = CWTools.Parser.CKParser.parseEventFile("./testevent.txt");
var eventFile = parsed.GetResult();

// 处理结果以获得更美观的格式
var processed = CK2Process.processEventFile(eventFile);

// 查找感兴趣的事件
var myEvent = processed.Events.FirstOrDefault(x => x.ID == "test.1");

// 添加 is_triggered_only = true
var leaf = new Leaf("is_triggered_only", Value.NewBool(true));
myEvent.AllChildren.Add(Child.NewLeafC(leaf));

// 输出
var output = processed.ToRaw;
Console.WriteLine(CKPrinter.printKeyValueList(output, 0));

输入文件示例：

namespace = test
#One event
country_event = {
id = test.1
desc = "test description"
}
#Another event
country_event = {
id = test.2
desc = "test 2 description"
}

输出文件示例：

namespace = test
#One event
country_event = {
is_triggered_only = yes
id = test.1
desc = "test description"
}
#Another event
country_event = {
id = test.2
desc = "test 2 description"
}

3. 应用案例和最佳实践

应用案例

• Stellaris 技术树：一个交互式技术树可视化工具，使用 CWTools 解析原版技术文件，并提取本地化信息。
• SC Mod Manager：一个模组管理器，使用 CWTools 解析和操作模组文件。

最佳实践

• 在处理大型脚本文件时，注意内存和性能优化。
• 使用 CWTools 提供的 API 文档和示例代码作为参考。

4. 典型生态项目

• Stellaris 技术树：通过 CWTools 提供的功能，开发者可以创建交互式的技术树，帮助玩家更好地理解游戏中的科技发展。
• SC Mod Manager：利用 CWTools 的解析和编辑能力，开发者可以创建强大的模组管理工具，简化玩家对游戏模组的管理过程。

以上就是 CWTools 的使用教程，希望对您的项目开发有所帮助。