Widelands est un jeu de stratégie gratuit en temps réel avec des campagnes solo et un mode multijoueur. Le jeu a été inspiré par Settlers II ™ (© BlueByte) mais a beaucoup plus de variété et de profondeur.
GPL V2 +. Certains actifs sont publiés sous diverses licences Creative Commons - voir les dossiers respectifs.
Sur la façon de télécharger widelands, voir https://www.widelands.org/wiki/download/
Nous prenons en charge la compilation de Widelands pour Linux, Windows Under MSYS2 et MSVC, et MacOS avec GCC> = 8 ou Clang / Llvm> = 7, bien que cela puisse également fonctionner avec d'autres compilateurs. Nous avons une documentation plus détaillée disponible sur: https://www.widelands.org/wiki/BuildingWidelands/
Vous devrez installer les dépendances suivantes:
Vous pouvez ensuite compiler en exécutant notre script de commodité.
| Commande | But |
|---|---|
./compile.sh | Construction de débogage complète |
./compile.sh -r -w | Version de libération |
./compile.sh -e -w | Version de libération avec des symboles de débogage |
./compile.sh -h | Liste des options disponibles |
Une fois la compilation, vous pouvez appeler Widelands avec
./widelands
Vous pouvez également appeler Cmake manuellement:
mkdir build
cd build
cmake ..
make
Une fois la compilation, vous pouvez appeler Widelands avec
cd ..
mv build/src/widelands .
./widelands
Nous avons diverses options CMake disponibles. Par exemple, pour créer une version de version, appelez
cmake -DCMAKE_BUILD_TYPE=Release ..
Pour utiliser le système de construction Ninja, appelez
mkdir build
cd build
cmake -G Ninja ..
ninja
Selon l'installation de Ninja, la dernière ligne peut également être ninja-build .
Notez que les options CMake sont préfixées avec -D . Ce sont les options disponibles:
| Nom | Valeurs | Défaut | Fonction |
|---|---|---|---|
CMAKE_BUILD_TYPE | Debug / Release / RelWithDebInfo | Debug | Créer une version de version ou de débogage |
OPTION_ASAN | ON / OFF | ON les constructions de débogage / OFF pour les versions de libération | Utilisez AddressSanitizer. L'éteindre ne fonctionne qu'une seule fois. Vous devrez effacer le répertoire build si vous souhaitez désactiver à nouveau cela dans une version ultérieure. |
OPTION_BUILD_CODECHECK | ON / OFF | ON | Créer CodeCheck. Disponible uniquement dans les versions de débogage. |
OPTION_BUILD_WEBSITE_TOOLS | ON / OFF | ON | Créer des outils liés au site Web |
OPTION_BUILD_TESTS | ON / OFF | ON | Construire des tests unitaires |
CMAKE_INSTALL_PREFIX | Un répertoire | Voir la documentation CMake | Définissez le répertoire cible de la cible "Installer", par exemple -DCMAKE_INSTALL_PREFIX=~/widelands-install . |
WL_INSTALL_BINDIR | Un répertoire | ${CMAKE_INSTALL_PREFIX}/games | Définissez la destination des fichiers exécutables (si l'installation) |
WL_VERSION | Une chaîne de version | AutoDetected à partir de GIT / BZR, ou défini en ajoutant un fichier VERSION | Définissez la version Widelands |
USE_XDG | ON / OFF | ON | Suivez les spécifications XDG-basés sur XDG. Uniquement disponible sur Linux. |
OPTION_USE_GLBINDING | ON / OFF | OFF | Utilisez Glbinding au lieu de Glew |
OPTION_GLEW_STATIC | ON / OFF | OFF | Utilisez la bibliothèque Glew statique |
OPTION_FORCE_EMBEDDED_MINIZIP | ON / OFF | OFF | Sources de minizip intégrées utilisées (sauter la vérification de la bibliothèque minizip installée) |
NEEDS_EXTERNAL_FILESYSTEM | ON / OFF | AutoDetected à partir de la version du compilateur | Si std::filesystem doit être lié à une bibliothèque supplémentaire |
Vous pouvez ajouter des cibles à la commande make ou ninja , par exemple, make codecheck pour exécuter uniquement la suite de vérification de code. Ce sont les cibles disponibles:
| Nom | Fonction |
|---|---|
ALL ou pas de cible | Compilez tout, jusqu'à l'exécutable avec les paramètres de l'appel cmake |
codecheck | Exécutez les codechcks |
doc | Générez la documentation du doxygen. Actuellement uniquement avec le débogage de type build, mais cela est facilement modifié si nécessaire. |
install | Installez dans le Dir cible, c'est /usr/local par défaut (vous avez besoin de privilèges racine!) Sauf vous le modifier (voir les options CMake ci-dessus) |
Nous avons quelques instructions sur la façon d'utiliser GIT pour vous aider si vous êtes nouveau dans Git: https://www.widelands.org/wiki/gitprimer/
La branche principale et tous les problèmes et les demandes de traction sont en miroir bidirectionnellement entre nos environnements de développeur sur Codeberg et GitHub par BunnyBot. BunnyBot formate également le code (C ++, Lua et Python) dans toutes les branches en miroir.
Nous suivons le Google StyleGuide.
Pour les scénarios de script, voir https://www.widelands.org/documentation/lua_index/
Pour contribuer à l'art, voir https://www.widelands.org/wiki/graphicsdevelopment/
Pour les traductions qui ont contribué, voir https://www.widelands.org/wiki/translatingwidelands/
Pour aider aux tests, voir https://www.widelands.org/wiki/testingbranches/
Pour aider à la gestion des problèmes, consultez https://www.widelands.org/wiki/trigingbugs/
| Annuaire | Contenu |
|---|---|
| cmake | Règles du système et du code de code |
| données | Les fichiers de données du jeu. Images, sons, musique, script, cartes, campagnes, tribus, ... |
| Debian | Emballage pour les distributions Linux basées à Debian |
| doc | Documentation Sphinx |
| pote | Fichiers de traduction |
| SRC | Code source C ++ |
| test | Cartes scriptées pour notre suite de tests de régression |
| utils | Utilitaires divers: construire des traductions, formatage de code, emballage Mac & Windows, ... |
Toutes les poussées à maîtriser seront construites sur des appuyes. Les branches de demande de tirage sont déployées pour MS-Windows à l'aide d'une action GitHub. Pour obtenir des builds MS-Windows si vous ne souhaitez pas ouvrir une demande de traction, ajoutez temporairement le nom de votre branche à la section branches dans appveyor.yml . Cela ne fonctionnera pas si la branche est dans une fourchette.
Toutes les succursales de demande de traction ainsi que Master sont en outre déployées pour macOS, et un testsuite les vérifie sous divers compilateurs. Pour obtenir des builds macOS ou des résultats TestSuite, ajoutez temporairement le nom de votre branche à la section branches dans .github/workflows/build.yaml . Cela fonctionne également pour les succursales dans des fourches.