TerminalDefense

un Tower Défense en terminal

Un tower défense en terminal, codé en C, sans dépendances externes (à part la librairie standard C).

Build instruction

Tous systèmes (incluant Windows/linux)

Il est possible de tester le jeu sans l'installer a l'aide de ssh (demande une connexion internet):

• En commande ssh -4Cp 389 [email protected] Il vous serra demandé, la première fois, d'accepter une clé ssh (répondez oui ou yes, selon la langue)
• avec un client ssh, renseignez les informations suivantes
  • Adresse: mwaaa.fr
  • Nom d'utilisateur: insecure
  • Port: 389

NB: Il n'est pas possible de cette manière de modifier les raccourcis claviers
NB: Cette solution est mise à disposition car le programme fonctionne très mal sur caséine (lag + timeout + mauvais rendu)

Linux/unix/mac

_ (normalement, mac est supporté, mais non tésté) _

• Installez make et un compilateur C (par ex gcc) Ceux-ci sont généralement disponibles dans le paquet base-devel
• Téléchargez touts les fichiers du projet (git clone https://github.com/chalbin73/terminal_defense)
• Allez dans le répertoire du projet (cd terminal_defense)
• Si vous le souhaitez, modifiez les raccourcis claviers dans le fichier src/config.h
• Compilez en lançant make dans le dossier du projet, cela crée le fichier exécutable terminal_defense (lançable avec ./terminal_defense)

Windows

Voici les différentes possibilités, du plus facile au plus compliqué

• Utilisez la version ssh (pour tester la compilation, vous pouvez aller sur caséine, mais lancer le programme dessus est fortement déconséillé)
• Vous avez déjà wsl/une vm linux: suivez les instructions de build linux en l'utilisant
• Installez make et gcc sur windows a l'aide de cygiwin ou autre équivalent, puis suivez les instructions de build linux (non testé, peut ne pas fonctionner) /!\ Le fonctionnement n'a jamais été testé sur Windows, il n'est pas garanti

Tester le programme

1. Le terminal dans lequel est lancé le jeu ne doit pas changer de taille une fois le jeu lancé, mettez donc votre terminal a la taille souhaitée pour jouer avant de lancer le jeu (pour une expérience optimale, mettez vous en plein écran) (un fonctionnement minimal requiert une taille de plus de 30 × 20 caractères, des bugs graphiques peuvent apparaitre en dessous)

2. Apprenez les raccourcis claviers

   • Les raccourcis claviers par défaut (et de la version en ligne) sont détaillé ci-dessous (section Contrôles)
   • Vous pouvez les modifier dans config.h (il faut alors recompiler avec la commande make, et les raccourcis Maj+touche sont également modifiés)

3. Lancez le jeu

• Si vous avez compilé, l'exécutable se nomme terminal_defense et peut se lancer avec la commande ./terminal_defense dans le dossier du jeu
• Si vous utilisez la version ssh, relancer simplement la commande ssh (ssh -4Cp 389 [email protected])

4. Survivez !

• Les monstres (les flèches à gauche de l'écran) tentent d'atteindre et de détruire votre base (le drapeau à droite de l'écran)
• Pour les en empêcher, construisez des défenses (murs et tourelles)
• Le jeu se termine lorsque vous mourez (vie de la base a 0), que le jeu crash (ça n'arrive pas, normalement) ou que vous quittez le jeu avec le raccourci clavier associé

Contrôles

• zqsd : Déplacements du curseur
• Maj maintenu : Déplacements du curseur 5x plus rapide
• c : Ouverture du menu construction
  • sélection avec les touches de déplacement
  • annulation avec déplacement à gauche
  • validation avec déplacement à droite/touche de construction
• Maj maintenu: construit la dernière défense construite (pas de sélection)
• Ctrl+c: Quitter le programme

Ce qui fonctionne/ne fonctionne pas

Ce qui fonctionne

Le jeu:

• Les monstres se déplacent vers la base, détruisant ou contournant les obstacles sur leur passage
• Les tourelles tirent sur les monstres, permettant de les tuer
• La mort des monstres permet de gagner des ressources de construction ainsi que du score
• Les constructions illégales (sur une autre/manque de ressources) sont impossibles

Le menu:

• On peut choisir sa difficulté
• On peut relancer une partie lorsque l'on meurt

Ce qui ne fonctionne pas

Le build sur Windows

• Pas de disponibilité de make facilement
• Code non testé

Le jeu sur caséine

Le code compile et se lance, cependant

• L'affichage est moche
• Fines bandes noires entre chaque caractère
• Décalage des lignes (police non monospace)
• Timeout au bout de 240s (une partie complète durant généralement plus longtemps)

Structure du projet

• README.md (Ce fichier) Documentation et présentation
• Critères.md Indique ou trouver les points de conformance aux critères d'évaluation, si vous vous perdez dans le code
• Makefile contient les commandes de compilation.
• build dossier créé à la compilation, contient les fichiers crée par le compilateur.
• src Contient le code source.

Structure du code

• terminaldefense.c Contient le code principal du jeu en lui-même
• terminaldefense.h Contient les définitions de structures et fonctions du jeu
• graphical.h graphical.c Contient le code relatif au rendu "graphique" dans le terminal
• common.h common_and_ressources.c Contient des utilitaires communs à tout le projet, plus les ressources du projet
• config.h Contient la configuration du jeu, ce fichier est fait pour être modifié par les utilisateurs

Licence

Ce projet et licencié avec la licence MIT:

Copyright 2023 maddcoder [email protected] albin CHABOISSIER

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.