The REPO Heads mod for Minecraft tosses in some wild head and eye animations straight from the Steam game R.E.P.O.. It’s a fun way to spice up your game with some goofy character flair. Here’s a chill guide to get it running, what it does, and how to mess with it.

1. What’s REPO Heads About?

176ac1ac90cbb1590a79fc23b3253f8c58a1034a

The REPO Heads mod adds some fun to Minecraft by borrowing the wild head and eye movements from the Steam game R.E.P.O.. When you speak in voice chat, your character’s head splits open, with the split getting bigger the louder you talk, and you can choose exactly where it happens, just leaving a pixel of space at the top and bottom. The eyes are cool too, following in-game stuff like mobs or other players, and you can stick up to two eyes and pupils wherever you like on your character’s head.

If you’re playing with friends who also have the mod, your custom tweaks sync up, so everyone sees your character the way you designed it. It runs on Minecraft 1.20 and later, including 1.21.5, and works with the Fabric loader for now, though the creators might add Forge and NeoForge support down the road.

2. What You Need to install REPO Heads

2596e5d55a95ccfb22d6fa9df107919b565e4679

  • Minecraft Version: 1.21.5 (also works on 1.21.1–1.21.5).
  • Mod Loader: Fabric API.

Must-Have Mods:

  • Simple Voice Chat: Gotta have this for the voice-triggered stuff.
  • Where to Grab It: Modrinth (search for REPO Heads by laf).

3. How to Set Up REPO Heads

 

Here’s the step-by-step to get REPO Heads running on Minecraft 1.21.5:

  • Snag the Fabric installer from Fabric’s site. Run it, pick 1.21.5, and install it for the client.
  • Grab the Fabric API mod from Modrinth or CurseForge (make sure it matches 1.21.5).

Download the Mods

Head to the REPO Heads Modrinth page. Pick the latest version (like 1.0.1+1.21.5 or whatever fits your game version).

Also download Simple Voice Chat from Modrinth, double-checking it works with 1.21.5.

Find Your Mods Folder

Open your Minecraft folder:

  • Windows: C:\Users\[YourName]\AppData\Roaming\.minecraft
  • Mac: ~/Library/Application Support/minecraft
  • Linux: ~/.minecraft

Look for the mods folder or make one if it’s not there.

Drop in the Mods

Copy the .jar files for Fabric API, Simple Voice Chat, and REPO Heads into the mods folder.

Fire Up Minecraft

Open the Minecraft Launcher. Choose the Fabric 1.21.5 profile from the dropdown. Launch and check the mods menu to make sure everything loaded.

Test It Out

Hop into a multiplayer world (this mod’s best with others). Talk through your mic to see your character’s head and eyes go wild. Make sure Simple Voice Chat is set up right.

4. Tweaking and Playing Around with REPO Heads

22843b9ca4518f5948d5fb166bbf39f334193d3c

Settings

Find the mod’s options in the mods menu or in-game settings (if it has them). Mess with eye positions (up to two eyes/pupils) and head split height to make your character look how you want.

Your tweaks sync with other players who have the mod, so they’ll see your setup.

Voice Chat Setup

Open Simple Voice Chat settings (usually press V in-game). Test your mic to make sure the mod picks up your voice for animations.

5. If Stuff Goes Wrong

Mod Not Loading?

Check that Fabric API and Simple Voice Chat are installed and match 1.21.5.

Make sure you’re on the right Minecraft version and using Fabric.

Try pulling other mods to rule out conflicts.

No Head or Eye Movement?

Confirm Simple Voice Chat is working and your mic’s picking up sound.

Test in multiplayer, since the mod needs voice chat to shine.

Got a Bug?

Report issues using the mod author’s form: https://forms.gle/qCPAtm9HrRYKyRaH7. Don’t use it for suggesting new features.

6. Extra Info

  • Multiplayer Note: This is a client-side mod, so only players with it see the animations. For max fun, get everyone on your server to install REPO Heads and Simple Voice Chat.
  • Map from Laf’s Video: The map in the mod’s promo video might be shared with Laf’s Discord members. Join the Discord to ask, but it won’t have doors or physics stuff.
  • Updates: The mod team plans to add Forge and NeoForge support and keep it working for 1.20 and up. Follow it on Modrinth for news.
  • Performance: It’s a light mod, but voice chat can be a bit heavy in multiplayer. Make sure your setup can handle it.