PRESETS

A preset puts a whole batch of settings in place at once: Server tab settings, and each SOUL's mode if the preset has them. Find them under Settings Presets..., the first row on the Server tab, or use /sv presets.

Applying one

  1. Open /sv, Server tab, Settings Presets...
  2. Each preset says how many of your settings it would change.
  3. Click Apply and confirm.

Only the settings that differ get changed; anything the preset doesn't mention stays as you had it. If a preset switches an Expansion on or off, you'll get the "Restart required" line as usual.

From chat:

/sv presets list
/sv presets apply pvp

The built-in three

PresetIn short
CasualRelaxed play among friends: no lives to lose, no Soul-Draining, no possessing players, nothing taken away at the crafting table
HardcoreEvery death counts: Humans and Monsters both have 3 lives, lost to anything, and the last one makes a ghost
PvPBuilt for fighting each other: 3 lives lost only to players, Life-Steal for everyone, Soul-Draining, no Mace enchantments, Freecam kicked

What each one actually sets:

Casual: Lives off (Monsters too), both Life-Steal switches off, Monsters take Humans' lives off; Soul-Drain off; Possess players and Possess others' pets off; every Gameplay limit off (Mace, netherite, diamond, enchanting table, Elytra); Monsters, Random SOUL and new looks all allowed; Ghosts in TAB on.

Hardcore: Lives on; Humans 3, any death costs one; Monsters have lives, 3, any death costs one; Monsters take Humans' lives on; Monsters Get Life-Steal on, Humans off; Ghost Mode on, Ghosts in TAB on; Soul-Drain on.

PvP: Lives on; Humans 3 and Monsters 3, only PvP costs a life; Monsters take Humans' lives on; Life-Steal for both; lives shown on the heart in chat, TAB and name tags; Soul-Drain on; No Mace Enchantments on; Kick Freecam users on; Admins read ghost chat on.

A preset is a starting point. Apply it, then tweak what you like on the Server tab.

Your own presets

  • Save current as... saves every Server tab setting and every SOUL's mode under a name you type. /sv presets save <name> does the same. Saving under a name you already used replaces that one. You can't use a built-in preset's name.
  • Export writes the same thing to a new file called export_<time>.json.

Both go in config/soulverse/presets/. They're the same layout as soulverse-server.json, plus a name and description, so you can edit them by hand or hand them to another server owner. Drop a preset file in that folder and it shows up in the list.

A preset doesn't have to list everything. One that only says

{
  "name": "Quiet nights",
  "description": "No possessing players, ghosts can't go deep into walls.",
  "possession": { "players": false },
  "ghost": { "wall_depth": 2 }
}

changes just those two and leaves the rest.

Permissions

Everything here needs soulverse.server.presets. Applying one also needs the category permission of every setting it changes (soulverse.server.lives for lives, and so on), and soulverse.souls.edit if it changes a SOUL's mode. If something's missing, Apply is greyed out and says what. Every applied preset is written to the server log with who did it and each setting it changed.