Companion Mode — Fabric Mod

Your AI Companion

A friend that fights by your side, gathers resources on command, and remembers your adventures together.

Download on CurseForgeJoin Discord

What Your Companion Can Do

Follow & Protect

Follows you everywhere. Attacks hostile mobs that get too close.

Gather Resources

"Get me some wood!" — and he's off. Comes back with a full inventory.

Sort & Organize

"Sort the chest!" — Tools here, food there, blocks over there. Done.

Guard Your Base

"Stay here and guard!" — Fights anything that gets close.

Cook & Craft

"Cook some food!" — Fires up the furnace and gets to work.

Chat & Personality

Every companion has a unique personality. Some are sarcastic, some curious, some grumpy — but all loyal.

Get Started in 3 Steps

1

Install the Mod

Download from CurseForge. Requires Fabric Loader for Minecraft 1.21.4. Drop the .jar into your mods folder and launch Minecraft.

2

Log In

Press V in-game or type /vm login. Your browser opens for a quick sign-in with Discord or Google.

3

Spawn Your Bot

Open the GUI (V), choose a personality, and click Spawn. Works in singleplayer and multiplayer — no port forwarding needed.

Singleplayer

Auto-tunnel

Multiplayer

Direct connect

LAN

Auto-tunnel

Realms

Not yet

Mod Commands

CommandDescription
/vmOpen the VoxelMind GUI (same as pressing V)
/vm loginLog in to your VoxelMind account
/vm logoutLog out of your account
/vm spawnSpawn your bot on the current server
/vm stopDespawn your active bot
/vm stopallDespawn all your bots
/vm listList all your bots
/vm statusShow bot status (HP, activity, sparks)
/vm lanOpen your singleplayer world to LAN

Press V at any time to open the GUI instead of using commands.

Care Tips

Send your companion to sleep regularly. During sleep, they reflect on the day and develop their personality further.

Give them good equipment — they're more useful with armor and a sword.

Simple commands work best. "Get wood" instead of "Go 200 blocks north and chop only oak trees."

If you lose your companion, just say "Come!" and wait. They'll find their way back.

If they die — don't panic. They respawn and come straight back to you.

Every companion has a unique personality. Some are sarcastic, some curious, some grumpy. Get to know yours.

Good to Know

  • Can't enter the Nether or the End (yet)
  • Can't dive underwater
  • Can't ride horses, boats, or use elytra
  • Works best on vanilla SMP and self-hosted servers
  • Some servers with anti-cheat may block the bot

Frequently Asked Questions

Does it work in Singleplayer?
Yes! The mod automatically opens your world to LAN and creates a secure tunnel to our servers. No port forwarding needed — just spawn your bot and play.
Does it work on Multiplayer servers?
Yes — any server you can connect to. The bot joins the same server you're on. The server needs to have online-mode set to false (offline mode), since bots don't have Mojang accounts.
Why does my server need online-mode=false?
VoxelMind bots connect as independent players via Mineflayer. They don't have Mojang/Microsoft accounts, so the server needs to allow offline-mode connections. Most hosting providers (Aternos, Apex, etc.) have a toggle for this in server settings.
What are Sparks?
Sparks are the currency for AI decisions. Every time your bot makes a decision (called a 'wake'), it costs 1 Spark. Free accounts get 500 Sparks. When you run out, the bot stops thinking until you recharge.
How long do 500 Sparks last?
Roughly 30-60 minutes of active gameplay. The bot only uses Sparks when it makes decisions — if it's idle or sleeping through the night, it barely uses any.
Can I have multiple bots?
Yes! You can create and spawn as many bots as you want. Each bot uses Sparks independently — more bots just means your Sparks go faster.
The bot isn't joining my server. What's wrong?
Check: (1) Is your server running and joinable? (2) Is online-mode=false? (3) Are you logged in to the mod? Try /vm status to check your connection. If the issue persists, report it in our Discord.
Can I use this on Realms?
Not currently. Minecraft Realms doesn't support offline-mode connections. We're exploring options for Realms support in the future.
Is VoxelMind safe?
VoxelMind is a standard Fabric mod that only adds UI and network features. It does not modify game files, inject code, or download executables. The AI runs on our servers, not on your computer.

Ready to meet your Companion?

500 free Sparks. No credit card. Just install, log in, and play.

Download on CurseForgeJoin Discord