Zappy - Epitech Project

The repository for the Zappy project.

---

Table of contents

1. The purpose of the project
2. How to use Zappy
3. How to launch
4. People on the project

---

1. The purpose of the project

Welcome to "Zappy" – an electrifying network game that will spark your competitive spirit! In this thrilling project, we aim to create an engaging multiplayer experience where teams battle it out on a dynamic tile-based map filled with valuable resources.

The primary objective of Zappy is to lead your team to victory by being the first to have at least six players reach the maximum elevation. But beware, the path to triumph is riddled with challenges and intense competition. Strategic decision-making, efficient resource management, and effective teamwork will be the keys to success.

As you explore the following pages, you will uncover the intricacies of the game's mechanics and the constraints that shape this electrifying adventure. From understanding the layout of the map and its resource distribution to devising winning strategies, you'll gain valuable insights into how to outmaneuver your opponents.

Prepare to immerse yourself in a world where lightning-fast reflexes and cunning tactics reign supreme. Collaborate closely with your teammates, navigate the ever-changing terrain, and capitalize on the available resources to surge ahead in the race to the highest elevation.

Get ready to embrace the pulse-pounding excitement of Zappy, where lightning strikes and fortunes change in an instant. May your team harness the power of strategy and skill to outshine the competition and emerge as champions in this electrifying network game!

---

2. How to use Zappy

Cloner le dépôt : Commencez par cloner le dépôt du projet Zappy depuis Github. Utilisez la commande suivante dans votre terminal :

git clone <[email protected]:EpitechPromo2026/B-YEP-400-PAR-4-1-zappy-viktor.bruggeman.git>

Installer les dépendances : Accédez au répertoire cloné et assurez-vous d'avoir toutes les dépendances nécessaires installées. Consultez le fichier README ou le fichier d'installation fourni pour connaître les dépendances spécifiques.

Configurer le serveur : Le projet Zappy nécessite un serveur pour fonctionner. Consultez la documentation fournie avec le projet pour connaître les paramètres de configuration spécifiques. Vous devrez peut-être spécifier le port d'écoute, les dimensions de la carte, le nombre maximum de clients, etc.

Compiler le serveur : Utilisez les commandes de compilation fournies pour compiler le serveur. Ces commandes peuvent varier en fonction du langage utilisé dans le projet. Assurez-vous de compiler avec les options appropriées pour activer les fonctionnalités nécessaires.

Lancer le serveur : Une fois que le serveur est compilé, vous pouvez le lancer en utilisant la commande spécifiée. Assurez-vous que le serveur est en cours d'exécution et qu'il écoute sur le port spécifié.

Configurer les clients : Les clients sont les entités qui interagissent avec le serveur Zappy. Assurez-vous de configurer les clients avec les paramètres appropriés pour se connecter au serveur. Vous devrez spécifier l'adresse IP du serveur, le port de connexion, le nom de l'équipe, etc.

Compiler les clients : Si nécessaire, compilez les clients en utilisant les commandes de compilation fournies. Encore une fois, ces commandes peuvent varier en fonction du langage utilisé dans le projet.

Lancer les clients : Une fois que les clients sont compilés, vous pouvez les lancer en utilisant la commande spécifiée. Assurez-vous de lancer suffisamment de clients pour tester les fonctionnalités multi-joueurs du projet.

---

3. How to launch the AI

> make AI
> /zappy_ai -p port -n name -h machine
    port is the port number
    name is the name of the team
    machine is the name of the machine; localhost by default

4. How to launch the GUI

To run the project:

> make GUI
> ./zappy_ai -p port -h machine
    port is the port number
    machine is the name of the machine; localhost by default

5. How to launch the Server

> make server
> ./zappy_server -p port -x width -y height -n name1 name2 ... -c clientsNb -f freq
    port            is the port number
    width           is the width of the world
    height          is the height of the world
    nameX           is the name of the team X
    clientsNb       is the number of authorized clients per team
    freq            is the reciprocal of time unit for execution of actions

Incantation

In order to win in zappy you and all the member of your team must reach lvl 8 (at least 6 of them), by collecting some resource and starting the incantation ritual. There exist different resource: linemate, deramere, sibur, mendiane, phiras and thystame. Those resource will spawn depending of there density and the size of the map.

Here the conditions to reach the next lvl of a player:

elevation	nb of players	Linemate	Deraumere	Sibur	Mendiane	Phiras	Thystame
1->2	1	1	0	0	0	0	0
2->3	2	1	1	1	0	0	0
3->4	2	2	0	1	0	2	0
4->5	4	1	1	2	0	1	0
5->6	4	1	2	1	3	0	0
6->7	6	1	2	3	0	1	0
7->8	6	2	2	2	2	2	1

.6 Contributors

Bastien Rodrigues	Cyprien Nguyen-Van-Vien	Damien Benais-Captal	Pierre-Louis Leroy	Viktor Bruggeman	Virgile Berrier

[email protected]
[email protected]
[email protected]
[email protected]
[email protected]
[email protected]