/ORANGE-BBEMMN

Projet C - IMT Lille Douai - Raylib

Primary LanguageC

NetWorld - Game Engine for IAs competition

NetWorld se veut devenir un moteur de jeux basé sur la librairie multi-plateforme RayLib, respectant le principe KISS (Keep It Stupid Simple) La particularité du projet est de modéliser le monde comme un réseau de positions clés sur lesquelles peuvent de baller les entités en interaction.

Installation

Projet conçu pour une compilation avec GCC et la librairie Raylib. De par la nature de la procédure d'installation et de linkage, Linux est le système d'exploitation à préférer.

⚠️ Bien prendre le temps de lire la section d'installation qui vous concerne ⚠️

Linux (Debian based, e.g. Ubuntu) - Fortement recommandé

  1. Installer gcc, CMake et git:

Dans un terminal :

sudo apt update
sudo apt install build-essential git cmake
sudo apt install libasound2-dev mesa-common-dev libx11-dev libxrandr-dev libxi-dev xorg-dev libgl1-mesa-dev libglu1-mesa-dev
  1. Compiler et installer Raylib 3.0.0

La procédure ci-dessous provient du tutoriel officiel pour linux de raylib (cf. raylib-wiki), adapté pour les besoins du cours.

Tout d'abord, placez-vous dans le répertoire de votre choix, e.g. :

cd ~/Document/Cours

Une fois dans le répertoire de votre choix, il vous faut cloner la bibliothèque, et la compiler. Pour cela :

git clone https://github.com/raysan5/raylib.git raylib
cd raylib
git checkout '3.0.0'
mkdir build && cd build
cmake -DSHARED=ON -DSTATIC=ON ..
make

Ensuite, pour l'installer sur votre système :

sudo make install
cd ..

Une fois installé, vous pouvez, optionnellement, supprimer le dossier initial téléchargé depuis Github

rm -fr raylib

Dépendance sous Window - Non recommandé:

Configuration de MinGW

  1. Télécharger Minimalist GNU for Windows GCC tools' set (MinGW) à partir de la page de setup UI program.
  2. Lancer l'exécutable, et sélectionner/laisser le dossier d'installation comme étant votre racine système (C:).
  3. Une fois l'installation terminée, une nouvelle fenêtre s'ouvre (MinGW Installation Manager)
  4. Repérez les packets ci-dessous, et pour chacun d'eux, faites un clic droit > Mark for installation :
mingw-developer-toolkit-bin //(d'autres packages seront alors automatiquement sélectionnés)
mingw32-base-bin
mingw32-gcc-g++-bin
  1. Ensuite, dans la barre de menu, faire : Installation > Apply Changes > Apply. Le manager installera automatiquement les packages sélectionnés précédemment.
  2. Une fois les packages installés, AJOUTER sur une nouvelle ligne C:\MinGW\bin dans votre variable d'environnement PATH. Pour ce faire : panneau de conifg. > système et securite > système > param. système avancé > variable d'env. > PATH > Modifier. Cette variable regroupe l'ensemble des chemins absolus pour accéder aux ressources indiquées.

Configuration de GIT

Installer Git for Windows. On utilisera notamment son invite de commande git-bash comme terminal.

Configuration de Raylib

Installer Raylib en version 3.0.0 sous Windows [cf. raylib-wiki] en passant par la release pour MinGW :

  1. Télécharger la version 3.0.0 de RayLib pour Win32 mingw (même sur une machine 64bit).
  2. Extraire et déplacer le contenu des repertoires bin, include et lib respectivement dans les répertoires bin, include et lib se trouvant dans C:\MinGW (Attention ! Ne pas remplacer les dossiers)
  3. Copier C:\MinGW\bin\libraylib.dll dans C:\MinGW\bin\, et renommer la copie raylib.dll.
  4. Dans un terminal git-bash (pour l'ouvrir Menu Démarrer > Git Bash), taper la commande suivante :
cp C:/MinGW/bin/libraylib.dll C:/MinGW/bin/raylib.dll

(On aura aussi besoin du programme make qui permet d'automatiser le processus de construction d'un projet. Il est déjà installé, mais sous le nom de 'C:\MinGW\bin\mingw32-make.exe')

  1. Dans un terminal git-bash :
cp C:/MinGW/bin/mingw32-make.exe C:/MinGW/bin/make.exe
  1. Rebooter la machine (pour notamment prendre en charge le nouveau PATH).

Ouf...

Teste de l'installation

  1. Récupérer l'exemple basic de Raylib (le 1er encart) : copier le code dans un fichier main-basic.c sur votre machine.
  2. Ouvrir votre terminal, et vous placer dans votre dossier de travail. Par exemple :
cd C:/Users/me/Documents #Windows
# OU
cd /home/me/Documents #Linux
  1. Compiler à partir de votre terminal l'exemple :
gcc -o basic-raylib PATH/TO/main-basic.c -std=c99 -Wall -Wextra -lraylib
  1. Un exécutable est normalement généré. Lancez le pour vous assurez que tout fonctionne bien.
./basic-raylib.exe

Compiler NetWorld

Il n'y a plus qu'à cloner et compiler NetWorld :

git clone http://gvipers.imt-lille-douai.fr/fatus/networld.git NetWorld
cd NetWorld
make

Des exécutables sont générés au format nw-xxxx. Vous verrez également apparaître quelques warnings : n'en tenez pas compte.

Et voilà !

Organisation du répertoire

Répertoire:

  • bin : stocke de scripts pour automatiser des procédures utiles au projet.
  • .git : répertoire de gestion de version propre à git.
  • src : le code source du projet.
  • doc : la documentation du projet.

Fichier à la racine:

  • .gitignore : fichier de configuration git listant les ressources à ne pas versionner.
  • config : Fichier de configuration pour le make (cf. src/Makefile).
  • config.default : Fichier config utilisé à défaut (cf. Makefile).
  • Makefile : Instruction de construction du projet pour make. Génère config et fait appel à src/Makefile.
  • projet-outline.md : Un descriptif des composants logiciel réalisé et prévu.
  • nw-xxxx : Les exécutables de NetWorld.
  • README,md : Votre serviteur.

Idée de jeux induits:

Optimisation de routage dynamique (Pb. réseau)

Générer des robots et les déplacer pour couvrir au mieux un réseau.

  • être résiliant aux pannes
  • Réseau en constance augmentation
  • Circonscrire les Zones défectueuses....

WarBot

Des équipes de robots cherchent à s'entre-tuer.

OpenDrive

Course de véhicule en environnement ouvert et dynamique. (Avec des aspects de dynamique des véhicules quasiment absents, mais la nécessité de prendre en compte aux mieux les autres véhicules pour optimiser sont choix de chemins).

...