sly1下载 - sly1源码下载

sly1

其他类别

1.0.0

下载

狡猾的库珀和盗贼浣熊

Sly 1 反编译 Logo by Cooper941

这是针对 PlayStation 2 的Sly Cooper 和 Thievius Raccoonus的正在进行的反编译。它构建了游戏的 NTSC-U 版本SCUS_971.98 (SHA1: 57dc305d )。

该项目的目标是更好地理解游戏引擎。该存储库不包含任何游戏资产或游戏可执行文件的原始代码；它需要您自己的游戏副本才能构建和运行。

代码文档可以在 theonlyzac.github.io/sly1 找到。如需进一步了解游戏的内部结构和机制，请访问 SlyMods Wiki。

欢迎并鼓励新的贡献者提出拉取请求！如果您想提供帮助但不确定从哪里开始，请查看 CONTRIBUTING.md 并随时加入我们的 Discord 服务器以获取指导。

快速入门

您可以使用快速启动脚本在 Linux（或 WSL）上快速设置项目。请按照以下三个步骤开始。

1.克隆存储库并运行quickstart.sh。

复制并运行以下命令。它可能会要求您输入密码来安装依赖项。

git clone https://github.com/theonlyzac/sly1 && 
cd sly1 && 
./scripts/quickstart.sh

2. 从光盘中提取可执行文件。

将 Sly 1 游戏光盘中的文件SCUS_971.98复制到项目的disc目录中。需要构建它。

3. 构建项目。

./scripts/build.sh

如果它有效，您将看到以下内容：

 [XXX/XXX] sha1sum config/checksum.sha1
out/SCUS_971.98: OK

如果您有任何问题，或者您更喜欢手动设置项目，请按照以下说明进行操作。下面还提供了运行游戏的说明。

手动设置

该项目可以在 Linux（或使用 WSL 的 Windows）上构建。请按照以下说明设置构建环境。

克隆存储库

将存储库克隆到本地计算机：

git clone https://github.com/TheOnlyZac/sly1
cd sly1

提取原始 ELF 文件

要构建该项目，您需要从您自己合法获得的游戏副本中提取原始 ELF 文件。将光盘安装到您的 PC 上，并将文件SCUS_971.98从光盘复制到该项目的disc目录中。

安装Python包

如果您没有 Python 3.8 或更高版本，请安装它：

sudo apt-get install python3 python3-pip

然后安装所需的Python包：

pip3 install -U -r requirements.txt

设置构建环境

设置酒：

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install wine32

安装 MIPS 汇编器：

sudo apt-get install binutils-mips-linux-gnu

设置编译器：

 cd scripts
./setup-progd-linux.sh

构建项目

该项目构建可执行文件SCUS_971.98 。

python3 configure.py
ninja

如果您更新任何配置文件或添加任何源文件，您将需要运行干净的重新配置：

python3 configure.py --clean

要仅清理而不重新配置（即删除构建文件），请使用：

python3 configure.py --only-clean

跑步

运行可执行文件需要 PCSX2 2.0。您必须拥有自己的原始游戏副本以及来自您自己的 PS2 的 BIOS。它们不包含在此存储库中，我们无法为您提供它们。

拥有这些并构建了可执行文件后，您可以通过以下三种方式之一运行它：

1.自动运行脚本

scripts目录中的run.sh脚本将自动重建可执行文件并在 PCSX2 模拟器中运行它。要使用它，您必须首先编辑脚本以将PCSX2_PATH和ISO_PATH变量设置为系统上的正确路径。

2.从命令行运行

要从命令行启动 PCSX2 中的 elf，请使用以下命令：

pcsx2.exe -elf " .../sly1/bin/debug/SCUS_971.98 " " /path/to/game/backup.iso "

将pcsx2.exe替换为 PCSX2 v2.0 可执行文件的路径（对于 Linux，它将是一个.appimage文件）。

-elf参数指定您从此项目构建的 SCUS_971.98 的路径。将...替换为该存储库的路径。模拟器将使用这个ELF来启动游戏。
最后一个参数是游戏 ISO 的路径。将/path/to/game/backup.iso替换为您自己的游戏光盘备份的路径。这是游戏加载资源的地方。

3. 从 PCSX2 GUI 运行

将SCUS_971.98从out目录复制到您的 PCSX2 Games 文件夹并将其重命名为SCUS_971.98.elf 。右键单击 PCSX2 中的游戏，然后单击“属性...”。转到“光盘路径”，单击“浏览”，然后选择游戏备份的 ISO。然后点击“关闭”并正常开始游戏。

项目结构

项目分为以下几个目录：

include - 游戏引擎的头文件。
src - 反编译的源代码。
- 游戏引擎的所有代码都位于src/P2中。
- 游戏脚本引擎的代码位于src/P2/splice中。
config - Splat（二进制分割工具）的配置文件。
scripts - 用于设置构建环境的实用程序脚本。
docs - 贡献的文档和说明。
tools - 用于功能匹配的实用程序。
reference - 函数和数据结构的参考文件。

当您构建可执行文件时，将创建以下目录：

asm - 来自 elf 的反汇编汇编代码。
assets - 从精灵中提取的二进制数据。
obj - 编译的目标文件。
out - 编译后的可执行文件。

常问问题

什么是反编译？

当开发者创建游戏时，他们编写了源代码并将其编译为可以在 PS2 上运行的汇编代码。反编译涉及对汇编代码进行逆向工程，以生成新的原始代码，并编译为匹配的汇编代码。这个过程给我们留下了与源代码相似且行为相同的源代码（尽管不一定相同），这有助于我们理解程序员在制作游戏时的想法。

它是如何运作的？

我们使用名为 Splat 的工具将二进制文件拆分为代表每个单独函数的汇编文件。然后，我们通过编写可编译为相同汇编代码的 C++ 代码来重新实现每个函数和数据结构。我们不会在反编译中包含原始游戏二进制文件中的任何数据或代码。

以前有人这样做过吗？

这是第一个 PS2 反编译；自 2020 年开始以来，我们已经开始了其他几个项目。我们的主要灵感来自其他项目，例如 N64 的《超级马里奥 64》分解和 Wii U 的《荒野之息》分解（后者在范围上与本项目更相似）。还有一个名为 OpenGOAL 的 Jak & Daxter decomp/PC 移植版，尽管该游戏 98% 是 GOAL 语言而不是 C/C++。