https://github.com/gh0st-cmd/plugin-loupgarou
Plugin Minecraft Loup-Garou complet en français | 5 rôles | WorldGuard | Stats | Scoreboard personnel | Compatible 1.21.8+
https://github.com/gh0st-cmd/plugin-loupgarou
bukkit francais french game java loup-garou minecraft minecraft-plugins minecraft-server minigame multiplayer paper party-game spigot werewolf worldguard
Last synced: 15 days ago
JSON representation
Plugin Minecraft Loup-Garou complet en français | 5 rôles | WorldGuard | Stats | Scoreboard personnel | Compatible 1.21.8+
- Host: GitHub
- URL: https://github.com/gh0st-cmd/plugin-loupgarou
- Owner: Gh0st-cmd
- License: mit
- Created: 2025-09-30T20:42:51.000Z (16 days ago)
- Default Branch: main
- Last Pushed: 2025-09-30T21:48:32.000Z (16 days ago)
- Last Synced: 2025-09-30T22:27:17.861Z (16 days ago)
- Topics: bukkit, francais, french, game, java, loup-garou, minecraft, minecraft-plugins, minecraft-server, minigame, multiplayer, paper, party-game, spigot, werewolf, worldguard
- Language: Java
- Homepage:
- Size: 56.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐺 Plugin Loup-Garou pour Minecraft
[](https://www.minecraft.net/)
[](https://www.spigotmc.org/)
[](https://papermc.io/)
[](https://www.oracle.com/java/)
[](LICENSE)
> Plugin Minecraft complet et immersif pour jouer au célèbre jeu du Loup-Garou directement sur votre serveur ! 🎮
## 📖 Description
**LoupGarou** est un plugin Minecraft entièrement en français qui permet de jouer au jeu du Loup-Garou (Werewolf) avec vos amis sur votre serveur Minecraft. Le plugin offre une expérience complète avec tous les rôles classiques, un système de phases automatiques, des statistiques de joueurs et une intégration WorldGuard pour limiter le jeu à une zone spécifique.
## ✨ Fonctionnalités principales
### 🎭 Rôles disponibles
- **🐺 Loup-Garou** : Éliminez les villageois chaque nuit
- **👨🌾 Villageois** : Trouvez et éliminez les loups-garous par vote
- **🔮 Voyante** : Découvrez le rôle d'un joueur chaque nuit
- **🛡️ Garde** : Protégez un joueur des attaques nocturnes
- **🧪 Sorcière** : Utilisez vos potions de vie et de mort (usage unique)
### 🎮 Système de jeu complet
- ✅ **Phases automatiques** : Nuit → Jour → Vote → Répéter
- ✅ **Durées configurables** pour chaque phase
- ✅ **Conditions de victoire** automatiques
- ✅ **Chat spécialisé** pour les morts et les loups-garous
- ✅ **Scoreboard dynamique** avec affichage du rôle personnel
- ✅ **Effets sonores** immersifs selon les phases
- ✅ **Système de vote** intégré avec comptage automatique
### 🌍 Intégration WorldGuard
- ✅ **Zone de jeu dédiée** : Restreint le jeu à une région WorldGuard spécifique
- ✅ **Monde configurable** : Choisissez le monde de jeu
- ✅ **Spawn personnalisé** : Définissez le point de spawn avec `/lg setspawn`
- ✅ **Compatible sans WorldGuard** : Fonctionne aussi sans restriction de zone
### 📊 Fonctionnalités avancées
- ✅ **Statistiques persistantes** : Parties jouées, victoires, morts
- ✅ **Configuration complète** : Durées, ratios de rôles, messages personnalisables
- ✅ **Compatible LuckPerms** : Ne modifie pas les préfixes de chat hors partie
- ✅ **Multi-monde** : N'affecte que les joueurs participant à la partie
- ✅ **Système de permissions** : Gestion fine des accès
- ✅ **Commande reload** : Rechargez la config sans redémarrer le serveur
## 🚀 Installation
### Prérequis
- **Minecraft** 1.21+ (Spigot/Paper)
- **Java** 17 ou supérieur
- **WorldGuard** 7.0+ (optionnel)
### Étapes d'installation
1. **Téléchargez** le fichier `LoupGarou-1.0.0.jar` depuis les [releases](../../releases)
2. **Placez** le fichier dans le dossier `plugins/` de votre serveur
3. **Redémarrez** votre serveur
4. **Configurez** (optionnel) le fichier `plugins/LoupGarou/config.yml`
5. **Créez une région WorldGuard** (optionnel) :
```
/rg define loupgarou
```
6. **Définissez le spawn** :
```
/lg setspawn
```
7. **Lancez une partie** :
```
/lg start
```
## 🎯 Commandes
### Commandes d'administration
| Commande | Description | Permission |
|----------|-------------|------------|
| `/lg start` | Démarrer une partie | `loupgarou.admin` |
| `/lg stop` | Arrêter la partie en cours | `loupgarou.admin` |
| `/lg reload` | Recharger la configuration | `loupgarou.admin` |
| `/lg setspawn` | Définir le spawn de jeu | `loupgarou.admin` |
| `/lg statut` | Voir le statut de la partie | `loupgarou.use` |
| `/lg liste` | Voir la liste des joueurs | `loupgarou.use` |
### Commandes de jeu
| Commande | Description | Permission |
|----------|-------------|------------|
| `/vote ` | Voter pour éliminer un joueur | `loupgarou.vote` |
| `/lg stats` | Voir ses statistiques | `loupgarou.use` |
| `/lg aide` | Afficher l'aide | `loupgarou.use` |
### Commandes par rôle
| Commande | Rôle | Description |
|----------|------|-------------|
| `/lg tuer ` | 🐺 Loup-Garou | Choisir une victime la nuit |
| `/lg voir ` | 🔮 Voyante | Découvrir le rôle d'un joueur |
| `/lg proteger ` | 🛡️ Garde | Protéger un joueur la nuit |
| `/lg soigner ` | 🧪 Sorcière | Ressusciter un joueur |
| `/lg empoisonner ` | 🧪 Sorcière | Tuer un joueur |
## ⚙️ Configuration
Le fichier `config.yml` est automatiquement créé au premier démarrage :
```yaml
# Configuration du jeu
game:
min-players: 4 # Nombre minimum de joueurs
max-players: 20 # Nombre maximum de joueurs
night-duration: 60 # Durée de la nuit (secondes)
day-duration: 120 # Durée du jour (secondes)
vote-duration: 60 # Durée du vote (secondes)
auto-restart: true # Redémarrage automatique
restart-delay: 30 # Délai avant redémarrage (secondes)
# Configuration du spawn
spawn:
world: "minijeux" # Monde de jeu
x: 0.5 # Coordonnée X
y: 100.0 # Coordonnée Y
z: 0.5 # Coordonnée Z
yaw: 0.0 # Rotation horizontale
pitch: 0.0 # Rotation verticale
# Intégration WorldGuard
worldguard:
enabled: true # Activer WorldGuard
region-name: "loupgarou" # Nom de la région
world-name: "minijeux" # Monde de la région
check-on-join: true # Vérifier à la connexion
# Configuration des rôles
roles:
werewolf:
ratio: 0.25 # 1 loup pour 4 joueurs
seer:
min-players: 6 # Minimum pour la voyante
guard:
min-players: 8 # Minimum pour le garde
witch:
min-players: 10 # Minimum pour la sorcière
# Scoreboard
scoreboard:
enabled: true # Activer le scoreboard
only-in-region: true # Afficher seulement dans la région
update-interval: 20 # Intervalle de mise à jour (ticks)
```
## 🎨 Captures d'écran
### Scoreboard avec rôle personnel
```
╔════════════════╗
║ 🐺 LOUP-GAROU ║
║ ║
║ 🎭 Votre rôle: ║
║ 🔮 Voyante ║
║ ║
║ 📊 État: Nuit ║
║ 🌅 Jour: 3 ║
║ ║
║ 🐺 Loups: 2 ║
║ 👥 Village: 5 ║
║ ║
║ ✅ Vivant ║
╚════════════════╝
```
### Messages de chat
```
[Nuit] 👤 Joueur1 » Qui est suspect ?
[Loups] 🐺 LoupGarou1 » On tue Joueur2 !
[Morts] 💀 Joueur3 » Ah je savais !
```
## 🔧 Compilation
### Avec Maven
```bash
git clone https://github.com/Gh0st-cmd/Plugin-LoupGarou.git
cd Plugin-LoupGarou
mvn clean package
```
Le fichier `.jar` sera généré dans `target/LoupGarou-1.0.0.jar`
### Avec Gradle
```bash
git clone https://github.com/Gh0st-cmd/Plugin-LoupGarou.git
cd Plugin-LoupGarou
gradle build
```
Le fichier `.jar` sera généré dans `build/libs/LoupGarou-1.0.0.jar`
## 📋 Permissions
| Permission | Description | Défaut |
|------------|-------------|--------|
| `loupgarou.admin` | Accès aux commandes d'administration | OP |
| `loupgarou.use` | Utiliser les commandes de base | Tous |
| `loupgarou.vote` | Pouvoir voter | Tous |
| `loupgarou.bypass` | Contourner les restrictions en jeu | OP |
## 🤝 Contribution
Les contributions sont les bienvenues ! N'hésitez pas à :
1. 🍴 **Fork** le projet
2. 🔨 **Créer** une branche (`git checkout -b feature/amélioration`)
3. 💾 **Commit** vos changements (`git commit -m 'Ajout d'une fonctionnalité'`)
4. 📤 **Push** vers la branche (`git push origin feature/amélioration`)
5. 🎉 **Ouvrir** une Pull Request
## 📝 Roadmap
- [ ] Ajout de nouveaux rôles (Cupidon, Chasseur, Ancien, etc.)
- [ ] Système de parties classées
- [ ] Intégration Discord pour notifications
- [ ] Support multi-langues
- [ ] Interface graphique (GUI)
- [ ] Mode spectateur amélioré
- [ ] Enregistrement et replay des parties
## 🐛 Rapporter un bug
Si vous trouvez un bug, merci de créer une [issue](../../issues) avec :
- 📝 Description détaillée du problème
- 🔄 Étapes pour reproduire
- 📸 Captures d'écran si possible
- 📊 Version du plugin, de Minecraft et du serveur
- 📄 Logs d'erreur
## 💬 Support
- 📖 **Wiki** : [Lien vers le wiki](../../wiki)
- 💬 **Discord** : [Rejoindre le serveur Discord](https://discord.gg/DGeGB5cmxQ)
## 📜 Licence
Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.
## 👏 Remerciements
- Merci à la communauté Spigot/Paper pour leurs ressources
- Inspiré du jeu de société Loup-Garou de Thiercelieux
- Merci à tous les contributeurs et testeurs
## 📊 Statistiques
---
Développé avec ❤️ pour la communauté Minecraft francophone 🇫🇷
🐺 Bon jeu et que le meilleur gagne ! 🎮