openblack

OpenBlack

OpenBlack adalah reimplementasi open source dari Black & White (2001) yang ditulis dalam C ++ modern dan mesin rendering modern (OpenGL, Vulkan).

Anda masih perlu memiliki aset game asli untuk menggunakan ini. Lihat lebih lanjut di bawah ini untuk penjelasan tentang cara mengekstraknya.

---

Binari pra-dibangun

Untuk build terbaru dari OpenBlack tanpa harus membangunnya sendiri, kami menawarkan binari pra-dibangun dari layanan pengujian kami.

Eksperimental

Berikut ini memenuhi syarat sebagai Expresciment. Mereka memiliki pengaturan minimum basis seperti kompilasi dan sistem rendering. Jangan berharap dapat meluncurkan tanpa upaya dan tambalan Anda sendiri.

Bangunan

Kloning Kode menggunakan: git clone --recursive https://github.com/openblack/openblack.git

Jika Anda lupa menambahkan --recursive , Anda juga harus menjalankan git submodule update --init dari openblack/ Directory.

Konfigurasi untuk menggunakan VCPKG (disarankan untuk pengguna baru)

Cara paling sederhana untuk mendapatkan semua dependensi yang diperlukan adalah melalui VCPKG yang disertakan dengan file manifes.

Cara termudah untuk memulai platform apa pun adalah dengan memungkinkan CMake dan VCPKG menangani semua dependensi dan konfigurasi untuk Anda. Untuk melakukannya, Anda akan memilih "ninja-multi-vcpkg" - Ninja Multi-Config (vcpkg) . Preset lain tersedia untuk pengguna yang lebih maju.

Kode Studio Visual

• Instal Visual Studio Code
• Pasang ekstensi C ++
  • Ekstensi mungkin tidak diperlukan di Linux
  • Instal kompiler tergantung pada platform Anda
    • Kompiler GNU atau Clang di Linux
    • MSVC Visual Studio di Windows (lihat Visual Studio)
    • Kompiler dentang di Mac
• Pasang ekstensi CMake Tools
  • Instal CMake Versi 3.20+
• Anda cukup membuka folder openblack langsung dalam kode studio visual dan memilih preset.

Visual Studio 2022

• Instal Visual Studio
  • Pilih komponen MSVC C ++ yang sesuai untuk versi Anda
  • Pilih komponen Windows SDK yang sesuai untuk versi Anda
  • Pilih Komponen C ++ CMake untuk komponen Windows
• Anda cukup membuka folder openblack langsung di Visual Studio dan memilih preset.

Clion

• Instal Clion
• Anda cukup membuka folder openblack langsung di Clion dan memilih preset.

Xcode

• Instal xcode
• Instal Homebrew Depenedency Menggunakan Homebrew: brew install cmake ninja pkg-config
• Jalankan sudo xcode-select --reset setelah menginstal cmake
• Anda perlu mengonfigurasi menggunakan cmake preset xcode-vcpkg menggunakan cmake di gUI atau menggunakan argumen baris perintah --preset xcode-vcpkg

Studio Android

• Instal Android Studio
• Instal SDK baru -baru ini dan NDK setidaknya 23
• Buka OpenBlack dari Direktori android
• Atur SDK dan NDK di Pengaturan Proyek
• Do Gradle Configure yang akan menjalankan konfigurasi cmake dan mengkompilasi dependensi vcpkg
• Bangun proyek untuk perangkat virtual atau perangkat yang terhubung
• Saat ini mengharuskan pengguna untuk mengunggah aset game ke /data/local/tmp/bw dan chmod -R a+wrx /data/local/tmp/bw dengan adb

Perakitan web

• Dapatkan Emsdk
• Tambahkan direktori EMSDK sebagai variabel lingkungan EMSDK .
• Jalankan emsdk install latest
• Jalankan emsdk activate latest
• Bangun preset emscripten-vcpkg

Baris perintah

• Rantai pahat build Anda yang biasa.
  • Ubuntu / Debian: # apt install build-essential cmake ninja-build
  • Arch Linux / Manjaro: # pacman -S base-devel cmake ninja
• Anda dapat menghasilkan preset build cmake menggunakan cmake --preset dan Anda dapat mencantumkan preset menggunakan cmake --list-presets

Konfigurasi untuk menggunakan dependensi sistem (disarankan untuk pengemas)

Jika Anda tidak ingin menggunakan VCPKG; CMake akan menggunakan pustaka sistem, atau direktori paket yang ditentukan secara manual.

CMake akan menemukan pustaka yang diperlukan selama mereka menyediakan file konfigurasi yang tepat.

Arch Linux

Pasang OpenBlack-Git dari AUR yang membangun dan memasang langsung untuk semua distro turunan Arch Linux seperti Manjaro. Ini akan mengharuskan Pacman untuk menginstal semua dependensi yang diperlukan.

Awalan yang digunakan adalah "linux-system-deps" - Linux (System Deps)

Berkontribusi

Kontribusi selalu diterima, apakah itu memodifikasi kode sumber untuk menambahkan fitur baru atau perbaikan bug, mendokumentasikan format file baru atau hanya mengedit beberapa tata bahasa.

Anda juga dapat bergabung dengan Discord untuk diskusi pengembangan jika Anda tidak yakin dengan apa pun.

Mengekstrak file aset dari game asli

Seperti yang disebutkan sebelumnya, aset game asli diperlukan untuk menjalankan OpenBlack. Karena data ini dilindungi hak cipta, kami tidak akan menyediakannya , jadi tolong jangan tanya. Berikut ini adalah panduan untuk mengekstraksi mereka dari game aslinya.

Prasyarat

Anda akan membutuhkan yang berikut:

• Penginstal asli (biasanya pada CD)
• Patch Resmi 1.10
• Patch resmi 1.2
• Tidak diperlukan (tetapi tidak akan kompromi ekstraksi): tambalan tidak resmi 1.42

Jangan menginstal 1.3, ini adalah tambalan untuk menambahkan dukungan sarung tangan P5 dan umumnya tidak stabil

Instalasi

Di windows

1. Instal game dari penginstal, ingat direktori instalasi ( C:\Program Files (x86)\Lionhead Studios\Black & White\ adalah default)
2. Pasang tambalan resmi 1.10 (di direktori yang sama)
3. Pasang tambalan resmi 1.2 (di direktori yang sama)

Di Linux dan MacOS

Jika Anda menjalankan di Linux atau MacOS, Anda dapat menginstal game dengan Wine (halaman aplikasi di WineHQ).

1. Pasang wine
2. Jalankan wine Setup.exe dari direktori yang berisi penginstal, jangan ubah jalur instal
3. Jalankan wine Black_White_Patch_v1.100.exe dari direktori yang berisi tambalan pertama (adaptasi perintah jika nama file tidak persis seperti itu)
4. Jalankan wine black_white_patch_v1_20.exe dari direktori yang berisi tambalan kedua (adaptasi juga)
5. Jika Anda ingin menginstal tambalan tidak resmi, itu membutuhkan .NET 2.0, yang dapat diinstal dengan winetricks dotnet20sp2 (Anda harus menginstal winetricks first )

Semua file harus diinstal di direktori berikut: ~/.wine/drive_c/Program Files (x86)/Lionhead Studios Ltd/Black & White

Mendapatkan aset

Folder yang Anda minati adalah folder Audio , Data , dan Scripts di direktori instalasi. Anda dapat menggunakannya dari sana atau membuat salinan ke lokasi pilihan Anda.

Menggunakannya di tempatnya

Jika Anda ingin menggunakannya dari sana, ingat direktori instalasi yang dipilih pada langkah instalasi, kecuali jika Anda mengubahnya, itu harusnya:

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

Ini adalah jalur yang akan Anda berikan kepada OpenBlack (menggunakan bendera -g ).

Jika Anda lebih suka menyalin data (misalnya jika Anda ingin menghapus instalan game asli), cukup salin folder Data dan Scripts ke lokasi baru yang diinginkan, dan berikan jalur ke lokasi ini untuk OpenBlack (menggunakan bendera -g ).

Lisensi

OpenBlack dirilis sebagai perangkat lunak open source di bawah lisensi GPL V3, lihat file lisensi di root proyek untuk teks lisensi lengkap.