FIRST START & FILES

The first start

On its first start Soulverse makes config/soulverse/ and writes its settings with every default filled in. Nothing else needs doing. A few things worth knowing:

  • Lives are on for Humans (3 each), lost only when another player kills them. Monsters have none. Change it on the Server tab, or apply a preset.
  • Hardcore worlds start with lives on for Monsters too (5), but only when there's no settings file yet. An existing file keeps what it says.
  • New players go to character creation the first time they join.
  • If your world already had the Additional Souls datapack on, that switch starts on too.

What's in config/soulverse

config/soulverse/
  soulverse-server.json     the Server tab: every setting, and each SOUL's mode
  <username>.json           one file per player who ever joined
  logs/<username>.log       one log per player
  presets/                  your own settings presets
  profanity-filter.txt      the name filter's list
  player-maps.json          Player Map Settings
  trials.json               what you changed on the Trials tab
  kaleidoscope-*.json       only with the Kaleidoscope mods installed
  singleplayer/<world>/     singleplayer worlds, one folder each
FileWhat it is
soulverse-server.jsonEverything on the Server tab, plus whether each SOUL is enabled, greyed out, hidden or disabled. Has a version number Soulverse uses when a default changes between updates
<username>.jsonA player's character: chosen name, race, SOUL, size, look, quirks, lives, mutes, play time, last position. Named after their Minecraft username, renamed by itself if they change it
logs/<username>.logPlain text: kills, deaths with what hurt them, advancements, dimension changes, private messages, ghost chat, name and SOUL changes, lives, and who opened whose chests
presets/*.jsonPresets you saved or exported from the menu. Shared by every singleplayer world on that computer
profanity-filter.txtOne entry per line: a plain word, *anywhere* for a word inside another, or re: followed by a regex. Only used when the Profanity Filter is on, and only for character names, never chat
player-maps.jsonWhat players' map mods may show
trials.jsonTrials you switched off, step counts you changed, rewards you swapped

The world folder gets a few small soulverse-* files too, like the world's id and who got OG for each SOUL. Leave those with the world.

Editing files by hand

You can, and it's fine, but the menu is easier. If you do:

  • Edit, save, then run /sv reload. Hand edits only apply on /sv reload or a restart.
  • Do the reload before you change anything else in the menu, so the two don't get mixed up.
  • Changes made in the menu apply straight away, no reload needed.

Singleplayer

In singleplayer each world keeps its own copy in config/soulverse/singleplayer/<world name>/: its players' files, logs, settings, map settings and trials. Presets are the one thing shared between worlds.

Backups

This is the important bit. Players' SOULs, lives, quirks and names are in config/soulverse/, not in the world folder. Restore a world without its matching config/soulverse/ and everyone's character is gone or out of step.

So back up both together:

  • the world folder
  • config/soulverse/ (the whole thing, logs included if you care about them)

Starting a new season on the same server? The player files outlive the world. Move the old <username>.json files and the logs folder somewhere safe before the new world starts, or everyone carries on with the SOUL and lives they had. Keep soulverse-server.json and presets/ if you liked your settings.

Coming from 0.1.x

Before 0.3.0 the folder was mods/soulverse/. Soulverse moves it to config/soulverse/ by itself on the first start and never writes over a file that's already there. See Updating.