📋 Mod Description

What does this mod add?

Pokémon Exchange NPC adds a unique and engaging trading system to your Cobblemon server. An interactive NPC appears in your world offering a high-risk trading mechanic: sacrifice a Level 50+ Pokémon to receive a completely random Level 1 Pokémon with optimized IVs.

🎮 Gameplay Experience

For Players

• Smart recycling system: Transform your high-level Pokémon into opportunities to start fresh with new rare species
• Risk/reward mechanics: Every trade is a gamble – you might get your favorite starter or a common Pokémon
• Fair cooldown: One trade every 24 hours ensures the system stays balanced and exciting
• Guaranteed IVs: All received Pokémon have IVs between 20-31, with a 5% chance of getting perfect IVs (31 across the board)
• Intuitive interface: Simple clickable chat menu to select which Pokémon to trade

For Server Administrators

• Complete configuration: Config file to adjust cooldown, min/max IVs, perfect IV probability, rarity weights
• Species control: Exclude legendaries, mythicals, and Ultra Beasts from the trade pool
• Admin logs: Track all trades performed for moderation purposes
• Simple installation: One /spawnechangenpc command to create the NPC, no complex setup required

✨ Key Features

Trading System

1. Find the Exchange NPC in your world (with its distinctive golden name)
2. Right-click the NPC to open the trading menu
3. Select a Level 50+ Pokémon from your party
4. Receive instantly a random Level 1 Pokémon

Quality Guarantees

• Optimized IVs: Individual stats between 20-31 guaranteed
• Perfection chance: 5% probability of getting a Pokémon with perfect 31 IVs across all stats
• Weighted distribution: Common Pokémon are more frequent, rare ones more exciting to obtain
• Anti-spam protection: 24-hour cooldown per player

Server Configuration

Fully customizable config.json file:

- cooldown_hours: 24 (adjustable)
- min_ivs: 20 (guaranteed minimum)
- max_ivs: 31 (maximum possible)
- perfect_iv_chance: 0.05 (5%)
- allow_legendaries/mythicals/ultra_beasts: false
- rarity_weights: Distribution COMMON(60%), UNCOMMON(25%), RARE(10%), EPIC(4%), LEGENDARY(1%)

🎯 Use Cases

Alternative Progression

• Offers advanced players a way to restart with new Pokémon
• Encourages team diversity rather than keeping the same meta Pokémon
• Creates memorable moments when a player gets their favorite starter

Server Economy

• Can be used as a sink to remove powerful Pokémon from the economy
• Integrable into custom quests (e.g., "Trade 5 Level 50+ Pokémon")
• Compatible with other economy mods

Community Engagement

• Generates streamable content (lucky/unlucky moments)
• Encourages discussions ("I traded my 100 IV Garchomp and got...")
• Creates regular activity thanks to the daily cooldown

⚙️ Technical Information

• Minecraft Version: 1.21.1
• Loader: Fabric
• Dependencies: Cobblemon 1.7.1+
• Side: Server-only (not required on client)
• Performance: Minimal impact (cooldowns stored in file, no constant ticking)

🚀 Installation

1. Download the .jar file
2. Place it in your mods/ folder
3. Start the server
4. Use /spawnechangenpc (permission level 2) to create the NPC
5. The config.json file will be automatically generated in config/echangepokemon/

⚠️ Important

• All trades are final – no refunds possible
• The Level 50+ Pokémon you give is permanently lost
• Legendaries/mythicals/Ultra Beasts cannot be received (by default)
• The cooldown applies per player, not per Pokémon

💡 Server Integration Ideas

• Special events: Temporarily reduce cooldown to 1 hour during a weekend
• Daily quests: Reward players who use the system
• Leaderboards: Track who got the most perfect IVs
• Themed areas: Place the NPC in a "Hall of Fate" with appropriate decorations

This description gives players a complete vision of what to expect while providing administrators with the technical information needed to effectively integrate the mod on their server! 🎮✨


Francais :

📋 Description du Mod

Qu'est-ce que ce mod apporte ?

Pokémon Exchange NPC ajoute un système d'échange unique et captivant à votre serveur Cobblemon. Un PNJ interactif apparaît dans votre monde et propose un mécanisme de trading à haut risque : sacrifiez un Pokémon niveau 50+ pour recevoir un Pokémon complètement aléatoire niveau 1 avec des IVs optimisés.

🎮 Expérience de jeu offerte

Pour les joueurs

• Système de recyclage intelligent : Transformez vos Pokémon de haut niveau en opportunités de recommencer avec de nouvelles espèces rares
• Mécanique risk/reward : Chaque échange est un pari – vous pourriez obtenir votre starter préféré ou un Pokémon commun
• Cooldown équitable : Un échange toutes les 24 heures garantit que le système reste équilibré et excitant
• IVs garantis : Tous les Pokémon reçus ont des IVs entre 20-31, avec 5% de chance d'obtenir des IVs parfaits (31 partout)
• Interface intuitive : Menu cliquable simple dans le chat pour sélectionner le Pokémon à échanger

Pour les administrateurs de serveur

• Configuration complète : Fichier config pour ajuster le cooldown, les IVs min/max, la probabilité d'IVs parfaits, les poids de rareté
• Contrôle des espèces : Excluez les légendaires, mythiques et Ultra-Chimères du pool d'échange
• Logs administrateurs : Suivez tous les échanges effectués pour modération
• Installation simple : Une commande /spawnechangenpc pour créer le PNJ, aucune configuration complexe

✨ Fonctionnalités principales

Système d'échange

1. Trouvez le PNJ Échangeur dans votre monde (avec son nom doré distinctif)
2. Cliquez droit sur le PNJ pour ouvrir le menu d'échange
3. Sélectionnez un Pokémon niveau 50+ de votre équipe
4. Recevez instantanément un Pokémon aléatoire niveau 1

Garanties de qualité

• IVs optimisés : Statistiques individuelles entre 20-31 garanties
• Chance de perfection : 5% de probabilité d'obtenir un Pokémon avec IVs 31 partout
• Distribution pondérée : Les Pokémon communs sont plus fréquents, les rares plus excitants à obtenir
• Protection anti-spam : Cooldown de 24 heures par joueur

Configuration serveur

Fichier config.json entièrement personnalisable :

- cooldown_hours: 24 (modifiable)
- min_ivs: 20 (minimum garanti)
- max_ivs: 31 (maximum possible)
- perfect_iv_chance: 0.05 (5%)
- allow_legendaries/mythicals/ultra_beasts: false
- rarity_weights: Distribution COMMON(60%), UNCOMMON(25%), RARE(10%), EPIC(4%), LEGENDARY(1%)

🎯 Cas d'utilisation

Progression alternative

• Offre aux joueurs avancés une façon de redémarrer avec de nouveaux Pokémon
• Encourage la diversité d'équipe plutôt que de garder les mêmes Pokémon meta
• Crée des moments mémorables quand un joueur obtient son starter préféré

Économie serveur

• Peut être utilisé comme sink pour retirer des Pokémon puissants de l'économie
• Intégrable dans des quêtes personnalisées (ex: "Échange 5 Pokémon niveau 50+")
• Compatible avec d'autres mods économiques

Engagement communautaire

• Génère du contenu streamable (moments de chance/malchance)
• Encourage les discussions ("J'ai échangé mon Garchomp 100 IV et j'ai eu...")
• Crée une activité régulière grâce au cooldown quotidien

⚙️ Informations techniques

• Version Minecraft : 1.21.1
• Loader : Fabric
• Dépendances : Cobblemon 1.7.1+
• Côté : Serveur uniquement (pas besoin sur client)
• Performance : Impact minimal (cooldowns stockés en fichier, pas de tick constant)

🚀 Installation

1. Téléchargez le fichier .jar
2. Placez-le dans votre dossier mods/
3. Démarrez le serveur
4. Utilisez /spawnechangenpc (permission niveau 2) pour créer le PNJ
5. Le fichier config.json sera généré automatiquement dans config/echangepokemon/

⚠️ Important

• Tous les échanges sont définitifs – aucun remboursement possible
• Le Pokémon niveau 50+ que vous donnez est perdu définitivement
• Les légendaires/mythiques/Ultra-Chimères ne peuvent pas être reçus (par défaut)
• Le cooldown s'applique par joueur, pas par Pokémon

💡 Idées d'intégration serveur

• Événements spéciaux : Réduisez temporairement le cooldown à 1h pendant un weekend
• Quêtes quotidiennes : Récompensez les joueurs qui utilisent le système
• Classements : Trackez qui a obtenu le plus d'IVs parfaits
• Zones thématiques : Placez le PNJ dans une "salle du destin" avec décoration appropriée

Cette description donne aux joueurs une vision complète de ce qu'ils peuvent attendre tout en fournissant aux administrateurs les informations techniques nécessaires pour intégrer le mod efficacement sur leur serveur ! 🎮✨