加入Banjo: Recompiled社区：Discord、Thunderstore与项目贡献完整指南

加入Banjo: Recompiled社区Discord、Thunderstore与项目贡献完整指南【免费下载链接】BanjoRecompPC Port of Banjo-Kazooie made using N64: Recompiled (Windows/Linux/Mac)项目地址: https://gitcode.com/gh_mirrors/ba/BanjoRecompBanjo: RecompiledBanjoRecomp是一个开源的《Banjo-Kazooie》PC 移植项目基于 N64: Recompiled 静态重编译技术让这款 N64 经典游戏以原生方式运行在 Windows、Linux 和 Mac 上并支持高帧率、宽屏、MOD 加载等大量增强功能。本文是一份面向新手的完整指南如何加入官方 Discord 社区、如何在 Thunderstore 获取和使用 MOD以及如何从零开始为项目贡献代码 项目概览Banjo: Recompiled 值得加入吗在加入社区之前先花一分钟了解这个项目的核心能力静态重编译将 N64 游戏代码直接编译为原生 PC 代码无需模拟器和 ROM 提取步骤高帧率 宽屏任意刷新率、任意宽高比游戏 HUD 和过场动画均已适配 16:9MOD 支持社区 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 DiscordMOD 开发专用如果你不只是玩 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 步安装依赖LinuxUbuntu 示例sudo apt-get install cmake ninja-build libsdl2-dev libgtk-3-dev lld llvm clangWindowsVisual 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_COMPILERclang -DCMAKE_C_COMPILERclang -G Ninja -DCMAKE_BUILD_TYPERelease 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.cJinjo 保存机制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 CCclang LDld.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\savesLinux~/.config/BanjoRecompiled/savesmacOS~/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），仅供参考