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
| Minecraft | 26.3. There are builds for 26.2 and 26.1.2 too, Modrinth lists which file is for which version |
|---|---|
| Fabric Loader | 0.19.5 or newer |
| Fabric API | Any recent one. If you add Strapped, 0.165.2 or newer |
| Java | 25, 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
- Install Fabric on the server the usual way (Fabric's server launcher, or your host's "Fabric" option).
- Put
soulverse-<version>.jarand Fabric API inmods/. - Make sure the server starts with Java 25.
java -versionin the server's shell tells you. On a host, pick Java 25 in the panel. - Start it once. Soulverse makes
config/soulverse/with its settings. See First start & files. - 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
| Mod | What 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 Chat | Proximity voice. Soulverse adds ghost voices, possessed players speaking, and mutes, deafening, voice bans and volume from the SV menu. See Voice chat |
| Lootr | Works with the Lucky-Find quirk, so each player gets their own roll on a chest |
| Kaleidoscope Cookery, Tavern, Nether | Food effects, drink effects, barrel aging and the skull recipe can be changed from the SV menu's Mod Configs |
Server only
| Mod | What it gives you |
|---|---|
| LuckPerms | Hand out Soulverse's permissions per group instead of "ops get everything". See Permissions |
Players only
| Mod | What it gives you |
|---|---|
| Sodium and Iris | Fully supported, with or without a shader pack |
| Diorama, Xaero's Minimap and World Map, JourneyMap | The server decides what their maps may show, no extra mod on the server. See Mod Configs & Player Map Settings |
| Jade | Shows a player's chosen name, SOUL and lives when you look at them |
| Controlify | Controller support on every Soulverse screen |
| Mod Menu, AppleSkin, LambDynamicLights, JEI or REI | Settings 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.