You can download Spirit Companions on CurseForge and Modrinth:
CurseForge: https://curseforge.com/minecraft/mc-mods/spirit-companions
Modrinth: https://modrinth.com/mod/spirit-companions
To keep a better overview of all mods, the issue tracker is located in a separate repository.
For issues, ideas, suggestions or anything else, please follow this link:
Because of the way mod loader files are bundled into one jar, some extra information is needed to do a PR.
A wiki page entry about it is available here:
Spirit Companions was made for SpookyJam 2026, and adds the ability to turn any mob into a spirit companion! Spirits are translucent, glow in the dark and follow their player around. While you move, they fly in a circle around you, through walls and floors. Stand still for a bit, and they'll land and walk around like the normal mob would. Spirits can't be hurt, never despawn and won't attack anything, so even a spirit creeper is harmless!
The spirit of a mob is extracted with the Spirit Lantern. Hold it on a mob for 5 seconds, and its spirit will start following you. What's left is a "soulless" husk, which slowly fades away.
A tamed cat or wolf wearing a Spirit Collar always comes back as a spirit when it dies. Pets and mounts you've had for a long time have a chance to become a spirit without a collar as well, with each in-game day spent together increasing the chance by ~14.29%. Which is 100% after 7 in-game days.
When you log out or travel far away, your spirits go to the "spirit world". They come back once you return, so they also follow you through portals and teleports. By default up to 5 spirits can follow a player, which can be changed in the config.
The mod also adds the Spirit Bell, Spirit Canister and Spirit Saddle. See below for their recipes and an explanation of their functionality. Right now, the spirits are mostly there for companionship. If you have any ideas for new functionality, or making them more useful, let me know on GitHub with a feature request :)
All available config options:
maxSpiritsPerPlayer default 5, min 1, max 100
The maximum amount of spirit companions that can follow a player at the same time.
spiritWorldDistance default 64, min 0, max 256
How many blocks a player can be away from their spirit companions before the spirits go to the spirit world. 0 only sends them there when the player logs out.
spiritExtractionSeconds default 5, min 1, max 30
How many seconds the Spirit Lantern has to be held on a mob to extract its spirit.
huskWitherSeconds default 30, min 0, max 3600
How many seconds a soulless husk takes to fade away after its spirit was extracted. 0 keeps husks until their chunk is unloaded.
collarSpiritReturnSeconds default 10, min 1, max 60
How many seconds the spirit of a pet with a Spirit Collar takes to fully form after the pet died.
spiritTranslucencyPercentage default 50, min 0, max 100
How see-through spirit companions are, in percent. 0 is fully solid, 100 is invisible.
spiritOriginalColourPercentage default 30, min 0, max 100
How much of a mob's own colours its spirit keeps, in percent. 0 makes spirits fully ice blue.
spiritShadowIntensityPercentage default 50, min 0, max 100
The strength of the blue light below spirit companions, in percent. 0 hides it.
spiritOrbitDistance default 4.0, min 1.5, max 8.0
How many blocks away from their player spirit companions circle while flying.
averageSecondsBetweenSpontaneousFlights default 40, min 0, max 3600
How many seconds on average before a walking spirit companion takes off for a short flight by itself. 0 disables these flights.
overlayMessageSeconds default 5, min 1, max 30
How many seconds the mod's messages stay visible above the hotbar. Vanilla uses 3 seconds.
showSpiritParticleTrail default true
Whether spirit companions leave a trail of translucent particles behind them.
spiritParticleTrailAmountModifier default 0.5, min 0, max 10.0
Modifies the amount of trail particles spirit companions leave behind. 2.0 doubles it.
/spiritcompanions summon <mob> - Summons a spirit companion of any mob next to you.
The command requires cheat access.
Spirits fly in a circle around their player, through walls and floors:
Show Spoiler
When the player stands still, spirits land and walk around like normal:
Show Spoiler
Spirits glow in the dark, with a custom shadow and a faint trail of particles:
The Spirit Lantern recipe. It is crafted empty:
Place an Empty Spirit Lantern on a Soul Campfire to charge it:
Hold right-click on a mob with a charged Spirit Lantern to extract its spirit:
Show Spoiler
The husk that remains slowly fades away. It still drops its loot when killed before then:
Show Spoiler
The Spirit Collar recipe. Use it on your tamed cat or wolf, and it'll return as a spirit when it dies:
The Spirit Bell recipe. Ring it twice on one of your spirits to release it.
After ringing the bell: The spirit flies back to its husk, if it still exists, and brings it back to life:
Show Spoiler
The Spirit Canister recipe:
Store a spirit inside and release it somewhere else, or give it to another player:
Show Spoiler
The Spirit Saddle recipe. A spirit mount can only be ridden with one equiped:
You may freely use this mod in any modpack, as long as the download remains hosted within the CurseForge or Modrinth ecosystem.
Serilum.com contains an overview and more information on all mods available.
Comments are disabled as I'm unable to keep track of them across so many separate mod pages.
For issues, ideas, suggestions or anything else there is the Github repo. Thanks!