95 lines
No EOL
4.8 KiB
Markdown
95 lines
No EOL
4.8 KiB
Markdown
## Table des matières
|
|
|
|
- [À propos](#à-propos)
|
|
- [Installation](#installation)
|
|
- [Dépendances requises](#dépendances-requises)
|
|
- [Commandes](#commandes)
|
|
- [Crédits](#crédits)
|
|
- [Aide](#aide)
|
|
- [Questions fréquentes](#questions-fréquentes)
|
|
- [Indications pour les développeurs](#indications-pour-les-développeurs)
|
|
- [Ajouter des rôles](#ajouter-des-rôles)
|
|
- [Publier un rôle](#publier-un-rôle)
|
|
- [Quelques classes utiles](#quelques-classes-utiles)
|
|
|
|
## À propos
|
|
|
|
Le mode Loup-Garou est un mode inspiré du jeu de société [Les Loups-Garous de Thiercelieux](https://fr.wikipedia.org/wiki/Les_Loups-garous_de_Thiercelieux) reprenant son fonctionnement ainsi que sa manière d'être joué, à la seule différence qu'aucun maître du jeu n'est requis, le déroulement de chaque partie étant entièrement automatisé :
|
|
|
|
- Déroulement de la partie automatisé
|
|
- Rôles du jeu de base, et nouveaux rôles
|
|
- Utilisable sur n'importe quelle map
|
|
|
|
## Installation
|
|
|
|
**Minecraft 1.15.1 est requis.**
|
|
Déplacez simplement le plugin compilé [LoupGarou.jar](https://github.com/leomelki/LoupGarou/releases) dans le dossier `plugins` de votre serveur avant de le redémarrer.
|
|
|
|
### Dépendances requises
|
|
|
|
- [ProtocolLib](https://www.spigotmc.org/resources/protocollib.1997/)
|
|
|
|
## Commandes
|
|
|
|
`/lg roles` : Retourne la liste des rôles dans la partie
|
|
`/lg roles set <ID> <MONTANT>` : Définit le nombre de joueurs pour un certain rôle
|
|
`/lg addSpawn` : Ajoute un point de spawn (emplacement de joueur)
|
|
`/lg start <PSEUDO>` : Lance la partie
|
|
`/lg end <PSEUDO>` : Arrête une partie
|
|
`/lg reloadConfig` : Recharge la configuration
|
|
`/lg joinAll` : À utiliser après avoir changé les rôles
|
|
|
|
## Crédits
|
|
|
|
- Chef de Projet : [Shytoos](https://twitter.com/shytoos_)
|
|
- Développement : [Leomelki](https://twitter.com/leomelki)
|
|
- Mapping : [Cosii](https://www.youtube.com/channel/UCwyOcA41QSk590fl9L0ys8A)
|
|
|
|
## Aide
|
|
|
|
Par soucis de temps, nous ne pouvons pas faire de support au cas par cas, mais vous pouvez rejoindre notre serveur [Discord](https://discord.gg/Squeezie) pour trouver de l'aide auprès de la communauté.
|
|
|
|
### Questions fréquentes
|
|
|
|
- Que faire en cas de problème d'affichage (votes bloqués au dessus des têtes, etc...) ?
|
|
|
|
Cela arrive après avoir `reload` au cours d'une partie, tous les joueurs qui ont ce problème doivent se déconnecter et se reconnecter.
|
|
|
|
- Pourquoi la partie ne se lance pas ?
|
|
|
|
Il faut taper la commande `/lg start <PSEUDO>` en mettant le pseudo d'un des joueurs qui sera présent dans la partie. Si cela ne fonctionne toujours pas, c'est parce qu'il n'y a pas suffisamment de rôles pour le nombre de joueurs, il doit y avoir le même nombre de rôles qu'il y aura de joueurs dans la partie. N'oubliez pas de taper `/lg joinAll` après avoir modifié la liste des rôles.
|
|
|
|
- J'ai mal placés mes spawns ou je veux utiliser une nouvelle map, comment faire ?
|
|
|
|
Il suffit d'ouvrir le fichier `plugins\LoupGarou\config.yml` et de supprimer les points de spawn.
|
|
|
|
- Puis-je mettre plusieurs fois le même rôle dans une seule partie ?
|
|
|
|
Cela est possible pour les rôles `Loup-Garou`, `Villageois` et `Chasseur`.
|
|
D'autres rôles peuvent aussi marcher mais n'ont pas été testés avec plusieurs joueurs ayant ce rôle dans une seule partie. C'est à vos risques et périls.
|
|
|
|
##Indications pour les développeurs
|
|
|
|
Ce plugin LoupGarou ayant été modifiés de nombreuses fois, parfois dans des timings tendus, le code n'est pas très propre.
|
|
De plus, il n'est pas documenté.
|
|
Cependant, si l'envie vous prend de modifier ou d'utiliser la totalité ou une partie du code présent dans cette repo, merci de créditer `leomelki` et `Shytoos`.
|
|
|
|
###Ajouter des rôles
|
|
|
|
Ce plugin de Loup-Garou est organisé autour d'un système d'évènements, disponnibles dans le package `fr.leomelki.loupgarou.events`.
|
|
N'ayant pas le temps de les documenter, vous devriez comprendre vous-même quand ils sont appelés.
|
|
|
|
Pour vous aider à créer des rôles, copiez des rôles ayant déjà été créés pour ainsi les modifier.
|
|
|
|
⚠️ Ce projet a été créé de façon à ce que les rôles soient - presque - totalement indépendants du reste du code (LGGame, LGPlayer...).
|
|
Merci de garder ça en tête lors du développement de nouveaux rôles : utilisez un maximum les évènements et, s'il en manque, créez les !
|
|
|
|
####Quelques classes utiles
|
|
`LGGame` : Contient le coeur du jeu, à modifier le minimum possible !
|
|
`LGPlayer` : Classe utilisée pour interragir avec les joueurs et stocker leurs données, à modifier le minimum possible !
|
|
`LGVote` : Système gérant les votes
|
|
`RoleSort`: Classement de l'apparition des rôles durant la nuit.
|
|
|
|
###Publier un rôle
|
|
|
|
Si vous arrivez à créer un rôle, je vous invite à faire une demande de publication dans cette repo afin de les faire partager à l'ensemble de la communauté ! |