AI Companion – LLM Player Bot (Ollama, llamacpp, LM Studio)

An autonomous AI companion driven by your own LLM. It navigates, gathers, crafts, builds on request, and fights alongside you. Runs fully local with llama.cpp (nothing leaves your network) or any hosted OpenAI-compatible API. Singleplayer & LAN.
Back to Files

aicompanion-0.4.3+mc1.21.11.jar

File nameaicompanion-0.4.3+mc1.21.11.jar
Uploader
dauk808dauk808
Uploaded
Oct 13, 2026
Downloads
409
Size
2.2 MB
Mod Loaders
Fabric
File ID
9152788
Type
R
Release
Supported game versions
  • 1.21.11

Curse Maven Snippet

Fabric

modImplementation "curse.maven:ai-companion-fabric-1619582:9152788"

Learn more about Curse Maven

What's new

# AI Companion 0.4.3 — for Minecraft 1.21.11

The first release for **Minecraft 1.21.11**. Playing 1.20.1? Version 0.2.9 is still the one for you.

**Coming from 0.2.9?** Several updates in between (0.3.0 through 0.4.2) never made it to CurseForge, so everything below is new to you.

## Highlights

- **She sees animals and villagers.** Ask "any cows nearby?" and she can actually tell you. She also now notices slimes, ghasts, phantoms, shulkers and hoglins, which she used to miss.
- **She leads animals with food.** Hand her wheat and cows follow her, just like they follow you. Pigs follow carrots and chickens follow seeds. Any animal you can lead with food, she can too.
- **She can clear blocks.** "Get rid of the dirt in the pen" now works. She breaks every block in an area, up to 512 at a time, and never touches chests, furnaces or other containers.
- **She remembers you.** Tell your companion something ("my dog's name is Duke") and she can bring it up days later, in another world, or on a server. Optional and off by default; it needs a small embedding model such as Ollama's `nomic-embed-text`.
- **Multiplayer for everyone.** Each player brings their own companions, model and API key. The thinking happens on each player's own computer, and their memories stay there. A companion only listens to its owner. Companions are put away when their owner logs off and come back when they return.
- **Bodyguard.** Say "protect me" and she stays at your side and fights whatever comes for you, creepers first, without waiting to be told. She doesn't run from the fight.
- **Chests, with permission.** She can check, take from and put into chests, but only the ones you've opened yourself or told her to use.
- **Builds from what she carries.** Ask for "a small house from what you have" and she designs it around her inventory.
- **Doors.** She opens and closes them instead of breaking through.

## Privacy: no Player2 code, no telemetry

The engine inside this mod is our fork of PlayerEngine. Until now it still carried upstream's code for the Player2 hosted service: an account login, a background "heartbeat" request to Player2's servers every minute, and a route that could send AI requests there. It was switched off by default and AI Companion never used it, but it was in the jar. **It has now been deleted.**

- The mod sends no telemetry and contacts no service of its own.
- The only network requests it makes go to endpoints **you** set in its config: your AI model, and optionally an embeddings model (memory) and a voice server (TTS). The defaults point at your own machine.
- The bundled engine now appears in your mod list as "AI Companion Engine (PlayerEngine fork)", so it's clear what it is.

## Also new

- **Better manners in company.** With other players online she only picks up lines that use her name, plus your follow-ups within 30 seconds of talking to her.
- **Instant edits.** Change a companion's skin, voice or personality in the settings and it applies immediately.
- **Cheaper on hosted models.** Most of each request is now cached by the provider.
- **Cloth Config is optional.** It's only needed for the settings screen. Without it, `/aicompanion config` edits settings from chat.
- **Local models:** servers that ignore or refuse JSON mode (seen with llama.cpp and LM Studio) are now handled.
- **Memory listens past "okay".** A sentence starting with filler like "okay", "hm" or "alright" no longer skips her memory for that turn. "okay stop" is still a command.
- **Bodyguard stays on duty.** Guard mode no longer gives up after a quiet minute when she can't step any closer to you.
- **Fixes:** two different crashes when a companion goes fishing (one could disconnect you from a server), chat flooded with "Fishing process started", item duplication with chests, companions frozen after reconnecting to a dedicated server, conversation lost on logout, getting stuck in powder snow, and many more.

## Requirements

Minecraft 1.21.11 · Fabric Loader 0.17.2+ · Fabric API · **Architectury API**.
Optional: Cloth Config and Mod Menu (settings screen), and Kokoro in Docker (voice).
You still need a model to think with: a local server (llama.cpp, Ollama, LM Studio) or a hosted OpenAI-compatible API key.

**Running a server?** Its settings now live in `config/aicompanion-server.json`. That file is created from your old `aicompanion.json` the first time the server starts.

## Known issues

- If a companion is unloaded mid-task (for example, you die far away), she forgets the task. Just ask again.
- Free hosted models struggle with large builds. Small ones are fine.
- Stopping a build doesn't cancel the plan her model is already writing.
- Goats, axolotls, frogs, camels, armadillos and sniffers won't follow her food yet. Cows, sheep, pigs, chickens, rabbits and horses will.
- If a hostile mob shows up while she's leading animals, she may swap the food for a weapon, and they stop following.
- Land-claim mods can't see companions (they aren't players), so on a protected server a companion could break blocks inside a claim.

This mod has no additional files