Niebla: AI Wolf Companion

Niebla brings an intelligent and expressive wolf companion into your Minecraft world.

When a player enters a world for the first time, Niebla appears as their own tamed wolf. She can follow the player, react to nearby situations and communicate through natural AI-generated dialogue.

Niebla is designed to feel like a loyal dog first: friendly, curious, affectionate and protective. However, she may occasionally notice something unusual or make a strange observation that changes the atmosphere of an otherwise normal adventure.

Features

A personal tamed wolf companion for each player.
AI-generated conversations powered by Groq.
Talk to Niebla through Minecraft chat.
Push-to-talk microphone support.
Animated dialogue bubbles displayed above Niebla.
Voice responses using Minecraft’s built-in narrator.
Contextual reactions to the player’s surroundings.
Friendly and dog-like personality with occasional unsettling remarks.
Ambiguous threat reactions without revealing exact enemy names, coordinates or distances.
Commands for summoning and configuring Niebla.
Support for both Forge and Fabric.
Designed for Minecraft 1.20.1.

Talking to Niebla

You can communicate with Niebla by writing her name in chat:

Niebla, should we keep exploring?

You can also hold the configured push-to-talk key and speak to her using your microphone.

Niebla keeps her responses short and natural so that conversations do not interrupt normal gameplay.

Commands and Controls

Hold V to speak to Niebla.
Press F8 to call Niebla.
/niebla summon — Summons or recovers your Niebla.
/nieblaconfig — Opens the configuration file.
/nieblareload — Reloads the configuration without restarting Minecraft.

Default key bindings can be changed from Minecraft’s Controls menu.

Configuration

Niebla automatically creates the following configuration file:

config/niebla_ai_pet.properties

The configuration allows players to manage AI access, dialogue behavior, voice features and other mod options.

Requirements

AI conversations require:

An internet connection.
A personal Groq API key, you can get it here: https://console.groq.com/keys
A supported Forge or Fabric installation for Minecraft 1.20.1.

No shared API key is included with the mod. Each player must provide their own Groq API key in the configuration file.

Voice output uses Minecraft’s built-in narrator. Voice availability and quality may depend on the operating system and installed system voices.

Privacy and External Services

Messages sent to Niebla and limited contextual information required to generate her response are processed through the configured Groq API service.

Your Minecraft world files are not uploaded by the mod.

Important

Niebla is intended to be an immersive companion, not an enemy radar. She may sense that something feels wrong, but she will not reveal exact entity distances or precise locations.

Sometimes she knows something is nearby.

That does not always mean she will tell you what it is.

Watch the Experience

Playthrough:

Niebla - Your AI Wolf Companion