HarbourMasters/Ghostship
GitHub: HarbourMasters/Ghostship
Ghostship是一款游戏逆向工程和修改工具,用于游戏安全测试。
Stars: 566 | Forks: 40
# 幽灵船
主要开发者:
* [Lywx](https://www.github.com/kiritodv)
## Discord
官方Discord:https://discord.com/invite/shipofharkinian
如果您在阅读完此`README`后遇到任何问题,请随时在Ghostship支持文本频道中寻求帮助。请记住,我们不支持盗版。
# 快速开始
Ghostship不包含任何受版权保护的资产。您需要提供游戏的支持副本。
### 1. 验证您的ROM镜像
支持的游戏ROM版本为美版和日版。您可以通过使用https://www.romhacking.net/hash/上的SHA-1文件校验在线工具来验证您是否已镜像了支持的游戏副本。
* 美版ROM的SHA-1哈希值为9bef1128717f958171a4afac3ed78ee2bb4e86ce。
* 日版ROM的SHA-1哈希值为8a20a5c83d6ceb0f0506cfc9fa20d8f438cafe51。
### 2. 验证您的ROM是否为.z64格式
您的ROM需要为.z64格式。如果它是.n64格式,请使用以下链接将其转换为.z64格式:https://hack64.net/tools/swapper.php
### 2. 从[发布](https://github.com/HarbourMasters/Ghostship/releases)下载Ghostship
### 3. 从ROM生成OTR并开始游戏!
#### Windows
* 将zip文件中的所有文件解压到您选择的文件夹中。
* 运行Ghostship.exe并选择您的美版或日版ROM。
#### Linux
* 将zip文件中的所有文件解压到您选择的文件夹中。
* 执行Ghostship.appimage。您可能需要在终端中通过chmod +x将appimage赋予执行权限。
#### MacOS
* 将zip文件中的所有文件解压到您选择的文件夹中。
* 运行Ghostship并选择您的美版或日版ROM。
#### 任天堂Switch
* 运行PC版本之一以生成`sm64.o2r`文件。在PC上启动游戏后,您可以在`Ghostship.exe`或`Ghostship.appimage`相同的目录中找到这些文件。
* 将文件复制到您的sd卡
# 配置
### 默认键盘配置
| N64 | A | B | Z | Start | 模拟摇杆 | C按钮 | D-Pad |
| - | - | - | - | - | - | - | - |
| 键盘 | X | C | Z | 空格 | WASD | 方向键 | TFGH |
### 其他快捷键
| 键 | 操作 |
| - | - |
| Esc | 切换菜单 |
| Ctrl+R | 重置(在关卡内) |
| F11 | 全屏 |
| Tab | 切换备用资产 |
### 图形后端
目前支持三种渲染API:DirectX11(Windows)、OpenGL(所有平台)和Metal(macOS)。您可以在菜单栏的“设置”菜单中更改要使用的API,这需要重启。如果您遇到崩溃问题,您可以在`Ghostship.cfg.json`文件中更改API,找到`"Backend":{`...行并将`id`值更改为`3`,将`Name`设置为`OpenGL`。Windows上的默认值为`DirectX 11`(id `2`)。macOS上的默认值为`Metal`(id `4`)。
# 自定义资产
自定义资产打包在`.o2r`或`.otr`文件中。要使用自定义资产,请将它们放置在`mods`文件夹中。
如果您对创建和/或打包自己的自定义资产`.o2r`/`.otr`文件感兴趣,请查看以下工具:
* [**retro - OTR和O2R生成器**](https://github.com/HarbourMasters64/retro)
* [**fast64 - Blender插件**](https://github.com/HarbourMasters/fast64)
# 开发
### 构建
如果您想手动编译Ghostship,请参阅[构建说明](https://github.com/HarbourMasters/Ghostship/blob/develop/docs/building.md)。
### 测试
如果您想测试持续集成构建,您可以在以下链接中找到它们。请注意,这些仅用于测试,您可能会遇到错误和可能的崩溃。
* [Windows](https://nightly.link/HarbourMasters/Ghostship/workflows/main/develop/Ghostship-windows.zip)
* [macOS](https://nightly.link/HarbourMasters/Ghostship/workflows/main/develop/Ghostship-mac.zip)
* [Linux](https://nightly.link/HarbourMasters/Ghostship/workflows/main/develop/Ghostship-linux.zip)
# 特别感谢:
* [Kenix3](https://github.com/Kenix3):帮助开发引入其他端口中的引擎。
* [HM64 Team](https://github.com/harbourMasters):创建Libultraship并帮助解决各种问题。
* [garrettjoecox](https://github.com/garrettjoecox):为此端口贡献了修复。
* [inspectredc](https://github.com/inspectredc):为此游戏的资产提取做出贡献。
* [Malkierian](https://github.com/Malkierian):为此游戏的资产提取做出贡献。
标签:DNS解析, Ghostship, MacOS, N64模拟器, Nintendo Switch, ROM模拟, SHA-1校验, 客户端加密, 开源项目, 技术支持, 文件格式转换, 游戏开发, 游戏破解, 盗版警告