GitHub - HarbourMasters/SpaghettiKart项目介绍与使用指南

技术背景

HarbourMasters/SpaghettiKart项目正在寻找对制作可滚动菜单感兴趣的C或C++程序员，该项目目前需要构建能容纳大量条目的可滚动菜单，虽然已有自定义菜单的 tick/render 系统，但缺少显示自定义内容的方法。同时需要注意，该项目不支持盗版，且不包含任何受版权保护的资产，用户需自行提供支持的游戏副本。

实现步骤

1. 验证ROM转储

仅支持美国版本的ROM，可通过在线工具https://www.romhacking.net/hash/ 验证已转储的游戏副本。美国ROM的SHA - 1哈希值为：579C48E211AE952530FFC8738709F078D5DD215E。

2. 验证ROM格式

ROM需要为 .z64 格式。若为 .n64 格式，可使用https://hack64.net/tools/swapper.php 进行转换。

3. 下载SpaghettiKart

从 Releases 中下载SpaghettiKart。

4. 从ROM生成O2R

• Windows：将zip文件中的所有文件解压到选定的文件夹，运行 “Spaghettify.exe” 并选择美国ROM。
• Linux：将zip文件中的所有文件解压到选定的文件夹，运行 “spaghetti.appimage” 并选择美国ROM，可能需要通过终端执行 chmod +x 命令赋予执行权限。
• Nintendo Switch：运行PC版本生成 mk64.o2r 文件，启动PC版游戏后，在 Spaghettify.exe 或 spaghetti.appimage 所在目录找到这些文件，然后复制到SD卡。

5. 开始游戏

启动 Spaghettify.exe 即可开始游戏。

核心代码

文档中未提及核心代码相关内容。

最佳实践

配置

• 默认键盘配置：

  N64按键	键盘按键
  A	Shift
  B	Ctrl
  Z	Z
  Start	Enter
  模拟摇杆	方向键
  C按钮	TGFH (↑ ↓ ← →)
  D - Pad	Num 8 2 4 6

• 其他快捷键：

  按键	操作
  F11	全屏
  Tab	切换备用资源
  Ctrl + R	重置
  Esc	设置

图形后端

目前支持三种渲染API：DirectX11（Windows）、OpenGL（所有平台）和 Metal（macOS）。可在菜单栏的设置菜单中更改使用的API，更改后需要重启。若遇到崩溃问题，可在 spaghettify.cfg.json 文件中找到 "Backend":{... 行，将 id 值更改为 3 并将 Name 设置为 OpenGL。Windows默认使用 id 为 2 的 DirectX 11，macOS默认使用 id 为 4 的 Metal。

自定义资产

自定义资产以 .o2r 或存储的 .zip 文件形式打包，将其放置在 mods 文件夹中即可使用。若想创建和打包自己的自定义资产 .o2r 文件，可使用 retro - O2R generator 和 fast64 - Blender plugin 工具。注意，SpaghettiKart 不支持 .otr 存档。

常见问题

• 遇到问题如何求助：若阅读README后仍有问题，可在 SpaghettiKart 支持文本频道寻求帮助，官方Discord链接为：https://discord.com/invite/shipofharkinian。
• 版权问题：项目不支持盗版，必须提供支持的游戏副本。
• ROM版本和格式：仅支持美国ROM版本，且ROM需为 .z64 格式。