CobbleBrain - AI Dialogue System for Cobblemon

Minecraft 版本： 1.21.1

平台： neoforge

标签： game-mechanics social

CobbleBrain – AI Dialogue System for Cobblemon

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

---

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

❗Report Bugs and Submit Suggestions here!!

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.

---

How to Play

1. Choose How to Play Cloud Mode (Recommended) Cloud mode uses external AI providers to process dialogue. ### Using Player2 (Recommended) * Install the [Player2 app](https://player2.game/) 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](https://youtu.be/tPInNexUEmM)! --- ### Using Other Providers 1. Create an account with a provider (examples: Google AI Studio, OpenAI, OpenRouter). 2. Generate an **API key** from the provider’s dashboard. 3. Choose a model (examples: `gemma-3-12b-it`, `gpt-4.1-mini`, `anthropic/claude-3.5-sonnet`). 4. Open the **mod config Menu** and fill: * `apiKey`: your generated key * `apiBaseUrl`: provider’s official URL * `aiModel`: ID of the chosen model Here's a [Tutorial on YouTube](https://youtu.be/i4OzYmMDzP0)! 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"` ``` Offline Mode (No AI Required) 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. 2. Interacting with Pokémon * Use the command `/mpk ` to talk to your Pokémon. * If `listenToChat = true`, any chat message can be interpreted by the AI. 3. Customize the mod CobbleBrain is highly customizable and can be configured entirely in-game. Press Y to open the configuration menu, where you can customize AI behavior, dialogue systems, gameplay mechanics, memories, actions, quests, and more. ### Recommended settings for new players: **Selected Language** — Changes the language used by the AI during conversations.
**Instruct** — Defines how the AI should behave and respond. You can customize it to make Pokémon more serious, funny, emotional, roleplay-focused, or anything else you prefer. Personality Editor — Customize each Pokémon's Traits, Quirks, Likes, Dislikes, and other personality attributes through an intuitive in-game editor. All the settings include tooltips explaining what they do!

---

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

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

Pokémon are not responding. What should I check? Enable Debug Logging in the mod settings, send another message using /mpk, then check:

cobblebrain-ai/logs

Most issues are caused by:

• Invalid API key
• No provider credits
• Incorrect model name
• LM Studio server not running

Pokémon responses are too slow. Why? Response speed depends on model size, provider traffic, internet connection and prompt size. See the question below to learn how to speed up responses. How can I reduce AI costs and token usage?

• Enable Low Token Mode
• Disable "unnecessary" AI Capabilities
• Use smaller models
• Shorten custom instructions

What are Key Rotation and Model Rotation? Automatically switches to another API key or model when the current one fails or reaches its limit. How do I change Pokémon behavior? Edit the Instruct setting inside the AI Prompt category. You can add, remove or modify instructions to change Pokémon personalities and behavior. To change the behavior of a specific Pokémon, open the Pokémon Personality Editor. The old Characteristics setting is now marked as Legacy. How do I make Pokémon use canon Pokémon language? Enable Needs Pokémon Translator. When enabled, players need an EXP Share to understand Pokémon language. How do I change server settings? Settings marked with (SERVER) must be edited directly inside config/cobblebrain.json5 on the server. Can I play without an AI or internet connection? Yes. Since **v1.4.0**, CobbleBrain includes **Offline Mode** and **Offline Talk Mode**, allowing you to play without an AI provider or an internet connection. Offline Mode keeps many gameplay mechanics available, while Offline Talk Mode lets Pokémon communicate using built-in dialogue and world-aware reactions. For the best experience, however, using an AI provider is still recommended. Does the mod collect personal data? No. CobbleBrain only sends prompts to the AI provider you choose and receives responses back. Can I use CobbleBrain on multiplayer servers? Yes. It is recommended that each player uses their own AI provider instead of sharing a single AI instance. Found a bug, suggestion, or need help? Bug reports & suggestions
Please use the CobbleBrain Feedback Form.

Need support?
Enable Debug Logging first, then ask for help in the CobbleBrain support thread and include your logs whenever possible.

To find the support thread:
1. Join the official Cobblemon Discord server
2. Go to the content-help channel
3. Search for "CobbleBrain"