Aller au contenu principal

FAQ du projet

Cette FAQ couvre les problèmes fréquents d’installation et d’exécution de SnackAnarchy.

Le jeu ne se lance pas / la fenêtre se ferme aussitôt​

  • Lance le jeu depuis un terminal pour voir les messages d’erreur :
python main.py
  • Vérifie que tu es bien dans le dossier racine du projet (celui qui contient main.py et requirements.txt).
  • Si tu utilises un environnement virtuel, assure-toi qu’il est activé.

ModuleNotFoundError ou autre erreur de module manquant​

  • Vérifie que tu as bien installé les dépendances :
pip install -r requirements.txt
  • Si tu as plusieurs versions de Python, installe avec la même version que celle qui lance le jeu (python -m pip install ...).
  • Sous Windows, utilise éventuellement py -m pip install -r requirements.txt.

Problème de version de Python​

  • SnackAnarchy cible une version récente de Python (au moins 3.10, idéalement 3.11).
  • Vérifie ta version :
python --version
  • Si la version est trop ancienne, installe une version plus récente depuis le site officiel de Python ou ton gestionnaire de paquets.

Erreurs liées aux assets (fichiers introuvables, images manquantes)​

  • Ne déplace pas manuellement les dossiers :
    • assets/
    • game/
    • rendering/
    • ni les fichiers config.py, main.py.
  • Si tu as déplacé des fichiers, remets la structure d’origine ou reclone le dépôt.

Problèmes de son​

  • Vérifie que le volume système n’est pas à zéro et que la sortie audio est correcte.
  • Certains environnements (VM, bureau distant) gèrent mal l’audio :
    • teste sur une machine locale si possible ;
    • vérifie les messages d’erreur dans le terminal (Pygame peut signaler un problème de mixer audio).

Problèmes de contrôles (clavier, touches qui ne répondent pas)​

  • Ouvre le menu des touches depuis le menu principal ou le menu pause.
  • Vérifie les bindings pour chaque joueur et réassigne les touches si nécessaire.
  • Si tu es sur un clavier non QWERTY, adapte les touches de déplacement pour être plus confortable.

Problèmes d’affichage (résolution, plein écran)​

  • SnackAnarchy utilise une résolution fixe définie dans config.py.
  • Si la fenêtre dépasse ton écran :
    • réduis la résolution dans config.py (valeurs SCREEN_WIDTH / SCREEN_HEIGHT) ;
    • ou utilise un écran avec une résolution plus élevée.

Où demander de l’aide ?​

  • Consulte d’abord cette doc (pages Installation et Manuel Joueur).
  • Si le dépôt GitHub est public, tu peux ouvrir une issue avec :
    • ta plateforme (OS, version de Python) ;
    • la commande que tu as lancée ;
    • le message d’erreur complet.