Aller au contenu principal

Installation & Lancement

Cette page explique comment installer et lancer SnackAnarchy à partir du dépôt de code.

Prérequis​

  • Python 3.11 (ou version compatible avec ton environnement),
  • pip installé,
  • un terminal (macOS, Linux ou Windows),
  • les bibliothèques listées dans requirements.txt du projet.

Cloner le projet​

Clône (ou copie) le dépôt SnackAnarchy sur ta machine depuis GitHub :
https://github.com/thisiskeanyvy/snackanarchy

cd /chemin/vers/ton/dossier
git clone https://github.com/thisiskeanyvy/snackanarchy.git
cd snackanarchy

Si tu n’utilises pas Git, tu peux simplement copier le dossier snackanarchy fourni (par exemple à partir d’une archive ZIP du dépôt GitHub).

Installer les dépendances​

Depuis la racine du projet (là où se trouve requirements.txt) :

pip install -r requirements.txt

Cette commande installe toutes les bibliothèques nécessaires au jeu (Pygame, etc., selon le contenu de requirements.txt).

(Optionnel) Utiliser un environnement virtuel​

Il est recommandé d’isoler les dépendances du jeu dans un environnement virtuel.

Sous macOS / Linux​

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Sous Windows (PowerShell)​

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt

Pense à réactiver l’environnement (source .venv/bin/activate ou .venv\Scripts\Activate.ps1) à chaque nouvelle session avant de lancer le jeu.

Lancer le jeu​

Toujours à la racine du projet :

python main.py

Le jeu devrait s’ouvrir dans une fenêtre.
Si tu utilises un environnement virtuel (recommandé), active-le avant de lancer le jeu.

Problèmes fréquents (FAQ rapide)​

  • Erreur de module manquant : vérifie que tu as bien exécuté pip install -r requirements.txt dans le bon environnement.
  • Version de Python incompatible : assure-toi d’utiliser une version suffisamment récente (>= 3.10 de préférence).
  • Chemins d’assets : ne déplace pas les dossiers assets/, game/, rendering/ ou les fichiers config.py, main.py sans mettre à jour les chemins dans le code.
  • Le jeu ne se lance pas / fenêtre qui se ferme aussitôt :
    • lance le jeu depuis un terminal pour voir les messages d’erreur ;
    • vérifie que tu es bien dans le bon dossier (snackanarchy) et que l’environnement virtuel est actif.

Pour des cas plus spécifiques (problèmes de son, manettes, résolution…), consulte la page project-faq.