CobbleBrain - AI Dialogue System for Cobblemon

ByVICdev
Mods

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!

Description

Note: This is the recommended method to set up the mod. If you prefer other options, see the How to Play section below.

Cobblebrain - AI dialogue System for Cobblemon

⚠️Disable the Catch indicator mod (present in Cobbleverse) when playing with cobblebrain.

Discord: join the official Cobblemon server, check mods-and-plugins → CobbleBrain.

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 using your prompt.

Wild Pokémon are also capable of interacting with the player and the world, creating quests, remembering your actions, and even organizing raids if you become their enemy.

Features

Pokémon can talk to the player and to each other using AI.
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.
Wild Pokémon quests and karma system that react to your actions.
Raid events triggered when Pokémon species become hostile toward you.
Fully customizable AI prompts, behaviors, and gameplay settings 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.

Wild Pokémon Systems

Wild Pokémon are no longer passive. They can interact with the player and react to how you treat their species.

Quests

Wild Pokémon may approach you and start small quests, such as:

Item Requests – bring a specific item to the Pokémon.
Advice Requests – answer questions and influence your reputation.
Battle Requests – defeat a specific Pokémon in battle.

Completing quests may reward the player with items or gifts.

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.

Raids

If your karma with a species becomes extremely low, that species may organize a raid.

A raid spawns multiple Pokémon that will attempt to defeat the player.

Worse karma = stronger raids.

How to Play

You can choose to play using cloud models or local models.

A. Cloud Mode (Recommended)

Cloud mode uses external AI providers to process dialogue.

1. Player2 App

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 is a youtube tutorial!

2. Other Providers (Google AI Studio, OpenAI, OpenRouter, etc.)

Create an account with the provider.
Generate an API key.
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
- apiBaseUrl
- aiModel

Here is a youtube tutorial!

B. Local Mode

Local mode allows you to run models directly on your machine using LM Studio or Player2.

See the CobbleBrain GitHub README for detailed setup instructions.

How to Trigger 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 durability threshold.
Shift (Ghost): Teleports the player between dimensions with temporary buffs and debuffs.

General Actions

These actions work with any pokemon!

Attack: Pokémon attacks nearby mobs.
Protect: Targets hostile mobs near the player; otherwise follows the player.
Eat: Consumes edible items dropped on the ground (some foods and berries grant effects).
Buff: Grants the player a positive status effect based on type.
Debuff: Applies negative status effects to nearby mobs based on type.
Sit: Pokémon stays in place.
Idle: Cancels commands and returns to normal behavior.

Configuration

CobbleBrain can be configured directly in-game through the mod config menu screen.

There you can customize:

AI provider settings
Prompt instructions
Dialogue behavior
Quest and raid settings
Wild Pokémon interaction chances
Pokémon characteristics and personalities

Advanced users can still edit the generated config files in the /config folder if needed.

For the full list of settings, check the GitHub README.

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?

Depends on model size, prompt length, internet connection, and provider traffic.

How can I speed up Pokémon responses?

- Shorten the prompt. - Enable `lowTokenMode`. - Use smaller/quantized models. - Disable some gameplay systems in the Output Systems section of the config menu.

Issues with key or provider?

CobbleBrain only bridges the game and provider. Contact provider support directly.

Found a bug / suggestion / question?

Join the official Cobblemon discord server, check content-zone-help then search CobbleBrain.

Does the mod collect personal data?

No. Only forwards prompts to provider and returns responses. Local logs only if `debugLogging = true`.

Can I use local models?

Yes, via LM Studio. Large models may crash or require strong hardware.

Revert cobblebrain.json to default?

Delete/rename your `cobblebrain.json5` in `.minecraft/config/`. Restart game → new default config generated.