📕 DiscDex - Cobblemon Discord Integration

DiscDex is a high-performance NeoForge Minecraft mod that seamlessly bridges your server's Cobblemon progression with a dedicated Discord Bot! Give your players the ultimate way to track, sort, and flex their Pokémon catch statistics and PokéDex achievements directly within Discord.

🚀 Key Features

📊 Discord Slash Commands

- /stats [user]: Displays a beautiful, real-time stats embed containing the player's Minecraft account name, PokéDex completion percentage, and a visual progress bar. Check your own stats or spy on your rivals!

- /pokedex [user]: Lists all caught Pokémon species in a neatly formatted, PokéDex-sorted list, complete with 3-digit National PokéDex numbers (e.g., #001 Bulbasaur, #025 Pikachu).

🔗 Hassle-Free Player Account Linking

- Players can securely link their Minecraft characters with their Discord accounts in under 30 seconds:

1. Run /discdex link in Minecraft to generate a secure, 10-minute temporary code.

2. Type /link <code> in Discord to complete the link.

⚙️ Server-Admin Commands (In-Game)

- /discdex token <token>: Configure and update your Discord bot's API token on the fly without restarting the server!

- /discdex combinevariants <true/false>: Choose whether to combine visual Pokémon variants or count them individually in PokéDex completion.

- /discdex reload: Instantly reloads the bot configuration, player catch records, and account links.

✨ Generations Config Support

- Automatic Integration: DiscDex automatically reads your server's Generations config (config/generations/config.json), and displays a total in relation to the Generations you have selected. ( https://www.curseforge.com/minecraft/mc-mods/cobblemon-generations for this mod's download ) If a starter is selected from a different generation, or a Cobblemon is caught from another generation for any reason, the max Pokemon go up by one to account for it for that player.

- Dynamic Filtering: Any disabled generations are instantly excluded from player /stats and /pokedex progress. Players won't get penalized or see "missing" entries for generations that aren't obtainable on your server!

🔒 Built for Performance & Safety (No Lag!)

DiscDex is built from the ground up to run smoothly on any server, no matter how busy:

- Zero Server Lag: Saving stats, checking catches, and handling Discord commands are done in the background. Your game stays smooth with absolutely zero TPS drops.

- Always Online Bot: The Discord bot handles command requests instantly and stays reliably connected without disconnecting or timing out.

- Corrupt-Proof Saving: Uses super safe saving methods so your linked accounts and PokéDex data will never be corrupted or lost, even if the server suddenly crashes. The bot will just restart once the server loads back up!

- Super Fast Queries: Player stats and PokéDex queries load instantly without putting any strain on your server's CPU.

🛠️ Quick Installation & Setup

1. Drop the discdex jar file into your server's mods folder along with Cobblemon (NeoForge).

2. Go to the Discord Developer Portal and create a New Application.

3. Under the Bot tab:

- Enable Presence Intent and Server Members Intent under Privileged Gateway Intents.

- Click Reset Token and copy your Bot API Token.

4. Invite the Bot to your Discord server.

5. Log into your Minecraft server as an OP and run:

/discdex token <your_copied_bot_token>

6. The bot will automatically boot up, register its slash commands globally, and automatically clear out any old/stale guild commands on startup!

Please Note: It is HIGHLY advised when making the Discord bot profile in the developer settings to limit the bot without an invite. Planned side mods for this project somewhat rely on this to function, and it is easier to keep track of misuse of this bot inside your own Discord than someone elses.

[Cobblemon] DiscDex