Project Cobblebrain

AI powers dynamic and emergent Pokémon dialogue, but all gameplay actions, built-in dialogue, quests, and the Story Creator can be enjoyed offline!

Discord: join the official Cobblemon server, check mods-and-plugins → CobbleBrain.
Report Bugs and Submit Suggestions here!

Note: If you notice the Pokémon not forming memories/personalities as much in previous versions, check the first question in the FAQ.

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.

With the built-in Visual Story Creator, players can make custom interactive quests, branching RPG campaigns, minigames and more!

You can also fully customize each Pokémon's personality through the built-in Personality Editor, allowing every companion to develop a unique identity.

Features

• Pokémon can talk to the player and to each other autonomously.
• Speech-to-Text (Voice Input): Talk and give commands to Pokémon directly using your microphone (requires MCMti).
• Pokémon can perform actions such as attacking, building, excavating, cooking, repairing tools, growing plants, and more.
• Per-Action Customization: Toggle each action individually and customize cooldowns to balance gameplay.
• 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), local models via LM Studio and Player2 and offline gameplay.
• Multiplayer compatible, with each player managing their own AI processing.
• Pokémon Personality Editor for customizing Traits, Quirks, Likes, Dislikes, and other personality attributes.

How to Play

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"`

Visual Story Creator (Alpha)

The Story creator is an in-game editor with visual scripting (blocks) to build campaigns, quests and minigames integrated with Cobblemon.

The goal is to let any player create Pokémon stories/fan-games in a simple, familiar environment. The system also supports emergent AI narratives to generate dynamic lines and progression while keeping full script and direction control in your hands (AI usage is completely OPTIONAL, the editor works perfectly fine without AI features).

Access the editor in-game on the mod menu.

You can easily export your Project in-menu, just click in File, export ZIP, select the location you want to export and done, your Project will be zipped and ready to publish! For others to play your story, they would just have to take your project, put it in the cobblebrain/storypacks folder, go to 'Play story' and done!

Karma System

Each Pokémon species tracks your behavior.

• Killing Pokémon or failing quests lowers karma.
• Helping Pokémon increases karma.

Karma influences how Pokémon react to you in future interactions.
To disable the karma system, go to the mod settings and turn off enable karma.

Raids

If your karma with a species becomes lower than -8, that species may organize a raid.
A raid spawns multiple Pokémon that will attempt to defeat the player.

Worse karma = stronger raids.
To disable raids, go to the mod settings and turn off schedule raids.

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)
• Gameplay Systems (Dialogue, Memories, Quests, Actions, etc.)
• Individual Action settings (enable/disable each action, custom cooldowns)
• AI prompts (instruct and other behavior settings)
• Wild Pokémon quest chances
• Raid settings
• Pokémon personalities (Personality Editor)

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

Use the action HUD to make all your Pokémon perform the chosen action or encourage Pokémon through chat to perform actions! Example: Squirtle, defend me! / Bulbasaur, want to eat some berries I dropped?

FAQ