Talking Colonists (Minecolonies Addon)

This mod uses the Gemini Flash 3 Live API to enable talking to the citizens. They talk about their happiness, job, whatever you like!
Talking Colonists
Create a server, get 25% off your first monthaffiliate logo
Create Server
affiliate banner image

You can interactively talk to citizens in your minecolonies just as if they were alive!

New: Colony members can now talk with each other and initiate a conversation with you!

Got questions? Join the discord server!

Also I'm open for open for commissions!

Make sure you are using the latest version of the mod! Older versions might have bugs

Setup Guide

Last tested versions for Minecolonies are:

  • Neoforge: 1.1.1305-1.21.1-snapshot
  • Forge: 1.20.1-1.1.1218-snapshot

It is possible for later versions of minecolonies for this mod to break.

  1. Install all dependencies (Minecolonies, Voicechat and Gemini Live Lib)

 

Video Tutorial:

Needed link: AiStudio

 

Text Tutorial: 

 blue Create API button

  1. Head to the Google AI Studio and create an API key by pressing the white create API key button
  2. Copy the token

  3. Either the config file via text editor in config/yacl-mc_talking.json5 or via the in-game GUI. Set the token and your desired speaking language:

// This key is used to authenticate with the Gemini API. You can get one at https://aistudio.google.com/apikey
    geminiApiKey: "Put your api key here", // don't forget the comma!

(The free tier allows up to 3 citizens to be spoken at the same time)

Usage

Craft a Citizen Communication Device using a Book and Quill and a Redstone Torch (I would really appreciate it if someone could create a better texture for it): Crafting Recipe Then left click on a citizen you want to talk to and something similar to this will show: Citizen that can be talked to

Now the citizen will complain if they are unhappy or missing some resources, just talk right away!

 

How do I change the language of the citizens?

First have a look at this table and remember your languages "BCP-47 Code" and update the config via notepad in your minecraft serer/modpack location or via ingame ui:

language = "put your languages code here"

  

Troubleshooting

The Citizen isn't speaking, it just shows "listening"

This issue might be related to having the wrong input device set. To make sure your set up is working correctly, open the voice chat settings (by default this is done by pressing v), then click on "Settings" and press the microphone button. If you can't hear yourself talking, adjust input / output devices

My Citizen Status shows "Talking" but I can't hear anything

Same issue as above

Can I include this in my modpack?

Yup

 

Just a quick disclaimer: If you are using the free tier, google may use data for improvement outside the UK/CH/EEA/EU

The Talking Colonists (Minecolonies Addon) Team

profile avatar
  • 1
    Followers
  • 2
    Projects
  • 161.1K
    Downloads

More from sshcrack

  • Gemini Live Library project image

    Gemini Live Library

    • 84.8K
    • Mods

    This library contains an implementation of a websocket client and utility functions for communicating with the Gemini Live API.

    • 84.8K
    • June 4, 2026
    • Mods
  • Gemini Live Library project image

    Gemini Live Library

    • 84.8K
    • Mods

    This library contains an implementation of a websocket client and utility functions for communicating with the Gemini Live API.

    • 84.8K
    • June 4, 2026
    • Mods