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

Built for AI-powered gameplay, with offline support since v1.4.0

❗Report Bugs and Submit Suggestions Here!
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 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.

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.
• 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), 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.

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.
• Lost Item Requests – find a treasure barrel with the help of the quest tracker

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.
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.

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 (recommended)

• 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.

C. Offline Mode

Play CobbleBrain without an AI connection.

Starting with version 1.4.0, you can enable Offline Mode and Offline Talk Mode to enjoy an adapted gameplay experience without internet access or an AI provider.

While AI-powered conversations are unavailable, many gameplay mechanics continue to work, allowing you to interact with your Pokémon, use actions, complete quests, and enjoy the mod offline.

How to enable it:

1. Open the Config Menu by pressing Y.
2. Enable Offline Mode.
3. (Recommended) Enable Offline Talk Mode for Pokémon dialogue and reactions.

Note: Using an AI provider is still recommended for the full CobbleBrain experience. Offline Talk Mode will continue to receive improvements and new features in future updates.

How to Trigger 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?

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): Transports the player to an alternate dimension. Player becomes invisible, gains increased speed and jump height, but suffers from high weakness.
• Fish (Water): Pokémon can catch fish from nearby water sources.
• Nightmare Aura (Dark): Creates a terrifying aura that frightens nearby creatures.
• Light (Electric): Creates a temporary light source around the Pokémon.
• Scout (Flying): Sends the Pokémon to scout the surrounding area.
• Teleport (Psychic): Teleports the player to a marked location using the Ping System. Press G to ping the location you're looking at.

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. 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.)
• 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.

FAQ

Pokémon are not responding. What should I check?

Pokémon responses are too slow. Why?

How can I reduce AI costs and token usage?

What are Key Rotation and Model Rotation?

How do I change Pokémon behavior?

How do I make Pokémon use canon Pokémon language?

How do I change server settings?

Can I play without an AI or internet connection?

Does the mod collect personal data?

Can I use CobbleBrain on multiplayer servers?

Found a bug, have a suggestion, or need help?