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中的許可證文件。