Speaking Villagers – AI Conversations, Friendships & Quests

Talk to villagers in Minecraft with AI-generated responses, build friendships, and receive dynamic quests!

Now with Mistral API support! Free to use with your own API key 🎉

ATTENTION: KNOWN BUG IN v0.5

If you select a Mistral model, you may get an error saying the OpenAI API key is missing.

Workaround: Set an environment variable OPENAI_API_KEY to any value (like dummy). It doesn’t need to be real.

This will be fixed properly in the next update — thanks for your patience!

Read full description for setup instructions!

 

Overview

Speaking Villagers enhances villager interactions in Minecraft by introducing AI-generated conversations, dynamic villager-player friendships and quests. Villagers now recognize their surroundings, react to your actions, and remember past interactions.

Each villager is assigned one of 2000+ distinct personalities, making every interaction feel even more unique.

Only works on Windows PC.

🆕 Version 0.5 – The free update

✅ Mistral AI Support (Free Option!)

• You can now use the Mistral API as an alternative to OpenAI.
• This makes Speaking Villagers essentially free to use, with no required payments.
• Just sign up for a free mistral account and set your environment variable: MISTRAL_API_KEY = your_key_here

ATTENTION: KNOWN BUG IN v0.5

If you select a Mistral model, you may get an error saying the OpenAI API key is missing.

Workaround: Set an environment variable OPENAI_API_KEY to any value (like dummy). It doesn’t need to be real.

This will be fixed properly in the next update — thanks for your patience!

OpenAI support still exists for those who prefer it (see cost breakdown below).

Features

✅ AI Conversations – Talk to villagers with smart, contextual responses

✅ Context Awareness – Villagers respond to:

• Your player name, armor, held items, hotbar, health and hunger
• Biome, weather, and time of day
• Nearby mobs, blocks, and structures
• Active potion effects and game mode
• Reputation and friendship level
• Whether they're indoors, in bed, swimming, or riding

✅ Friendship System – Befriend villagers and they’ll follow you

✅ Quest System – Villagers offer procedurally generated quests

✅ Gift System – Villagers pick up items and comment on them (must be activated via ModMenu)

✅ 2000+ different personalities – Each villager feels unique

✅ Windows Voice Support – Villagers speak aloud using Windows Speech API

✅ Works alongside the Talking Mobs Mod

🛠️ Fully customizable via ModMenu: Choose AI model, set limits, toggle systems, and more!

API Setup (Mistral or OpenAI)

🎉 Free Option – Mistral

• Create a free account at Mistral AI
• Generate an API key
• Add this to your system as an environment variable: MISTRAL_API_KEY=your_api_key

ATTENTION: KNOWN BUG IN v0.5

If you select a Mistral model, you may get an error saying the OpenAI API key is missing.

Workaround: Set an environment variable OPENAI_API_KEY to any value (like dummy). It doesn’t need to be real.

This will be fixed properly in the next update — thanks for your patience!

Usage is limited to 1.000.000.000 tokens/month, which you will not hit if only using this mod

💰 Paid Option – OpenAI

• Requires an OpenAI Account and API key
• Add this to your system as: OPENAI_API_KEY=your_api_key
• Billed per token (see below)

No API key = No AI responses = No charges. You decide which one to use.

Restart your PC after setting environment variables to take effect.

Installation

🧩 Install the Mod Drop the .jar into your mods folder.

🔊 Install Natural Voice SAPI Adapter for better villager speech

Without it, voices will sound robotic. 👉 Download Adapter (recommended)

🔐 Set up your API key via Environment Variable Choose OpenAI or/and Mistral — both supported.

ATTENTION: KNOWN BUG IN v0.5

If you select a Mistral model, you may get an error saying the OpenAI API key is missing.

Workaround: Set an environment variable OPENAI_API_KEY to any value (like dummy). It doesn’t need to be real.

This will be fixed properly in the next update — thanks for your patience!

OpenAI Cost Breakdown (estimated, for reference)

Model	Est. Cost per Response	100 Responses	1,000 Responses
GPT-3.5 Turbo	$0.0015	$0.15	$1.50
GPT-4o	$0.0165	$1.65	$16.50
GPT-4	$0.0330	$3.30	$33.00

Recommended: Use GPT-3.5 Turbo for best speed/cost ratio

All model choices are available in ModMenu

Commands

/speak <message> – Say something to a nearby villager

/befriend – Manually start a friendship with the nearest villager

/unfriend – Manually end a friendship with the nearest villager

/tokens - shows how many tokens you have used, mainly for debugging/info, not relevant for gameplay

Compatibility

✅ Compatible with most other mods

⚠ Requires Windows (uses Windows Speech API for TTS & Environment Variables)

⚠ Tested in Singleplayer only

📚 Need help? Check the wiki!

☕ Buy me a coffee :)

🎮 Now go chat with your villagers and have fun!