INSTALLING

Soulverse is a Fabric mod that has to be on both sides: the server and every player's game. A player without it can't join, and a player with a different version will run into trouble (more on that in Troubleshooting).

What you need

Minecraft26.3. There are builds for 26.2 and 26.1.2 too, Modrinth lists which file is for which version
Fabric Loader0.19.5 or newer
Fabric APIAny recent one. If you add Strapped, 0.165.2 or newer
Java25, on the server and on players' launchers

Download Soulverse from Modrinth and drop the jar into the server's mods folder. Do the same on every player's game, or better, make a modpack (a Modrinth profile works fine) so everyone gets exactly the same files.

Soulverse is in beta (0.3.0-beta). Back up your world before adding it, and keep backups going after.

Installing on a server

  1. Install Fabric on the server the usual way (Fabric's server launcher, or your host's "Fabric" option).
  2. Put soulverse-<version>.jar and Fabric API in mods/.
  3. Make sure the server starts with Java 25. java -version in the server's shell tells you. On a host, pick Java 25 in the panel.
  4. Start it once. Soulverse makes config/soulverse/ with its settings. See First start & files.
  5. Join as an operator and type /sv.

Optional mods

None of these are needed. Soulverse checks for each one and quietly does without it.

Server and players both

ModWhat it gives you
Strapped (0.2.0-beta or newer, 26.3 only)Back, waist and quiver slots, Tool Bundles, backpacks. Soulverse draws its screens and shows its slots in the admin inventory view. Older Strapped versions are refused at startup with a message, and it can't run next to the original Accessories mod
Simple Voice ChatProximity voice. Soulverse adds ghost voices, possessed players speaking, and mutes, deafening, voice bans and volume from the SV menu. See Voice chat
LootrWorks with the Lucky-Find quirk, so each player gets their own roll on a chest
Kaleidoscope Cookery, Tavern, NetherFood effects, drink effects, barrel aging and the skull recipe can be changed from the SV menu's Mod Configs

Server only

ModWhat it gives you
LuckPermsHand out Soulverse's permissions per group instead of "ops get everything". See Permissions

Players only

ModWhat it gives you
Sodium and IrisFully supported, with or without a shader pack
Diorama, Xaero's Minimap and World Map, JourneyMapThe server decides what their maps may show, no extra mod on the server. See Mod Configs & Player Map Settings
JadeShows a player's chosen name, SOUL and lives when you look at them
ControlifyController support on every Soulverse screen
Mod Menu, AppleSkin, LambDynamicLights, JEI or REISettings from the mod list, food values on Soulverse's bar, light from ghosts, recipe viewers in Soulverse's look

The full list is on Compatibility.

Singleplayer and LAN

In singleplayer your game is the server too, so everything here applies, only the files go somewhere else (see First start & files). Opening a world to LAN works; your friends need the same mods as you.

Additional Souls

Soulverse comes with a second set of 14 SOULs called Additional Souls. It's off until you switch it on: SV menu, Server tab, Expansions, then restart. A world that already has the datapack switched on gets the setting turned on by itself.