Commit 2e167725 authored by LAIRD Timothy's avatar LAIRD Timothy

Update README.md

parent 53ec150b
# 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](https://fr.wikipedia.org/wiki/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é
### Installation sous Linux
---
1. **Installer gcc, CMake et git:**
......@@ -31,12 +22,7 @@ sudo apt install libasound2-dev mesa-common-dev libx11-dev libxrandr-dev libxi-d
La procédure ci-dessous provient du tutoriel officiel pour linux de raylib ([cf. raylib-wiki](https://github.com/raysan5/raylib/wiki/Working-on-GNU-Linux)), adapté pour les besoins du cours.
Tout d'abord, placez-vous dans le répertoire de votre choix, *e.g.* :
```bash
cd ~/Document/Cours
```
Une fois dans le répertoire de votre choix, il vous faut cloner la bibliothèque, et la compiler. Pour cela :
Tout d'abord, placez-vous dans le répertoire de votre choix. Une fois dans le répertoire de votre choix, il vous faut cloner la bibliothèque, et la compiler. Pour cela :
```bash
git clone https://github.com/raysan5/raylib.git raylib
......@@ -60,100 +46,23 @@ Une fois installé, vous pouvez, optionnellement, supprimer le dossier initial t
rm -fr raylib
```
## Compiler Risk
### Dépendance sous Window - Non recommandé:
**Configuration de MinGW**
1. Télécharger Minimalist GNU for Windows GCC tools' set ([MinGW](http://www.mingw.org/)) à partir de la page de [setup UI](https://osdn.net/projects/mingw/downloads/68260/mingw-get-setup.exe/) 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` :
```c
mingw-developer-toolkit-bin //(d'autres packages seront alors automatiquement sélectionnés)
mingw32-base-bin
mingw32-gcc-g++-bin
```
5. Ensuite, dans la barre de menu, faire : `Installation > Apply Changes > Apply`. Le manager installera automatiquement les packages sélectionnés précédemment.
6. 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](https://gitforwindows.org/). 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](https://github.com/raysan5/raylib)] en passant par la [release](https://github.com/raysan5/raylib/releases) pour MinGW :
1. Télécharger la version 3.0.0 de RayLib pour [Win32 mingw](https://github.com/raysan5/raylib/releases/download/3.0.0/raylib-3.0.0-Win32-mingw.zip) (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 :
Il n'y a plus qu'à cloner et compiler Risk :
```bash
cp C:/MinGW/bin/libraylib.dll C:/MinGW/bin/raylib.dll
git clone ssh://git@gvipers.imt-lille-douai.fr:2222/timothy.laird/networld.git Risk
cd Risk
./bin/build.sh
```
(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*')
5. Dans un terminal *git-bash* :
Un exécutable nommé risk sera généré et permettra d'exécuter le jeu en rentrant :
```bash
cp C:/MinGW/bin/mingw32-make.exe C:/MinGW/bin/make.exe
./risk
```
6. Rebooter la machine (pour notamment prendre en charge le nouveau *PATH*).
Ouf...
## Teste de l'installation
1. Récupérer l'[exemple](https://www.raylib.com/examples.html) 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 :
```bash
cd C:/Users/me/Documents #Windows
# OU
cd /home/me/Documents #Linux
```
3. Compiler à partir de votre terminal l'exemple :
```bash
gcc -o basic-raylib PATH/TO/main-basic.c -std=c99 -Wall -Wextra -lraylib
```
4. Un exécutable est normalement généré. Lancez le pour vous assurez que tout fonctionne bien.
```bash
./basic-raylib.exe
```
## Compiler NetWorld
Il n'y a plus qu'à cloner et compiler NetWorld :
```bash
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:
......@@ -175,33 +84,3 @@ Fichier à la racine:
- *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).
## ...
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment