加入Banjo: Recompiled社区：Discord、Thunderstore与项目贡献完整指南
【免费下载链接】BanjoRecompPC Port of Banjo-Kazooie made using N64: Recompiled (Windows/Linux/Mac)项目地址: https://gitcode.com/gh_mirrors/ba/BanjoRecomp
Banjo: Recompiled（BanjoRecomp）是一个开源的《Banjo-Kazooie》PC 移植项目，基于 N64: Recompiled 静态重编译技术，让这款 N64 经典游戏以原生方式运行在 Windows、Linux 和 Mac 上，并支持高帧率、宽屏、MOD 加载等大量增强功能。本文是一份面向新手的完整指南：如何加入官方 Discord 社区、如何在 Thunderstore 获取和使用 MOD，以及如何从零开始为项目贡献代码 🐵
项目概览：Banjo: Recompiled 值得加入吗？
在加入社区之前，先花一分钟了解这个项目的核心能力：
- 静态重编译：将 N64 游戏代码直接编译为原生 PC 代码，无需模拟器和 ROM 提取步骤
- 高帧率 + 宽屏：任意刷新率、任意宽高比，游戏 HUD 和过场动画均已适配 16:9
- MOD 支持：社区 MOD 可改变游戏的任何部分，包括添加全新内容
- 低输入延迟、即时加载：得益于在现代硬件上原生运行
- 跨平台：Windows、Linux（含 Steam Deck）、macOS 均有预构建版本
完整的特性列表与系统要求见 README.md。项目采用GPL-3.0+开源协议，协议全文见 COPYING。
💡提示：项目仓库和发布包不包含游戏素材，运行需要你自己拥有的美版 1.0《Banjo-Kazooie》。
加入 Discord 社区：新手找答案的第一步
Banjo: Recompiled 的讨论氛围集中在两个 Discord 服务器，都是免费加入：
1. N64: Recompiled 社区 Discord（主服务器）
这是整个 N64: Recompiled 生态的总社区，也是 Banjo: Recompiled 玩家的大本营。适合在这里：
- 报告游戏崩溃、图形异常等Bug
- 询问配置问题（比如存档位置、控制器映射、Steam Deck 设置）
- 讨论新特性开发进度（例如规划中的 RT64 光线追踪）
- 寻找同好组队、分享高分帧率宽屏游玩体验
加入方式：在 Discord 中搜索服务器名称N64 Recomp，或直接使用 README.md 顶部给出的官方邀请入口即可。
2. N64: Recompiled Modding Discord（MOD 开发专用）
如果你不只是"玩 MOD"，还想"做 MOD"，这里是正确的去处：
- 官方 MOD 模板的用法答疑
- 纹理包（Texture Pack）开发讨论
- 与其他 MOD 作者互相 review 代码
两个服务器的入口都写在 README.md 的Mod Support章节中，直接前往即可。
在 Thunderstore 获取 MOD：最快上手方法
Banjo: Recompiled 的官方 MOD 发布渠道是Thunderstore上的banjo-recompiled分类页。对新手来说，只需要记住这三点：
- 直接从网站下载：项目不需要也不支持r2modman 这类 MOD 管理器，下载 MOD 文件即可
- 安装 MOD 只需拖拽：把 MOD 文件直接拖到游戏窗口上（开始游戏前），或点击 MOD 菜单里的Install Mods按钮
- 随时开关：所有已安装 MOD 都可以在 MOD 菜单中启用/禁用，部分 MOD 还支持菜单内配置
MOD 可以改变游戏的任何部分——从简单的美术替换到添加全新玩法内容。想深入了解 MOD 机制，可以查看 README.md 中 Mod Support 一节列出的 MOD 模板与 MOD 文档。
项目贡献入门：从本地构建到提交补丁
Banjo: Recompiled 欢迎社区贡献者！但在动手之前，请务必先了解下面两个部分。
贡献红线：禁止提交 AI 生成的代码 ⚠️
CONTRIBUTING.md 中有本仓库最显眼的一条规则：严禁使用任何生成式 AI 工具（如 ChatGPT、Claude、Copilot 等）生成贡献代码，违规提案会被直接拒绝。
项目方给出了三点理由：
- AI 生成代码的来源不明，可能与 GPL-3.0+ 协议不兼容
- AI 往往给出"看起来能跑"实则引入回归的脆弱方案
- 本项目的核心目标是精确复现 N64 硬件行为，需要大量针对目标平台的严谨测试与验证，而这正是当前所有 AI 模型的盲区
换句话说：请带着你对 N64 架构的理解来贡献，而不是粘贴大模型的输出。
本地构建项目：贡献者的第一步
构建指南详见 BUILDING.md，完整流程如下（无需构建也能直接玩预构建版本，但贡献者必须能本地构建）：
第 1 步：克隆仓库（含子模块）
git clone --recurse-submodules https://link.gitcode.com/i/7eff0cfcd36186693fdbc702145a57f0第 2 步：安装依赖
- Linux（Ubuntu 示例）：
sudo apt-get install cmake ninja-build libsdl2-dev libgtk-3-dev lld llvm clang - Windows：Visual Studio 2022（勾选 C++ 桌面开发、Clang 编译器、CMake 工具）+
make
第 3 步：解压目标 ROM
解压美版 NTSC-U 1.0 ROM 并重命名为banjo.us.v10.decompressed.z64，放到仓库根目录。
第 4 步：生成 C 代码
构建 N64Recomp 依赖的重编译工具后，在仓库根目录运行：
./N64Recomp banjo.us.rev0.toml ./RSPRecomp n_aspMain.us.rev0.toml其中重编译配置文件就是仓库根目录的 banjo.us.rev0.toml。
第 5 步：编译
cmake -S . -B build-cmake -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_COMPILER=clang -G Ninja -DCMAKE_BUILD_TYPE=Release cmake --build build-cmake --target BanjoRecompiled -j$(nproc) --config Release成功后，build-cmake目录中会生成BanjoRecompiled可执行文件 🚀
代码结构速览：贡献该从哪里下手？
| 目录/文件 | 作用 |
|---|---|
| patches/ | 游戏增强补丁的核心目录，每个.c文件对应一类功能 |
| include/banjo_config.h | 游戏内配置菜单项定义 |
| src/main/ | 程序入口、主题、补丁注册等主程序代码 |
| lib/ | RT64、RecompFrontend、N64ModernRuntime 等依赖库（子模块） |
patches/ 是贡献者最熟悉的区域，里面每个文件都是独立功能模块，例如：
- patches/note_saving.c：音符保存（后期版本游戏特性）
- patches/jinjo_saving.c：Jinjo 保存机制
- patches/timing_patches.c：帧率/计时相关修复
- patches/title_screen_patches.c：标题画面增强
补丁的宏体系（如RECOMP_PATCH、RECOMP_EXPORT）定义在 patches/patches.h，理解这套标记方式是读懂任何补丁文件的前提。
Linux 与 Steam Deck 玩家专区 🎮
Linux 用户有三种游玩方式：Linux 原生二进制、Flatpak，以及 Steam Deck 直装。
Flatpak 构建注意事项
Flatpak 构建有前置要求（详见 flatpak/README.md）：必须先在仓库根目录用 clang 构建补丁，因为 Flatpak 沙箱内的 LLVM 扩展不含 MIPS 编译器：
make -C patches CC=clang LD=ld.lld然后再执行flatpak-builder构建与打包。Flatpak 清单文件见 flatpak/io.github.banjorecomp.banjorecomp.json，软件中心元数据见 flatpak/io.github.banjorecomp.banjorecomp.metainfo.xml。
Steam Deck 快速配置
- 将 Linux 构建解压到 Steam Deck
- 切换到桌面模式，右键
BanjoRecompiled可执行文件 →添加到 Steam - 返回游戏模式，按需要配置手柄按键
新手常见疑问速查 ❓
问：存档文件在哪里？
- Windows：
%LOCALAPPDATA%\BanjoRecompiled\saves - Linux：
~/.config/BanjoRecompiled/saves - macOS：
~/Library/Application Support/BanjoRecompiled/saves
问：能当便携应用用吗？可以。在可执行文件同目录放一个portable.txt，存档、配置和 MOD 都会保存在程序目录下。
问：能换 ROM 玩别的游戏吗？不能。本项目只接受美版 1.0《Banjo-Kazooie》（非 .z64 格式会自动转换）。想换游戏内容？请安装 MOD。
问：启动就崩溃怎么办？先更新显卡驱动；若游戏画面异常/掉帧，关闭 MSI Afterburner 覆盖层、Wallpaper Engine 等注入类软件（见 README.md 的 Known Issues 章节）。
总结：三步融入 Banjo: Recompiled 社区
- 加入主 Discord：搜索 "N64 Recomp"，遇到问题第一时间提问
- 逛 Thunderstore：在 banjo-recompiled 分类下载 MOD，拖进游戏窗口即可安装
- 想做贡献：先读 CONTRIBUTING.md 和 BUILDING.md，本地跑通构建，从 patches/ 目录中挑一个小功能模块入手，记住：代码必须手写，AI 生成代码一律被拒🐓
社区入口和完整功能说明都可以从 README.md 出发，祝你玩得开心！
【免费下载链接】BanjoRecompPC Port of Banjo-Kazooie made using N64: Recompiled (Windows/Linux/Mac)项目地址: https://gitcode.com/gh_mirrors/ba/BanjoRecomp
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
