EggDropOpItems

EggDropOpItems

    > Un plugin Spigot qui récompense (ou punit) les joueurs qui lancent des œufs — avec un système de level progressif, des enchantements, des traductions et une interface de configuration in-game. --- ## Table des matières - [Fonctionnalités](#-fonctionnalités) - [Installation](#-installation) - [Forker le projet](#-forker-le-projet) - [Structure du projet](#-structure-du-projet) - [Commandes](#-commandes) - [Système de récompenses](#-système-de-récompenses) - [Système de level](#-système-de-level) - [Traductions](#-traductions) - [Configuration in-game](#-configuration-in-game) --- ## Fonctionnalités - Rewards aléatoires — Chaque œuf lancé déclenche un reward ou un malus tiré selon un système de poids - Système de level — Plus tu lances d'œufs, plus les rewards s'améliorent et les malus diminuent - Config in-game — Interface d'inventaire pour activer/désactiver chaque reward individuellement - Multi-langues — Français, Anglais, Espagnol et Allemand - Enchantements — Les outils et armures peuvent recevoir des enchantements selon ton niveau - Probabilités affichées — Chaque reward affiche sa probabilité dans le chat --- ## Installation 1. Télécharge le fichier EggDropOpItems-1.0.jar depuis les [Releases](../../releases) 2. Place le fichier dans le dossier plugins/ de ton serveur Spigot 3. Redémarre le serveur 4. Utilise /eenable en jeu pour activer le plugin (permission `edoi.admin` requise) > Requiert Spigot 1.21.1 et Java 21 minimum. --- ## Forker le projet ### Prérequis - Java 21+ - Maven 3.8+ - Git ### Étapes 1. Forke et clone le repo

 git clone 
https://github.com/TON_PSEUDO/EggDropOpItems.git

 cd EggDropOpItems

 

2. Compile avec Maven

 mvn clean install

 

3. Génère le jar

 mvn clean package

 

Le jar se trouve dans target/EggDropOpItems-1.0.jar. 4. Ouvre dans ton IDE Importe le pom.xml dans IntelliJ IDEA ou Eclipse. > Pour modifier les rewards, les probabilités ou les traductions, consulte la section Structure du projet ci-dessous. --- ## Structure du projet

 src/main/java/fr/niavlys/dev/edoi/

 │

 ├── Main.java # Point d'entrée du plugin

 ├── Utils.java # Utilitaires (formatage, etc.)

 ├── PlayerLevelManager.java # Gestion des niveaux par joueur

 │

 ├── rewards/ # Tous les rewards

 │ ├── Rewardable.java # Interface commune

 │ ├── RewardType.java # Types et poids globaux

 │ ├── MalusMobs.java # Spawn de mobs hostiles

 │ ├── MalusEffects.java # Effets négatifs

 │ ├── BonusTool.java # Outils bonus

 │ ├── BonusArmor.java # Armures bonus

 │ ├── BonusItem.java # Items bonus

 │ ├── BonusEffects.java # Effets positifs

 │ └── BonusEnchant.java # Enchantements

 │

 ├── inventory/ # Interface de configuration

 │ ├── ConfigInventory.java # Affichage des inventaires

 │ ├── ConfigListener.java # Gestion des clics

 │ └── ConfigManager.java # État actif/inactif

 │

 ├── lang/ # Système de traductions

 │ ├── Lang.java # Enum des langues

 │ ├── LangManager.java # Langue par joueur

 │ ├── Messages.java # Clés de traduction

 │ └── Translations.java # Toutes les traductions

 │

 ├── commands/ # Commandes

 │ ├── StartCommand.java

 │ ├── HelpCommand.java

 │ ├── EnableDisableCommand.java

 │ └── LangCommand.java

 │

 └── events/

 └── EggThrowEvent.java # Listener principal

 

 src/main/resources/

 └── plugin.yml

 

--- ## Commandes | Commande | Description | Permission | |---|---|---| | /ehelp | Affiche l'aide | — | | /elang <fr\|en\|es\|de> | Change ta langue | — | | /eenable | Active le plugin | edoi.admin | | /edisable | Désactive le plugin | edoi.admin | | /estart | Démarre une partie | edoi.admin | | /econfig | Ouvre la configuration | edoi.admin | --- ## Système de récompenses Chaque œuf lancé déclenche un type de reward tiré aléatoirement selon des poids. ### Types de rewards | Type | Catégorie | Description | |---|---|---| | ️ Bonus Tools | Bonus | Outils en bois, pierre, fer, diamant, netherite | | ️ Bonus Armor | Bonus | Armures de tous matériaux | | Bonus Items | Bonus | Items utiles (ender pearl, blaze rod, diamants...) | | Bonus Effects | Bonus | Effets positifs (vitesse, résistance, régénération...) | | Malus Mobs | Malus | Spawn de mobs hostiles sur le joueur | | Malus Effects | Malus | Effets négatifs (poison, lenteur, cécité...) | ### Ajouter un reward 1. Crée un enum qui implémente Rewardable 2. Implémente doReward(PlayerEggThrowEvent e, Player p, int level) 3. Ajoute une entrée dans RewardType avec un poids

 BONUS_FOOD(15) {

 
@Override

 public Rewardable getRandom() { return BonusFood.getRandom(); }

 
@Override

 public int getWeight(int level) { return Math.min(20, 15 + level); }

 },

 

--- ## Système de level Le niveau augmente avec le nombre d'œufs lancés : | Niveau | Œufs requis | |---|---| | 1 | 0 | | 2 | 10 | | 3 | 25 | | 4 | 50 | | 5 | 100 | | 6 (MAX) | 200 | ### Impact du level | Mécanique | Niveau 1 | Niveau 6 | |---|---|---| | Nb enchantements | 0 - 1 | 2 - 3 | | Niveau enchant max | 1 | 5 | | Durée effets malus | 5 - 15s | 5s max | | Nb mobs max | 10 | 1 | | Tier outils/armures | Bois/Pierre | Diamant/Netherite | --- ## Traductions Chaque joueur choisit sa langue avec /elang : | Code | Langue | |---|---| | fr | Français | | en | English | | es | Español | | de | Deutsch | Pour ajouter une langue, édite Translations.java :

 // Ajoute une entrée dans l'enum Lang.java

 IT("Italiano", "it"),

 

 // Puis ajoute toutes les clés dans Translations.java

 Map<Messages, String> it = new EnumMap<>(Messages.class);

 it.put(Messages.GAME_ENABLED, ChatColor.GREEN + "✔ Gioco attivato!");

 // ...

 translations.put(Lang.IT, it);

 

--- ## Configuration in-game Lance /econfig pour ouvrir l'interface graphique. Tu peux : - Activer / désactiver chaque type de reward (Malus Mobs, Bonus Items, etc.) - Activer / désactiver chaque reward individuel - Voir la probabilité de chaque reward > La configuration est en mémoire uniquement et se remet à zéro au redémarrage. Pour la persister, il faudra implémenter une sauvegarde dans un fichier config.yml. --- ## Licence Ce projet est sous licence MIT — libre à toi de le modifier et redistribuer. --- *Made with by [Niavlys]( https://github.com/NiavlySDev)*