
CobbleBrain - AI Dialogue System for Cobblemon
CobbleBrain is a mod that gives Pokémon a "brain," allowing them to think, talk, and interact with their surroundings in dynamic ways. Easy to setup and play!
Screenshots


About this Mod
CobbleBrain – AI Dialogue System for Cobblemon
Discord: join the official Cobblemon server, check mods-and-plugins → CobbleBrain.
⚠️Disable the Catch indicator mod (present in Cobbleverse) when playing with cobblebrain.
⚠️Known bug: If you're playing on a server, disable "Talk in Battle". To do this, open cobblebrain.json5 in the server's config folder and set the "talkInBattle" option to false.
About
CobbleBrain is a mod that gives Pokémon a “brain,” allowing them to think, talk, and interact dynamically with the world. It integrates artificial intelligence into gameplay, making your companions talk to you, react to battles, protect you from mobs and even cook a delicious steak, all of that using your prompt.
Wild Pokémon can also interact with the player and the world, creating quests, remembering your actions, and reacting to how you treat their species.
Features
- Pokémon can talk to the player and to each other.
- Pokémon can perform actions such as attacking, eating, cooking, repairing tools, growing plants, and more.
- Dialogue influenced by friendship, nature, past interactions, and world conditions.
- Memory system that stores previous interactions.
- Wild Pokémon quests and karma system that react to your actions.
- Raid events triggered when Pokémon species become hostile toward you.
- Fully configurable AI prompts, gameplay settings, and behaviors through the Mod Menu configuration screen.
- Supports cloud AI models (Google AI Studio, OpenAI, OpenRouter, Player2) and local models via LM Studio and Player2.
- Multiplayer compatible, with each player managing their own AI processing.
How to Play
1. Choosing AI Mode
Cloud Mode (Easiest)
Cloud mode uses external AI providers to process dialogue.
Using Player2
- Install the Player2 app and create an account.
- Run Player2.exe (the app)
Player2 includes a free amount of energy, which can be replenished daily using a spinner. You can also choose the AI model that best fits your needs. In general, more expensive models are smarter.
Here's a Tutorial on YouTube!
Using Other Providers
Create an account with a provider (examples: Google AI Studio, OpenAI, OpenRouter).
Generate an API key from the provider’s dashboard.
Choose a model (examples:
gemma-3-12b-it,gpt-4.1-mini,anthropic/claude-3.5-sonnet).Open the mod config Menu and fill:
apiKey: your generated keyapiBaseUrl: provider’s official URLaiModel: ID of the chosen model
Here's a Tutorial on YouTube!
Local Mode
Local mode runs AI models directly on your computer using LM Studio or Player2.
WARNING: LOCAL MODELS MAY CAUSE PROBLEMS IF YOU RUN/INSTALL MODELS THAT ARE TOO HEAVY.
**Steps:**
1. Install [LM Studio](https://lmstudio.ai) (available for Windows, Mac, Linux).
2. Open LM Studio and set up a folder for storing models.
3. Download a model (examples: LLaMA, Mistral).
- 4b–5b models → lightweight, fast, good for simple dialogues.
- 7b–8b models → balanced, deeper responses.
- 12b+ models → complex, detailed dialogues, requiring significant RAM and GPU.
4. Prefer quantized versions (q4, q5, q8) to reduce resource usage.
5. Start the LM Studio server; it will show a local API address (e.g., `http://localhost:port`).
6. Open the **Config menu** and set:
- `apiBaseUrl`: local server address (Example: `http://localhost:1234`)
- `aiModel`: ID or name of the model running in the server
- `localApiProvider`: `"lmstudio"`
2. Interacting with Pokémon
- Use the command
/mpk <message>to talk to your Pokémon. - If
listenToChat = true, any chat message can be interpreted by the AI.
3. Performance Adjustments
- Use
lowTokenModefor faster and lighter responses. - Adjust
maxShortMemoryandmaxLongMemoryto control how much dialogue memory Pokémon retain.
Usage Recommendations
- Low-end PC / simple laptop → Cloud AI.
- Powerful laptop with dedicated GPU → Cloud AI or lightweight local models (4b–7b).
- Moderate–high-end PC → Cloud AI or robust local models (8b–12b).
- For local models, always prefer quantized versions (q4, q5, q8) to reduce RAM/GPU usage.
Configuration
CobbleBrain can be configured directly in-game through the mod config menu screen. You can open it by pressing Y or typing /cobblebrain openConfig in chat.
There you can customize:
- AI provider settings (
apiKey,apiBaseUrl,aiModel) - AI prompts (
instructand other behavior settings) - Dialogue behavior
- Wild Pokémon quest chances
- Raid settings
- Pokémon characteristics and personalities
Advanced users can still edit the generated configuration files in the /config folder if needed.
For the full list of variables and explanations, please check the
CobbleBrain README on GitHub.
Pokémon Actions
Encourage Pokémon through chat to perform actions.
Example: Squirtle, defend me! / Bulbasaur, want to eat some berries I dropped?
Primary Type-based Actions
These actions only work when the Pokémon has the right primary type.
Example: Charizard (fire, flying) can use cook, but Chandelure (ghost, fire) cannot.
Cook (Fire)
Can cook food and smelt ores. 5% chance of item turning into charcoal.Grow (Plant)
Grows tree saplings and crops.Repair (Metal)
Repairs tools and weapons up to a certain durability threshold.Shift (Ghost)
Transports the player to an alternate dimension. Player becomes invisible, gains increased speed and jump height, but suffers from high weakness.General Actions
These actions work with any pokemon!
Attack
Pokémon attacks any mobs close to it.Protect
Pokémon targets hostile mobs nearest to the player; if none are found, it follows the player.Eat
Pokémon eat any edible item dropped on the ground. Some foods and berries may grant temporary effects.Buff
Pokémon grants the player a positive status effect based on its primary type (e.g., regeneration, speed).Debuff
Pokémon applies a negative status effect to nearby mobs based on its primary type (e.g., slowness, weakness).Sit
Pokémon stays fixed in place, ignoring other actions.Idle
Pokémon cancels all active commands and returns to normal behavior.FAQ
Can I play with a free model?
Yes, many providers offer free models, but with usage limits. I recommend using models from Player2 (Default in the mod). Test them to find the one that has the better cost/intelligence ratio for your gameplay.My pokemon is not performing actions!
Check in latest.log if prints like "Pokemon action detected" appear, if it appears, check if there is any mod that could interfere with the names/tags of the cobblemons, like the *Catch Indicator* mod and then disable them.Pokémon responses are too slow. Why?
It depends on: 1. Model size (larger models are slower). 2. Prompt length. 3. Internet connection quality. 4. Provider traffic load.How can I speed up Pokémon responses?
1. Shorten the instruct. 2. Enable `lowTokenMode`. 3. Use smaller/quantized models. 4. Disable some gameplay systems in the Output Systems section of the config menu. All these settings are in cobblebrain.json5 inside the config folder.I have issues with my key or provider. What should I do?
CobbleBrain only bridges the game and the provider. If problems related to the provider occurs, contact the provider’s support directly.I found a bug / have a suggestion / have a question.
Join the official Cobblemon discord server, check content-zone-help then search CobbleBrain.Does the mod collect personal data?
No. The mod only forwards the player’s prompt to the chosen AI provider and returns the response. Local logs are generated only if `debugLogging = true`.Can I use local models?
Yes, via LM Studio. But be careful: large models may cause crashes or require strong hardware.I want to revert my cobblebrain.json to default. What should I do?
Delete or rename your current `cobblebrain.json5` file inside the config folder. When you restart the game, the mod will automatically generate a new config file with the default values.Available Versions
How to Install CobbleBrain - AI Dialogue System for Cobblemon on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "CobbleBrain - AI Dialogue System for Cobblemon". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CobbleBrain - AI Dialogue System for Cobblemon server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is CobbleBrain - AI Dialogue System for Cobblemon compatible with fabric and neoforge?
CobbleBrain - AI Dialogue System for Cobblemon officially supports fabric, neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CobbleBrain - AI Dialogue System for Cobblemon – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CobbleBrain - AI Dialogue System for Cobblemon consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install CobbleBrain - AI Dialogue System for Cobblemon with just one click on your server.