{"id":31500255,"url":"https://github.com/gh0st-cmd/plugin-loupgarou","last_synced_at":"2026-05-17T00:35:17.586Z","repository":{"id":317438141,"uuid":"1067418954","full_name":"Gh0st-cmd/Plugin-LoupGarou","owner":"Gh0st-cmd","description":"Plugin Minecraft Loup-Garou complet en français | 5 rôles | WorldGuard | Stats | Scoreboard personnel | Compatible 1.21.8+","archived":false,"fork":false,"pushed_at":"2025-09-30T21:48:32.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-30T22:27:17.861Z","etag":null,"topics":["bukkit","francais","french","game","java","loup-garou","minecraft","minecraft-plugins","minecraft-server","minigame","multiplayer","paper","party-game","spigot","werewolf","worldguard"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Gh0st-cmd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-30T20:42:51.000Z","updated_at":"2025-09-30T21:48:36.000Z","dependencies_parsed_at":"2025-10-01T10:16:41.209Z","dependency_job_id":null,"html_url":"https://github.com/Gh0st-cmd/Plugin-LoupGarou","commit_stats":null,"previous_names":["gh0st-cmd/plugin-loupgarou"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Gh0st-cmd/Plugin-LoupGarou","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gh0st-cmd%2FPlugin-LoupGarou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gh0st-cmd%2FPlugin-LoupGarou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gh0st-cmd%2FPlugin-LoupGarou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gh0st-cmd%2FPlugin-LoupGarou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Gh0st-cmd","download_url":"https://codeload.github.com/Gh0st-cmd/Plugin-LoupGarou/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Gh0st-cmd%2FPlugin-LoupGarou/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278038304,"owners_count":25919562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-02T02:00:08.890Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","francais","french","game","java","loup-garou","minecraft","minecraft-plugins","minecraft-server","minigame","multiplayer","paper","party-game","spigot","werewolf","worldguard"],"created_at":"2025-10-02T17:07:08.026Z","updated_at":"2026-05-17T00:35:17.580Z","avatar_url":"https://github.com/Gh0st-cmd.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐺 Plugin Loup-Garou pour Minecraft\n\n[![Minecraft](https://img.shields.io/badge/Minecraft-1.21--1.21.11-brightgreen.svg)](https://www.minecraft.net/)\n[![Spigot](https://img.shields.io/badge/Spigot-Compatible-orange.svg)](https://www.spigotmc.org/)\n[![Paper](https://img.shields.io/badge/Paper-Compatible-blue.svg)](https://papermc.io/)\n[![Java](https://img.shields.io/badge/Java-17+-red.svg)](https://www.oracle.com/java/)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n\n\u003e Plugin Minecraft complet et immersif pour jouer au célèbre jeu du Loup-Garou directement sur votre serveur ! 🎮\n\n## 📖 Description\n\n**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.\n\n## ✨ Fonctionnalités principales\n\n### 🎭 Rôles disponibles\n- **🐺 Loup-Garou** : Éliminez les villageois chaque nuit\n- **👨‍🌾 Villageois** : Trouvez et éliminez les loups-garous par vote\n- **🔮 Voyante** : Découvrez le rôle d'un joueur chaque nuit\n- **🛡️ Garde** : Protégez un joueur des attaques nocturnes\n- **🧪 Sorcière** : Utilisez vos potions de vie et de mort (usage unique)\n\n### 🎮 Système de jeu complet\n- ✅ **Phases automatiques** : Nuit → Jour → Vote → Répéter\n- ✅ **Durées configurables** pour chaque phase\n- ✅ **Conditions de victoire** automatiques\n- ✅ **Chat spécialisé** pour les morts et les loups-garous\n- ✅ **Scoreboard dynamique** avec affichage du rôle personnel\n- ✅ **Effets sonores** immersifs selon les phases\n- ✅ **Système de vote** intégré avec comptage automatique\n\n### 🌍 Intégration WorldGuard\n- ✅ **Zone de jeu dédiée** : Restreint le jeu à une région WorldGuard spécifique\n- ✅ **Monde configurable** : Choisissez le monde de jeu\n- ✅ **Spawn personnalisé** : Définissez le point de spawn avec `/lg setspawn`\n- ✅ **Compatible sans WorldGuard** : Fonctionne aussi sans restriction de zone\n\n### 📊 Fonctionnalités avancées\n- ✅ **Statistiques persistantes** : Parties jouées, victoires, morts\n- ✅ **Configuration complète** : Durées, ratios de rôles, messages personnalisables\n- ✅ **Compatible LuckPerms** : Ne modifie pas les préfixes de chat hors partie\n- ✅ **Multi-monde** : N'affecte que les joueurs participant à la partie\n- ✅ **Système de permissions** : Gestion fine des accès\n- ✅ **Commande reload** : Rechargez la config sans redémarrer le serveur\n\n## 🚀 Installation\n\n### Prérequis\n- **Minecraft** 1.21 à 1.21.11 (Spigot/Paper)\n- **Java** 17 ou supérieur\n- **WorldGuard** 7.0+ (optionnel)\n\n### Étapes d'installation\n\n1. **Téléchargez** le fichier `LoupGarou-1.0.0.jar` depuis les [releases](../../releases)\n\n2. **Placez** le fichier dans le dossier `plugins/` de votre serveur\n\n3. **Redémarrez** votre serveur\n\n4. **Configurez** (optionnel) le fichier `plugins/LoupGarou/config.yml`\n\n5. **Créez une région WorldGuard** (optionnel) :\n   ```\n   /rg define loupgarou\n   ```\n\n6. **Définissez le spawn** :\n   ```\n   /lg setspawn\n   ```\n\n7. **Lancez une partie** :\n   ```\n   /lg start\n   ```\n\n## 🎯 Commandes\n\n### Commandes d'administration\n| Commande | Description | Permission |\n|----------|-------------|------------|\n| `/lg start` | Démarrer une partie | `loupgarou.admin` |\n| `/lg stop` | Arrêter la partie en cours | `loupgarou.admin` |\n| `/lg reload` | Recharger la configuration | `loupgarou.admin` |\n| `/lg setspawn` | Définir le spawn de jeu | `loupgarou.admin` |\n| `/lg statut` | Voir le statut de la partie | `loupgarou.use` |\n| `/lg liste` | Voir la liste des joueurs | `loupgarou.use` |\n\n### Commandes de jeu\n| Commande | Description | Permission |\n|----------|-------------|------------|\n| `/vote \u003cjoueur\u003e` | Voter pour éliminer un joueur | `loupgarou.vote` |\n| `/lg stats` | Voir ses statistiques | `loupgarou.use` |\n| `/lg aide` | Afficher l'aide | `loupgarou.use` |\n\n### Commandes par rôle\n| Commande | Rôle | Description |\n|----------|------|-------------|\n| `/lg tuer \u003cjoueur\u003e` | 🐺 Loup-Garou | Choisir une victime la nuit |\n| `/lg voir \u003cjoueur\u003e` | 🔮 Voyante | Découvrir le rôle d'un joueur |\n| `/lg proteger \u003cjoueur\u003e` | 🛡️ Garde | Protéger un joueur la nuit |\n| `/lg soigner \u003cjoueur\u003e` | 🧪 Sorcière | Ressusciter un joueur |\n| `/lg empoisonner \u003cjoueur\u003e` | 🧪 Sorcière | Tuer un joueur |\n\n## ⚙️ Configuration\n\nLe fichier `config.yml` est automatiquement créé au premier démarrage :\n\n```yaml\n# Configuration du jeu\ngame:\n  min-players: 4          # Nombre minimum de joueurs\n  max-players: 20         # Nombre maximum de joueurs\n  night-duration: 60      # Durée de la nuit (secondes)\n  day-duration: 120       # Durée du jour (secondes)\n  vote-duration: 60       # Durée du vote (secondes)\n  auto-restart: true      # Redémarrage automatique\n  restart-delay: 30       # Délai avant redémarrage (secondes)\n\n# Configuration du spawn\nspawn:\n  world: \"minijeux\"       # Monde de jeu\n  x: 0.5                  # Coordonnée X\n  y: 100.0                # Coordonnée Y\n  z: 0.5                  # Coordonnée Z\n  yaw: 0.0                # Rotation horizontale\n  pitch: 0.0              # Rotation verticale\n\n# Intégration WorldGuard\nworldguard:\n  enabled: true                  # Activer WorldGuard\n  region-name: \"loupgarou\"       # Nom de la région\n  world-name: \"minijeux\"         # Monde de la région\n  check-on-join: true            # Vérifier à la connexion\n\n# Configuration des rôles\nroles:\n  werewolf:\n    ratio: 0.25                  # 1 loup pour 4 joueurs\n  seer:\n    min-players: 6               # Minimum pour la voyante\n  guard:\n    min-players: 8               # Minimum pour le garde\n  witch:\n    min-players: 10              # Minimum pour la sorcière\n\n# Scoreboard\nscoreboard:\n  enabled: true                  # Activer le scoreboard\n  only-in-region: true           # Afficher seulement dans la région\n  update-interval: 20            # Intervalle de mise à jour (ticks)\n```\n\n## 🎨 Captures d'écran\n\n### Scoreboard avec rôle personnel\n```\n╔════════════════╗\n║ 🐺 LOUP-GAROU  ║\n║                ║\n║ 🎭 Votre rôle: ║\n║ 🔮 Voyante     ║\n║                ║\n║ 📊 État: Nuit  ║\n║ 🌅 Jour: 3     ║\n║                ║\n║ 🐺 Loups: 2    ║\n║ 👥 Village: 5  ║\n║                ║\n║ ✅ Vivant      ║\n╚════════════════╝\n```\n\n### Messages de chat\n```\n[Nuit] 👤 Joueur1 » Qui est suspect ?\n[Loups] 🐺 LoupGarou1 » On tue Joueur2 !\n[Morts] 💀 Joueur3 » Ah je savais !\n```\n\n## 🔧 Compilation\n\n### Avec Maven\n```bash\ngit clone https://github.com/Gh0st-cmd/Plugin-LoupGarou.git\ncd Plugin-LoupGarou\nmvn clean package\n```\n\nLe fichier `.jar` sera généré dans `target/LoupGarou-1.0.0.jar`\n\n### Avec Gradle\n```bash\ngit clone https://github.com/Gh0st-cmd/Plugin-LoupGarou.git\ncd Plugin-LoupGarou\ngradle build\n```\n\nLe fichier `.jar` sera généré dans `build/libs/LoupGarou-1.0.0.jar`\n\n## 📋 Permissions\n\n| Permission | Description | Défaut |\n|------------|-------------|--------|\n| `loupgarou.admin` | Accès aux commandes d'administration | OP |\n| `loupgarou.use` | Utiliser les commandes de base | Tous |\n| `loupgarou.vote` | Pouvoir voter | Tous |\n| `loupgarou.bypass` | Contourner les restrictions en jeu | OP |\n\n## 🤝 Contribution\n\nLes contributions sont les bienvenues ! N'hésitez pas à :\n\n1. 🍴 **Fork** le projet\n2. 🔨 **Créer** une branche (`git checkout -b feature/amélioration`)\n3. 💾 **Commit** vos changements (`git commit -m 'Ajout d'une fonctionnalité'`)\n4. 📤 **Push** vers la branche (`git push origin feature/amélioration`)\n5. 🎉 **Ouvrir** une Pull Request\n\n## 📝 Roadmap\n\n- [ ] Ajout de nouveaux rôles (Cupidon, Chasseur, Ancien, etc.)\n- [ ] Système de parties classées\n- [ ] Intégration Discord pour notifications\n- [ ] Support multi-langues\n- [ ] Interface graphique (GUI)\n- [ ] Mode spectateur amélioré\n- [ ] Enregistrement et replay des parties\n\n## 🐛 Rapporter un bug\n\nSi vous trouvez un bug, merci de créer une [issue](../../issues) avec :\n- 📝 Description détaillée du problème\n- 🔄 Étapes pour reproduire\n- 📸 Captures d'écran si possible\n- 📊 Version du plugin, de Minecraft et du serveur\n- 📄 Logs d'erreur\n\n## 💬 Support\n\n- 📖 **Wiki** : [Lien vers le wiki](../../wiki)\n- 💬 **Discord** : [Rejoindre le serveur Discord](https://discord.gg/DGeGB5cmxQ)\n\n## 📜 Licence\n\nCe projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.\n\n## 👏 Remerciements\n\n- Merci à la communauté Spigot/Paper pour leurs ressources\n- Inspiré du jeu de société Loup-Garou de Thiercelieux\n- Merci à tous les contributeurs et testeurs\n\n## 📊 Statistiques\n\n![GitHub stars](https://img.shields.io/github/stars/Gh0st-cmd/Plugin-LoupGarou?style=social)\n![GitHub forks](https://img.shields.io/github/forks/Gh0st-cmd/Plugin-LoupGarou?style=social)\n![GitHub issues](https://img.shields.io/github/issues/Gh0st-cmd/Plugin-LoupGarou)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/Gh0st-cmd/Plugin-LoupGarou)\n![Build Status](https://github.com/Gh0st-cmd/Plugin-LoupGarou/actions/workflows/gradle-publish.yml/badge.svg)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Développé avec ❤️ pour la communauté Minecraft francophone 🇫🇷\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🐺 Bon jeu et que le meilleur gagne ! 🎮\u003c/strong\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh0st-cmd%2Fplugin-loupgarou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgh0st-cmd%2Fplugin-loupgarou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgh0st-cmd%2Fplugin-loupgarou/lists"}