?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
CobbleBrain - AI Dialogue System for Cobblemon

CobbleBrain - AI Dialogue System for Cobblemon

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!

61
2

Compatibility

Minecraft: Java Edition

1.21.1

Platforms

Supported environments

Server-side
Singleplayer

Links

Report issues View source
Donate on Ko-fi

Creators

VICdev
VICdevMember

Details

Licensed MIT
Published 6 days ago
Updated 10 hours ago

Until this message is on this page, the mod is not playable for players with a free API, since Google has practically decided to remove the Gemini models from free use... BUT DON'T WORRY, I will adapt the mod to use FREE models!

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

    How to play:

    1. You’ll need to have a Google AI Studio (NOT Google cloud) account. Its easy, if you already have a google account, you just need to read and accept the terms and conditions and you are good to go.
    2. Then you need to copy the API key or, if you dont have it, generate one. Then, paste your key in the apiKey field inside cobblebrain.json in the config folder.  You dont need a paid key, just generate a free one (without billing)

    link to the tutorial available on youtube here!

    3. To speak to your pokemons, use the command /msgpk then write the message, or use the chat with listenToChat enabbled in cobblebrain.json... (Messages from other players may be used by the AI if listenToChat is enabled. It is recommended to use this setting only in single-player worlds.)

    Never share your apikey to others!

     

    Features: 

    Pokémon can talk to the player and to other team members.

    New 0.6.0 update: The Command System allows Pokémon to respond directly to player chat or act autonomously, executing behaviors like:

    • 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 consumes edible items dropped on the ground (excluding powerful items like golden apples). Food effects will be added in future updates.
    • 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.

    Dialogue is influenced by each Pokémon’s nature, friendship level, past interactions, and world conditions such as weather, time of day, and biome.

    Pokémon can assist you on your adventures, warning you about nearby ores or blocks of interest (configurable soon).

    Your actions and words affect friendship with your Pokémon (also configurable). The system works by collecting data from both the player and the Pokémon, then feeding it into the AI that generates natural dialogue. 

     

    Customization:

    In the cobblebrain.json file, located in run/config, you can edit the following values:
     
     
    • apiKey (String): the key is needed for the mod to communicate with the AI ​​server
    • selectedLanguage (String): Allows the user to select the language they would like the AI ​​to speak
    • Instruct (String): allows the user to change the AI's instructions to whatever they want. recommended not to change the entire instruct and use the default instruct as a model for what you want
    • maxDialogueSaves (Int): This variable determines how many dialogs are saved to be sent to the AI ​​as "memory" and reference for the next dialogs. Very high numbers can overload the AI, causing dialogs to freeze or become messy. The recommended number is 3.
    • dialogueAffectFriendship (Boolean): Determines whether dialogue can cause your friendship with Pokémon to increase...
    • spontaneousDialogueChance (Double) Probability that the AI will trigger spontaneous dialogue (e.g., Pokémon speaking on their own during idle moments). Default: 0.15 (15%).
    • visibleAiWarnings (Boolean) Determines whether the player sees mod-related warning messages in chat. Example: "Hold on, your Pokémon are still processing what you said..." (does not include warnings from the AI ​​itself)
    • listenToChat (Boolean) Enables or disables listening to regular player chat.
      If true, the AI will process normal chat messages as input.
      If false, the AI will only respond to explicit commands (like /msgpk).
    • PokemonTalk: toggle Pokémon speech (basically an on/off switch of the mod).
    • DialogueOnDamage: trigger dialogue when player or Pokémon takes damage.
    • DialogueOnBattle: trigger dialogue during battle events.
    • allowPokemonPVE: toggle whether Pokémon can fight against mobs (Except tamed mobs, non-agressive mobs with tags and other pokemons).
    • allowPokemonPVP: toggle whether Pokémon can fight against other players and their pokemon (Player vs Player).

    EXPERIMENTAL: onlyNearbyChat (Boolean) If enabled, the AI only listens to chat messages from nearby players (within a radius of 15 blocks).
    Only applies if listenToChat is also set to true.

     

    Development Status:

    The project is open-source, you are free to download, modify and improve it. If you use this code (or parts of it) in another mod or software, please give proper credit.
     

    Q&A

    Q: Can I say anything to my Pokémon?
    A: Technically yes, but remember that it’s YOUR Google key being used. Please keep interactions reasonable. 
     
    Q: Does the mod share my API key?
    A: No. The key is stored locally and only used to communicate with Google’s servers for the AI to function. It is never sent anywhere else. 
     
    Q: Will this mod continue to be updated?
    A: Yes, though I can’t guarantee for how long. The plan is to keep it open-source so others can improve or create their own versions.
     
    Q: Can i use this mod in a modpack?
    A: You can, but using beta versions can cause some problems or incompatibilities that are still unknown to me for now...
    •  
    If you have any questions, suggestions or problems about the mod, you can put them in the comments or in my youtube channel (linked in the project).