CobbleBrain - AI Dialogue System for Cobblemon

<details> <summary> Cloud Mode (Easiest)</summary>

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

1. Create an account with a provider (examples: Google AI Studio, OpenAI, OpenRouter). 2. Generate an mod config Menu 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!

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

Config menu 1. Install Config menu (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"` ```

* Use the command `/mpk <message>` to talk to your Pokémon. * If `listenToChat = true`, any chat message can be interpreted by the AI.

* Use `lowTokenMode` for faster and lighter responses. * Adjust `maxShortMemory` and `maxLongMemory` to control how much dialogue memory Pokémon retain.

These actions only work when the Pokémon has the right primary type. <br>Example: Charizard (fire, flying) can use cook, but Chandelure (ghost, fire) cannot.

<details> <summary>Cook (Fire)</summary> Can cook food and smelt ores. 5% chance of item turning into charcoal.

Grows tree saplings and crops.

Repairs tools and weapons up to a certain durability threshold.

Transports the player to an alternate dimension. Player becomes invisible, gains increased speed and jump height, but suffers from high weakness.

These actions work with any pokemon!

<details> <summary>Attack</summary> Pokémon attacks any mobs close to it.

Pokémon targets hostile mobs nearest to the player; if none are found, it follows the player.

Pokémon eat any edible item dropped on the ground. Some foods and berries may grant temporary effects.

Pokémon grants the player a positive status effect based on its primary type (e.g., regeneration, speed).

Pokémon applies a negative status effect to nearby mobs based on its primary type (e.g., slowness, weakness).

Pokémon stays fixed in place, ignoring other actions.

Pokémon cancels all active commands and returns to normal behavior.

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.

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.

It depends on: 1. Model size (larger models are slower). 2. Prompt length. 3. Internet connection quality. 4. Provider traffic load.

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.

CobbleBrain only bridges the game and the provider. If problems related to the provider occurs, contact the provider’s support directly.

Join the official <span style="color:#3598db"><a href="https://discord.gg/cobblemon" target="_blank" rel="nofollow">Cobblemon discord server</a></span>, check content-zone-help then search CobbleBrain.</div>

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

Yes, via LM Studio. But be careful: large models may cause crashes or require strong hardware.

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.