📋 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

Find the Exchange NPC in your world (with its distinctive golden name)
Right-click the NPC to open the trading menu
Select a Level 50+ Pokémon from your party
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:

json

- 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

Download the .jar file
Place it in your mods/ folder
Start the server
Use /spawnechangenpc (permission level 2) to create the NPC
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

Trouvez le PNJ Échangeur dans votre monde (avec son nom doré distinctif)
Cliquez droit sur le PNJ pour ouvrir le menu d'échange
Sélectionnez un Pokémon niveau 50+ de votre équipe
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 :

json

- 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

Téléchargez le fichier .jar
Placez-le dans votre dossier mods/
Démarrez le serveur
Utilisez /spawnechangenpc (permission niveau 2) pour créer le PNJ
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 ! 🎮✨

Echange Pokemon Cobblemon