openblack

ouverte

OpenBlack est une réimplémentation open source de Black & White (2001) écrit dans des moteurs de rendu C ++ et modernes modernes (OpenGL, Vulkan).

Vous devez toujours avoir les actifs de jeu d'origine pour l'utiliser. Voir plus loin ci-dessous pour une explication sur la façon de les extraire.

---

Binaires prédéfinis

Pour la dernière construction d'OpenBlack sans avoir à la construire vous-même, nous proposons des binaires prédéfinis de notre service de test.

Expérimental

Les éléments suivants sont qualifiés comme exproment. Ils ont une configuration minimale de base telle que le système de compilation et de rendu. Ne vous attendez pas à pouvoir se lancer sans un certain effort et vos propres correctifs.

Bâtiment

Clone le code en utilisant: git clone --recursive https://github.com/openblack/openblack.git

Si vous avez oublié d'ajouter --recursive , vous devrez également exécuter git submodule update --init à partir de l' openblack/ Directory.

Configuration pour l'utilisation de VCPKG (recommandée pour les nouveaux utilisateurs)

Le moyen le plus simple d'obtenir toutes les dépendances requises est via VCPKG qui est inclus avec un fichier manifeste.

Le moyen le plus simple de commencer sur n'importe quelle plate-forme est de permettre à CMake et VCPKG de gérer toutes les dépendances et la configuration pour vous. Pour ce faire, vous sélectionnez le "ninja-multi-vcpkg" - Ninja Multi-Config (vcpkg) Preset. D'autres préréglages sont disponibles pour les utilisateurs plus avancés.

Code Visual Studio

• Installer le code Visual Studio
• Installez l'extension C ++
  • L'extension peut ne pas être requise sur Linux
  • Installez un compilateur en fonction de votre plate-forme
    • Compilateurs GNU ou Clang sur Linux
    • MSVC de Visual Studio sur Windows (voir Visual Studio)
    • Compilateur Clang sur Mac
• Installez l'extension des outils CMake
  • Installer Cmake version 3.20+
• Vous pouvez simplement ouvrir le dossier openblack directement dans le code Visual Studio et sélectionner un préréglage.

Visual Studio 2022

• Installer Visual Studio
  • Sélectionnez un composant MSVC C ++ approprié pour votre version
  • Sélectionnez un composant SDK Windows approprié pour votre version
  • Sélectionnez les outils C ++ Cmake pour Windows Composant
• Vous pouvez simplement ouvrir le dossier openblack directement dans Visual Studio et sélectionner un préréglage.

Clion

• Installer Clion
• Vous pouvez simplement ouvrir le dossier openblack directement dans Clion et sélectionner un préréglage.

Code de xé

• Installer Xcode
• Installez la tâche des homebrew en utilisant Homebrew: brew install cmake ninja pkg-config
• Exécutez sudo xcode-select --reset après l'installation de CMake
• Vous devez vous configurer à l'aide du CMake Preset xcode-vcpkg à l'aide de CMake dans l'interface graphique ou à l'aide de l'argument de la ligne de commande --preset xcode-vcpkg

Studio Android

• Installer Android Studio
• Installez un SDK récent et un NDK d'au moins 23
• Open OpenBlack depuis le répertoire android
• Définir le SDK et le NDK dans les paramètres du projet
• Faire Gradle Configure qui exécutera la configuration CMake et compilera les dépendances VCPKG
• Construisez le projet pour un appareil virtuel ou un appareil connecté
• Exige actuellement que l'utilisateur télécharge des actifs de jeu sur /data/local/tmp/bw et chmod -R a+wrx /data/local/tmp/bw avec BAD

Assemblage Web

• Obtenez EMSDK
• Ajoutez le répertoire de l'EMSDK comme variable d'environnement EMSDK .
• Exécuter emsdk install latest
• Exécuter emsdk activate latest
• Construisez le préréglage emscripten-vcpkg

Ligne de commande

• Votre chaîne d'outils de construction habituelle.
  • Ubuntu / Debian: # apt install build-essential cmake ninja-build
  • Arch Linux / Manjaro: # pacman -S base-devel cmake ninja
• Vous pouvez générer le préréglage CMake Build à l'aide cmake --preset et vous pouvez répertorier les préréglages à l'aide de cmake --list-presets

Configuration pour l'utilisation des dépendances système (recommandée pour les emballages)

Si vous ne souhaitez pas utiliser VCPKG; CMake utilisera des bibliothèques système ou des répertoires de package spécifiés manuellement.

CMake trouvera les bibliothèques requises tant qu'elles fournissent un fichier de configuration approprié.

Arch Linux

Installez OpenBlack-Git à partir de l'AUR qui construit et installe directement pour toutes les distros dérivés d'Arch Linux tels que Manjaro. Cela obligera Pacman à installer toutes les dépendances requises.

Le préfixe à utiliser est "linux-system-deps" - Linux (System Deps)

Contributif

Les contributions sont toujours les bienvenues, qu'il s'agisse de modifier le code source pour ajouter de nouvelles fonctionnalités ou corrections de bogues, de documentation de nouveaux formats de fichiers ou simplement de modifier une grammaire.

Vous pouvez également rejoindre la discussion Discord for Development si vous n'êtes pas sûr de quoi que ce soit.

Extraction des fichiers d'actifs du jeu d'origine

Comme mentionné précédemment, les actifs de jeu originaux sont nécessaires pour exécuter OpenBlack. Étant donné que ces données sont protégées par le droit d'auteur, nous ne les fournirons pas , alors ne demandez pas. Voici un guide pour les extraire du jeu original.

Condition préalable

Vous aurez besoin de ce qui suit:

• L'installateur d'origine (généralement sur un CD)
• Patch officiel 1.10
• Patch officiel 1.2
• Pas nécessaire (mais ne comprometra pas l'extraction): patch non officiel 1.42

N'installez pas 1.3, c'est un patch pour ajouter le support P5 Power Glove et est généralement instable

Installation

Sous les fenêtres

1. Installez le jeu à partir de l'installateur, n'oubliez pas le répertoire d'installation ( C:\Program Files (x86)\Lionhead Studios\Black & White\ est la valeur par défaut)
2. Installez le patch officiel 1.10 (dans le même répertoire)
3. Installez le patch officiel 1.2 (dans le même répertoire)

Sur Linux et macOS

Si vous exécutez Linux ou MacOS, vous pouvez installer le jeu avec du vin (page de l'application sur WineHQ).

1. Installer wine
2. Exécutez wine Setup.exe à partir du répertoire contenant le programme d'installation, ne modifiez pas le chemin d'installation
3. Exécutez wine Black_White_Patch_v1.100.exe à partir du répertoire contenant le premier patch (adaptez la commande au cas où le nom de fichier n'est pas exactement cela)
4. Exécutez wine black_white_patch_v1_20.exe à partir du répertoire contenant le deuxième patch (adapter aussi)
5. Dans le cas où vous souhaitez installer le correctif non officiel, il nécessite .NET 2.0, qui peut être installé avec winetricks dotnet20sp2 (vous devez winetricks first )

Tous les fichiers doivent être installés dans le répertoire suivant: ~/.wine/drive_c/Program Files (x86)/Lionhead Studios Ltd/Black & White

Obtenir les actifs

Les dossiers qui vous intéressent sont les dossiers Audio , Data et Scripts dans le répertoire d'installation. Vous pouvez les utiliser à partir de là ou en faire une copie à l'emplacement de votre choix.

Les utiliser en place

Si vous souhaitez les utiliser à partir de là, n'oubliez pas le répertoire d'installation choisi dans l'étape d'installation, sauf si vous l'avez changé, ce devrait être soit:

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

C'est le chemin que vous allez donner à OpenBlack (en utilisant le drapeau -g ).

Si vous préférez copier les données (par exemple, si vous souhaitez désinstaller le jeu d'origine), copiez simplement les dossiers Data et Scripts dans le nouvel emplacement souhaité et donnez le chemin vers cet emplacement à OpenBlack (en utilisant le drapeau -g ).

Licence

OpenBlack est publié en tant que logiciel open source sous la licence GPL V3, voir le fichier de licence dans la racine du projet pour le texte complet de licence.