N64: Recompiled - 重构N64二进制代码的利器

项目介绍

N64: Recompiled 是一个用于将N64二进制文件静态重编译为C代码的工具。通过这一工具，开发者可以将N64游戏或其他N64二进制文件转换为可在任何平台上编译的C代码。这一功能不仅适用于游戏移植或工具开发，还能显著提升模拟器的运行速度，远超传统的解释器或动态重编译方法。此外，该工具还支持在独立环境中运行N64二进制文件的特定部分，极大地扩展了其应用场景。

项目技术分析

N64: Recompiled 的核心技术在于静态重编译。它通过接受一组符号和元数据，将输入的二进制文件分割成多个函数，并将每个函数单独重编译为C代码。指令的处理过程是逐条进行的，每条指令都会生成相应的C代码。这种翻译方式非常直观，旨在降低复杂性。例如，指令 addiu $r4, $r4, 0x20 会被重编译为 ctx->r4 = ADD32(ctx->r4, 0X20);。此外，工具还支持处理分支延迟槽、跳转指令等特殊情况，并尝试将某些指令转换为更高效的C代码结构，如将 jr 指令转换为 switch-case 语句。

重编译后的C代码可以与任何C编译器兼容，并且需要一个运行时环境来提供必要的功能和宏实现。项目还提供了 N64ModernRuntime 运行时库，该库已在 Zelda 64: Recompiled 项目中得到应用。

项目及技术应用场景

N64: Recompiled 的应用场景非常广泛：

1. 游戏移植：将N64游戏移植到其他平台，如PC、移动设备等。
2. 工具开发：开发与N64相关的工具或模拟器，提升运行效率。
3. 独立环境运行：在独立环境中运行N64二进制文件的特定部分，适用于研究、测试等场景。
4. 性能优化：通过静态重编译，显著提升模拟器的运行速度，超越传统的解释器或动态重编译方法。

项目特点

N64: Recompiled 具有以下显著特点：

1. 静态重编译：将N64二进制文件直接转换为C代码，便于在任何平台上编译和运行。
2. 高效翻译：指令翻译过程直观且高效，支持多种特殊指令的处理。
3. 灵活配置：通过TOML文件配置重编译行为，支持自定义符号、跳过特定函数重编译等功能。
4. 支持重定位：处理静态链接和可重定位的覆盖层，支持运行时函数查找和重定位。
5. 单文件输出模式：支持将所有函数输出到单个文件，便于快速迭代和打补丁。
6. RSP微代码支持：未来将支持RSP微代码的重编译，进一步扩展应用场景。

N64: Recompiled 是一个功能强大且灵活的工具，适用于多种N64二进制文件的处理和优化。无论是游戏开发者、模拟器开发者还是研究者，都能从中受益。快来尝试这个开源项目，体验静态重编译的魅力吧！