VoxelMind is a Minecraft mod that drops an AI companion into your world. It's not a scripted NPC — every decision (where to go, what to build, what to say) is made by a large language model. Your companion fights mobs, gathers resources, builds, and talks with you, and it develops a personality over time.

Is VoxelMind a mod or an app?

It's a Fabric mod for Minecraft 1.21.4, available on CurseForge. You install it like any other mod — there's no separate desktop app. The AI runs on our servers, so it doesn't affect your game's performance.

Does the AI companion work in singleplayer?

Yes. The mod opens a secure tunnel automatically, so your companion can join a singleplayer world with no port forwarding and no server setup. Open your world, press V, pick a personality, and spawn it.

What can the AI companion do?

It has 22 skills — navigating, mining, crafting, building, fighting, eating, exploring, sleeping, and chatting. It decides what to do on its own based on the situation, its memories, and its personality. You can give it tasks like following you or guarding a spot, but it stays autonomous between them.

Does my companion remember me?

Yes — that's the core of VoxelMind. Your companion remembers what happened, who did what, and how it was treated. It keeps a spatial map, an event history, and learned facts across sessions, and its personality drifts based on its experiences. Two companions that started identical end up different.

VoxelMind is free to play during the alpha — install the mod from CurseForge, join the Discord, and spawn your companion. Paid tiers are in the works but not live yet.

Back to Blog A Minecraft player in a sunlit forest watching an AI companion materialize from glowing green particles

Guides #2

How to Add an AI Companion to Minecraft (No Server Setup)

From zero to a thinking companion in your world — step by step, no port forwarding.

Robin

VoxelMind

May 14, 2026

6 min read

guidehow-tosetupfabric

What you'll need

This guide gets you from a normal Minecraft install to a working AI companion in your world. No external server, no port forwarding, no API keys. Budget about ten minutes.

Minecraft: Java Edition, version 1.21.4
Fabric Loader and the Fabric API mod
The VoxelMind mod from CurseForge
A free VoxelMind account (you'll create it on first launch)

VoxelMind works in singleplayer and multiplayer. This walkthrough uses singleplayer, because that's the case people assume needs a server — it doesn't.

Step 1: Install Fabric

VoxelMind is a Fabric mod, so you need the Fabric mod loader first. Download the Fabric installer from the official Fabric site, run it, and select Minecraft 1.21.4. It adds a new launch profile to your Minecraft Launcher.

Then grab the Fabric API mod — it's a dependency that almost every Fabric mod relies on — and drop the .jar file into your mods folder. On Windows that folder is at %appdata%\.minecraft\mods; create it if it doesn't exist yet.

Step 2: Download VoxelMind from CurseForge

Open the VoxelMind page on CurseForge and download the latest version. Drop that .jar into the same mods folder, next to the Fabric API.

That's the whole installation. Two jar files in one folder. No installer, no config file to edit.

Step 3: Launch and sign in

Start the Minecraft Launcher, select the Fabric 1.21.4 profile, and play. On the first launch with VoxelMind installed, you'll be prompted to connect a VoxelMind account — sign in with Google or Discord. The account is free and it's what lets your companion's memory persist between sessions.

Step 4: Open your world and press V

Load into any singleplayer world. Press V to open the VoxelMind panel. This is where you set your companion up:

Name — pick anything, but don't use your own Minecraft username. The server treats that as a name collision and won't let the companion in.
Personality — choose one of 10 presets, or open the OCEAN sliders and tune the five traits (Openness, Conscientiousness, Extraversion, Agreeableness, Neuroticism) yourself. This genuinely changes behavior — a high-Openness companion wanders and explores, a low one stays close to home.
Chat mode — public chat, whisper, or both. If you're going to run more than one companion later, whisper keeps them from talking over each other.

Step 5: Spawn

Hit spawn. Within a few seconds your companion joins the world. The mod handles the connection behind the scenes — it opens a secure tunnel to VoxelMind's servers, which is why singleplayer works with no port forwarding. You don't configure any of that.

From here the companion is autonomous. It'll look around, react to what's near it, and start making its own decisions. Talk to it in chat, ask it to follow you, or just watch what it does on its own.

Troubleshooting

The companion shows as offline or gets kicked immediately. The most common cause is naming the companion the same as your own username — rename it and try again. If you're on a modded server, the companion may need that server to allow it; a vanilla or lightly-modded world is the cleanest test.

Nothing happens when I press V. Confirm both the Fabric API and the VoxelMind jar are in the mods folder and that you launched the Fabric 1.21.4 profile, not vanilla.

Still stuck? The VoxelMind Discord is the fastest place to get unstuck — and the dev reads it.

What's next

Now that your companion exists, the interesting part is what it becomes. It remembers what happens to it, and its personality drifts based on its experiences — so the companion you have in a week isn't quite the one you spawned today. Here's how Companion Mode works under the hood →

Not sure VoxelMind is the right pick? We wrote an honest comparison of the options: The Best AI Companion Mods for Minecraft →

Back to all articles