re3

简介

在此存储库中，您将找到 GTA III（主分支）和 GTA VC（迈阿密分支）的完全反向源代码。

它已经过测试，可在 Windows、Linux、MacOS 和 FreeBSD、x86、amd64、arm 和 arm64 上运行。
渲染由原始 RenderWare (D3D8) 或重新实现 librw（D3D9、OpenGL 2.1 或更高版本、OpenGL ES 2.0 或更高版本）处理。
音频是通过 MSS（使用原始 GTA 中的 dll）或 OpenAL 完成的。

该项目还被移植到 Nintendo Switch、Playstation Vita 和 Nintendo Wii U。

我们还不能为 PS2 或 Xbox 构建。如果您有兴趣这样做，请与我们联系。

安装

• re3 需要 PC 游戏资源才能运行，因此您必须拥有一份 GTA III。
• 构建 re3 或下载最新版本：
  • Windows D3D9 MSS 32 位
  • Windows D3D9 64 位
  • Windows OpenGL 64 位
  • Linux 64 位
  • MacOS 64 位 x86-64
• 将下载的 zip 解压到 GTA 3 目录并运行 re3。该 zip 包含二进制文件、更新文件和附加游戏文件，以及 OpenAL 所需的 dll。

截图

改进

我们对原始游戏进行了许多更改和改进。它们可以在core/config.h中配置。其中一些可以在运行时切换，有些则不能。

• 修复了许多大大小小的错误
• 存储在 GTA 根目录中的用户文件（保存和设置）
• 设置存储在 re3.ini 文件中而不是 gta3.set 中
• 用于执行和更改各种操作的调试菜单（Ctrl-M 打开）
• 调试相机（Ctrl-B 进行切换）
• 可旋转相机
• XInput 控制器支持 (Windows)
• 岛屿之间没有加载屏幕（菜单中的“地图内存使用情况”）
• Skinned ped 支持（来自 Xbox 或 Mobile 的型号）
• 渲染
  • 宽屏支持（正确缩放的 HUD、菜单和 FOV）
  • PS2 MatFX（车辆反射）
  • PS2 alpha测试（更好的透明度渲染）
  • PS2颗粒
  • Xbox 车辆渲染
  • Xbox 世界光照贴图渲染（需要 Xbox 地图）
  • Xbox ped 边缘灯
  • Xbox屏幕上有雨滴
  • 更可定制的滤色片
• 菜单
  • 地图
  • 更多选择
  • 控制器配置菜单
  • ...
• 可以从其他平台加载 DFF 和 TXD，但可能会造成性能损失
• ...

待办事项

拥有/做以下事情会很好：

• 修复物理以获得高 FPS
• 提高低端设备的性能，特别是 Raspberry Pi 上的 OpenGL 层（如果您有这方面的经验，请联系我们）
• 将代码与 PS2 代码进行比较（繁琐，没有好的反编译器）
• PS2端口
• Xbox 端口（不太重要）
• 反转剩余未使用/调试功能
• 将 CodeWarrior 构建与原始二进制文件进行比较以获得更准确的代码（非常乏味）

改装

资产修改（模型、纹理、处理、脚本……）在很大程度上应与原始 GTA 的工作方式相同。

CLEO 脚本可与 CLEO Redux 配合使用。

对代码进行更改的 Mod（dll/asi、限制调节器）将不起作用。这些 mod 所做的一些事情已经在 re3 中实现了（大部分 SkyGFX、GInput、SilentPatch、宽屏修复），其他的可以轻松实现（增加 limis，请参阅config.h ），其他的只需重写并集成到代码中直接地。带来不便敬请谅解。

从源头构建

使用 premake 时，如果您希望通过构建后脚本将可执行文件移动到 GTA3 根文件夹，您可能需要将 GTA_III_RE_DIR 环境变量指向 GTA3 根文件夹。

使用git clone --recursive https://github.com/halpz/re3.git克隆存储库。然后cd re3进入克隆的存储库。

Linux预制版

对于使用 premake 的 Linux，请继续：在 Linux 上构建

Linux柯南

安装python和conan，然后运行build。

 conan export vendor/librw librw/master@
mkdir build
cd build
conan install .. re3/master@ -if build -o re3:audio=openal -o librw:platform=gl3 -o librw:gl3_gfxlib=glfw --build missing -s re3:build_type=RelWithDebInfo -s librw:build_type=RelWithDebInfo
conan build .. -if build -bf build -pf package

MacOS 预制版

对于使用 premake 的 MacOS，请继续：在 MacOS 上构建

自由BSD

对于使用 premake 的 FreeBSD，请继续：Building on FreeBSD

视窗

假设您有 Visual Studio 2015/2017/2019：

• 在根文件夹上运行premake-vsXXXX.cmd变体之一。
• 使用 Visual Studio 打开 build/re3.sln 并编译解决方案。

Microsoft 最近停止了 DX9 SDK 的下载。您可以在此处下载存档版本：https://archive.org/details/dxsdk_jun10

如果您在 Windows 上选择 OpenAL，则必须阅读在 Windows 上运行 OpenAL 构建。

如果您希望使用链接时间优化来编译项目，premake 有一个--with-lto选项。

config.h中有各种设置，你可能想看一下。

re3使用完全自制的RenderWare-替换渲染引擎；库。 librw 作为 re3 的子模块，但您也可以使用 LIBRW 环境变量来指定您自己的 librw 的路径。

如果您觉得需要，您还可以使用 CodeWarrior 7 使用提供的 codewarrior/re3.mcp 项目来编译 re3 - 这需要原始 RW33 库和 DX8 SDK。不过，与 MSVC 版本相比，该版本不稳定，主要是作为参考。

贡献

只要它不是 Linux/跨平台框架/兼容层，存储库上所有不在预处理器条件（如 FIX_BUGS）后面的代码都是与原始二进制文件完全相反的代码。

我们不接受自定义代码，只要它不是通过预处理器条件包装的，或者它是 Linux/跨平台骨架/兼容层。

我们只接受这些类型的 PR；

• 至少在一个 GTA 中存在的新功能（如果 III/VC 中没有，则不必反编译）
• 游戏、UI 或 UX 错误修复（如果是对原始代码的修复，则应位于 FIX_BUGS 后面）
• 尚未逆转的特定于平台和/或未使用的代码
• 使逆向代码更易于理解/准确，如“哪个代码将生成此程序集”。
• 新的跨平台骨架/兼容层，或对其的改进
• 翻译修复，适用于原始游戏支持的语言
• 提高可维护性的代码

我们有一个编码风格文档，但没有得到很好的遵循或执行。

不要使用 C++11 或更高版本的功能。

历史

re3 于 2018 年春季的某个时候启动，最初是为了测试游戏内的反向碰撞和物理代码。这是通过使用 dll 将游戏的单个函数替换为相反的函数来完成的。

经过一番工作后，该项目休眠了大约一年，并于 2019 年 5 月再次被提起并推送到 github。当时我（aap）已经反转了大约 10k 行代码，并估计最终游戏有大约 200 行代码25万。其他人很快也加入了这项工作（按时间顺序是 Fire_Head、shfil、erorcun 和 Nick007J，Serge 稍晚一些），我们在 2019 年整个夏天取得了非常快的进展，之后步伐放慢了一点。

由于新冠病毒大流行开始期间每个人都呆在家里，每个人都有很多时间再次开发 re3，我们终于在 2020 年 4 月得到了一个独立的 exe（当时大约有 18 万行）。

经过最初的兴奋并进一步修复和完善代码后，reVC 于 2020 年 5 月上旬开始，从 re3 代码开始，而不是从头开始用 dll 替换函数。经过几个月的基本稳定进展后，我们认为 reVC 于 12 月完成。

从那时起，我们开始了 reLCS，目前该工作正在进行中。

执照

我们觉得我们没有能力向该代码授予许可证。
该代码只能用于教育、文档和修改目的。
我们不鼓励盗版或商业用途。
请保持衍生作品开源并给予适当的认可。