openblack

敞开

OpenBlack是Black＆White（2001）用现代C ++和现代渲染引擎（OpenGL，Vulkan）撰写的开源重新实现。

您仍然需要拥有原始的游戏资产才能使用它。有关如何提取它们的解释，请参见下面的进一步说明。

---

预建二进制

对于最新的OpenBlack而不必自己构建，我们可以通过测试服务提供预制的二进制文件。

实验

以下有资格被剥夺。它们具有最低设置，例如编译和渲染系统。不要期望可以在没有努力和自己的补丁的情况下推出。

建筑

使用： git clone --recursive https://github.com/openblack/openblack.git克隆代码。

如果您忘记添加--recursive ，则还必须从openblack/ Directory运行git submodule update --init 。

使用VCPKG的配置（建议新用户）

获得所有所需依赖关系的最简单方法是通过VCPKG，它包含在清单文件中。

在任何平台上入门的最简单方法是允许CMAKE和VCPKG处理所有依赖关系和配置。为此，您将选择"ninja-multi-vcpkg" - Ninja Multi-Config (vcpkg)预设。其他预设可用于更高级的用户。

Visual Studio代码

• 安装Visual Studio代码
• 安装C ++扩展
  • Linux上可能不需要扩展
  • 根据您的平台安装编译器
    • Linux上的GNU或Clang编译器
    • Visual Studio在Windows上的MSVC（请参阅Visual Studio）
    • Mac上的Clang编译器
• 安装CMAKE工具扩展
  • 安装CMAKE版本3.20+
• 您可以直接在Visual Studio代码中打开openblack文件夹，然后选择一个预设。

Visual Studio 2022

• 安装Visual Studio
  • 为您的版本选择适当的MSVC C ++组件
  • 为您的版本选择合适的Windows SDK组件
  • 选择Windows组件的C ++ CMAKE工具
• 您只需在Visual Studio中直接打开openblack文件夹，然后选择一个预设。

c

• 安装CLION
• 您只需直接在CLION中打开openblack文件夹，然后选择一个预设即可。

XCode

• 安装Xcode
• 使用Homebrew安装自制脱发： brew install cmake ninja pkg-config
• 安装cmake后，运行sudo xcode-select --reset
• 您需要使用cmake Preset xcode-vcpkg配置使用GUI中的CMAKE或使用命令行参数--preset xcode-vcpkg

Android Studio

• 安装Android Studio
• 安装最近的SDK和NDK至少为23
• 从android目录打开敞开
• 在项目设置中设置SDK和NDK
• 执行将运行CMake配置并编译VCPKG依赖项的Gradle配置
• 为虚拟设备或连接的设备构建项目
• 目前要求用户将游戏资产上传到/data/local/tmp/bw和chmod -R a+wrx /data/local/tmp/bw并使用ADB上传。

网络组件

• 获取EMSDK
• 将EMSDK的目录添加为EMSDK环境变量。
• 运行emsdk install latest
• 运行emsdk activate latest
• 构建emscripten-vcpkg预设

命令行

• 您通常的构建工具链。
  • Ubuntu / debian： # apt install build-essential cmake ninja-build
  • Arch Linux / Manjaro： # pacman -S base-devel cmake ninja
• 您可以使用cmake --preset生成Cmake构建预设，并且可以使用cmake --list-presets列出预设

用于使用系统依赖性的配置（推荐给包装器）

如果您不想使用VCPKG； CMAKE将使用系统库或手动指定的软件包目录。

只要提供适当的配置文件，CMAKE就会找到所需的库。

Arch Linux

从AUR安装OpenBlack-Git，该AUR直接为所有Arch Linux派生发行版（例如Manjaro）构建和安装。这将要求PACMAN安装所有必需的依赖项。

使用的前缀是"linux-system-deps" - Linux (System Deps)

贡献

无论是修改源代码以添加新功能还是错误修复，记录新文件格式还是简单地编辑一些语法，始终欢迎贡献。

如果您不确定任何事情，也可以加入Discord进行开发讨论。

从原始游戏中提取资产文件

如前所述，为了运行OpenBlack，需要原始的游戏资产。由于这些数据是版权的，因此我们不会提供它们，因此请不要询问。这是从原始游戏中提取它们的指南。

先决条件

您将需要以下内容：

• 原始安装程序（通常在CD上）
• 官方补丁1.10
• 官方补丁1.2
• 不需要（但不会损害提取）：非官方补丁1.42

请勿安装1.3，这是添加P5 Power Glove支撑的补丁，通常是不稳定的

安装

在窗户上

1. 从安装程序安装游戏，请记住安装目录（ C:\Program Files (x86)\Lionhead Studios\Black & White\是默认值）
2. 安装官方补丁1.10（在同一目录中）
3. 安装官方补丁1.2（在同一目录中）

在Linux和MacOS上

如果您在Linux或MacOS上运行，则可以使用Wine（WineHQ上的应用页面）安装游戏。

1. 安装wine
2. 从包含安装程序的目录中运行wine Setup.exe ，不要更改安装路径
3. 从包含第一个补丁的目录中运行wine Black_White_Patch_v1.100.exe （如果文件名不完全如此）
4. 从包含第二个补丁的目录中运行wine black_white_patch_v1_20.exe （也适应）
5. 如果您想安装非官方补丁，则需要.NET 2.0，可以使用winetricks dotnet20sp2安装（您应该winetricks first ）

所有文件都应在以下目录中安装： ~/.wine/drive_c/Program Files (x86)/Lionhead Studios Ltd/Black & White

获取资产

您感兴趣的文件夹是安装目录中的Audio ， Data和Scripts文件夹。您可以从那里使用它们，也可以副本到您选择的位置。

使用它们到位

如果您想从那里使用它们，请记住安装步骤中选择的安装目录，除非您更改它，否则应该是：

• C:\Program Files (x86)\Lionhead Studios\Black & White\
• 或~/.wine/drive_c/Program Files (x86)/Lionhead Studios Ltd/Black & White

这是您将为OpenBlack提供的路径（使用-g标志）。

如果您希望复制数据（例如，如果要卸载原始游戏），只需将Data和Scripts文件夹复制到所需的新位置，然后将通往此位置的路径传达到OpenBlack（使用-g标志）。

执照

OpenBlack在GPL V3许可证下以开源软件的形式发布，请参阅“完整许可文本”项目root中的许可证文件。