HarbourMasters/Lighthouse 源代码：https://github.com/HarbourMasters/Lighthouse

Lighthouse Harbour Masters 对《班卓熊大冒险》的移植版本

首席开发者：* Malkierian

开发者：

• JeodC
• Caladius

Discord

官方 Discord：https://discord.com/invite/shipofharkinian

如果你在阅读完这份 README 后遇到任何问题，欢迎在 Lighthouse 文本频道中寻求帮助。请记住，我们不支持盗版。

快速开始

Lighthouse 不包含任何受版权保护的资产。您需要提供受支持的游戏副本。

1. 验证您的 ROM 文件

以下任何零售版本均受支持。您可以使用 https://www.romhacking.net/hash/ 上的 SHA-1 文件校验和在线工具来验证您所转储的游戏副本是否受支持。

• baserom.us.v10.z64: 1fe1632098865f639e22c11b9a81ee8f29c75d7a
• baserom.us.v11.z64: ded6ee166e740ad1bc810fd678a84b48e245ab80
• baserom.jp.z64: 90726d7e7cd5bf6cdfd38f45c9acbf4d45bd9fd8
• baserom.pal.z64: bb359a75941df74bf7290212c89fbc6e2c5601fe

如果您有多个地区的游戏版本，并希望将其用作语言包，请参阅下面的 # 语言包 部分。

2. 验证您的 ROM 是否为 .z64 格式

您的 ROM 需要为 .z64 格式。如果是 .n64 格式，请使用以下工具将其转换为 .z64：https://hack64.net/tools/swapper.php

3. 从 Releases 下载 Lighthouse

（https://github.com/HarbourMasters/Lighthouse/releases）

4. 从 ROM 生成 OTR 并开始游戏！

Windows

• 将 zip 中的所有文件解压到您选择的文件夹中。
• 运行 lighthouse.exe 并选择兼容的 ROM。

Linux

• 将 zip 中的所有文件解压到您选择的文件夹中。
• 执行 lighthouse.appimage。您可能需要在终端中执行 chmod +x 对该 appimage 赋权。

MacOS

• 将 zip 中的所有文件解压到您选择的文件夹中。
• 运行 lighthouse 并选择兼容的 ROM。

配置

Lighthouse 附带一个包含许多标准控制器映射的文件，可直接用于大多数控制器。如果您的控制器未被 Lighthouse 识别，或无法正常工作，您可以使用“设置”菜单中的内置映射器创建自定义映射。

默认键盘配置

其他快捷键

图形后端

目前支持三种渲染 API：DirectX11（Windows）、OpenGL（所有平台）和 Metal（macOS）。您可以在菜单栏的“设置”菜单中更改所使用的 API，更改后需要重启。

如果您遇到崩溃问题，可以在 lighthouse.cfg.json 文件中找到 "Backend":{… 行，将 id 值更改为 2，并将 Name 设置为 OpenGL。id 为 1 的 DirectX 11 是 Windows 上的默认选项。id 为 3 的 Metal 是 macOS 上的默认选项。

语言包

Lighthouse 支持使用多个地区的《班卓熊大冒险》作为语言包。生成基础 bk.o2r 文件后，等 Lighthouse 启动，打开 imgui 菜单。在 General -> Languages 下，您可以选择另一个 ROM 并将其提取为语言包。PAL 支持英语、法语和德语，日版则增加日语支持。生成语言包后，其带来的语言将添加到下拉菜单中。

Romhacks

许多 romhack 可以从打过补丁的 ROM 中提取，并作为 mod 与 Lighthouse 一起使用。这可以在游戏内通过“设置”部分的 Romhacks 菜单完成。如果有任何 hack 未被完全支持，菜单会在提取 mod 时告知您。目前大多数受支持的 romhack 尚未经过全面测试，因此可能仍存在一些问题。

注意：使用 romhack 时，仅支持 US v1.0，此限制继承自 Banjo’s Backpack。因此，建议使用 US v1.0 作为您的基础 bk.o2r 文件。

自定义资源

自定义资源被打包在 .o2r 或 .otr 文件中。要使用自定义资源，请将它们放在 mods 文件夹中。

如果您有兴趣创建和/或打包自己的自定义资源 .o2r/.otr 文件，请查看以下工具：

• retro - OTR 和 O2R 生成器（https://github.com/HarbourMasters64/retro）
• fast64 - Blender 插件（请注意，目前不支持 BK64）（https://github.com/HarbourMasters/fast64）

开发

构建

如果您想手动编译 Lighthouse，请参阅构建说明（https://github.com/HarbourMasters/Lighthouse/blob/main/docs/BUILDING.md）。

试玩测试

如果您想试玩持续集成构建版本，可以在下面的链接中找到。请注意，这些版本仅供试玩测试，您很可能会遇到错误甚至崩溃。

• Windows（https://nightly.link/HarbourMasters/Lighthouse/workflows/main/main/Lighthouse-windows.zip）
• macOS（https://nightly.link/HarbourMasters/Lighthouse/workflows/main/main/Lighthouse-mac.zip）
• Linux（https://nightly.link/HarbourMasters/Lighthouse/workflows/main/main/Lighthouse-linux.zip）

特别感谢：

• Banjo 反编译团队
• Fredomato、scorched11 在 rando 上的工作