OpenKH/OpenKh

旨在将“Kingdom Hearts”游戏系列的所有技术知识集中于一处，提供文档、工具、代码库以及修改商业游戏的基础。 [](https://github.com/OpenKH/OpenKh/actions/workflows/dotnet.yml) ## 文档 所有文档的原始形式均位于 `/docs` 文件夹中。更适合网页浏览的版本可在此处访问：[https://openkh.dev/](https://openkh.dev/) ## 下载 每当贡献者审查并批准一项新提议的功能或修复时，OpenKH 都会自动生成新的构建。这些构建被认为是稳定的，因为它们是从 `master` 分支构建的。构建中使用的版本格式为 `YEAR.MONTH.DAY.BUILDID`。 [](https://github.com/OpenKH/OpenKh/releases) 所有来自 `master` 分支和 Pull Request 的构建均由 [GitHub Actions](https://github.com/OpenKh/OpenKh/actions) 生成。 OpenKH 工具需要安装 [.NET 8.0 Runtime](https://dotnet.microsoft.com/download/dotnet/8.0)。所有的 UI 工具专为在 Windows 上运行而设计，而命令行工具则可在任何操作系统上运行。

注意：所有的 CLI 和 GUI 程序**理应**都是跨平台的，尽管广泛的测试主要在 Windows 系统上进行。因此，用户可能需要在 Linux、Mac、BSD 等系统上通过 WINE 前缀来运行 GUI 程序。 注意：自 `OpenKH Build 1446 (master)`（2025年9月16日发布）起，OpenKH 已将框架从 .NET 6.0 更改为 .NET 8.0。 ## OpenKH 深入了解

从架构的角度来看，代码结构旨在将低级实现（如文件解析器和基础逻辑）抽象为高级功能（如 3D 渲染或工具）。项目采用分层设计，以便尽可能多地共享代码，同时又相互隔离以避免耦合。 从社区的角度来看，OpenKH 将提供最佳形式的文档、Mod 门户以及由此衍生的同人游戏支持。 ## 从源代码构建 最低要求是 [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0)。下载仓库后，需要执行 `build.ps1` 或 `build.sh`。具体执行哪一个取决于您使用的操作系统。此外，对于喜欢在 Windows 下使用 IDE 环境的用户，您始终可以在 Visual Studio 中打开包含的解决方案文件 `OpenKh.sln`，并通过 `Build` 菜单进行编译。 ## 附加信息 ### 未来计划 * 提供功能全面且用户友好的 Mod 制作工具链。 * 通过审核系统集中提供 Mod 下载。 * 为 Mod 用户和创作者提供一个友好的环境。 * 创建一个社区网站和论坛，让用户能够自由互动，并在使用 OpenKH 工具和文档进行修改时互相帮助。 * 创建一个与零售游戏资产兼容的自定义游戏引擎。 ### 贡献 这里有一份[指南](CONTRIBUTING.md)，描述了如何联系团队并为项目做出贡献。 ### 许可证 本仓库的全部内容受 Apache 2.0 许可证保护。该许可证的一些要点如下： * 您**可以**复制、修改和分发本软件。 * 您**可以**私下使用本软件。 * 您**可以**将本软件用于商业目的。 * 如果主仓库中存在 "NOTICE" 文件，您**可以**向其追加内容。 * 您**不能**追究仓库任何贡献者的损害赔偿责任。 * 您**不能**更改或以其他方式修改源仓库中的任何专利、商标和归属声明。 * 您**必须**指出对代码所做的更改（如果有）。 * 如果原始仓库中包含 NOTICE 文件，您**必须**在每次分发中都包含相同的 NOTICE 文件。 * 您**必须**在每次分发和派生项目中包含许可证和版权声明。 * 对此代码库的任何修改**绝对必须**以相同的许可证（Apache 2.0）进行分发。

标签：DNS解析, GUI工具, Kingdom Hearts, Modding, .NET 8.0, WINE, 代码库, 开源游戏工具, 开源项目, 文件解析, 文档, 游戏修改器, 游戏开发, 游戏引擎, 游戏技术知识库, 游戏模组, 游戏逆向工程