SERVER SETTINGS & PRESETS

Every rule is on the SV menu's Server tab (/sv), grouped by category, with a search. Changes apply at once, except the Expansions, which need a restart. They are kept in config/soulverse/soulverse-server.json, which can also be edited by hand (then /sv reload). Each quirk's own settings are on the Quirks tab beside the quirk, and on every quirk's page in this wiki.

Settings presets

Settings Presets..., the Server tab's first row, puts every Server tab setting and SOUL setting in place in one go (or /sv presets apply <id>). Apply says how many settings will change and asks first; settings already as the preset has them are left alone.

PresetWhat it is forWhat it sets
Casual
casual
Relaxed play among friends: no lives to lose, no Soul-Draining, no possessing players, nothing banned at the crafting table.Lives: Off
Monsters have lives: Off
Humans Get Life-Steal: Off
Monsters Get Life-Steal: Off
Monsters take Humans' lives: Off
Soul-Drain: Off
Possess players: Off
Possess others' pets: Off
No Mace Enchantments: Off
No Netherite Tools: Off
No Netherite Weapons: Off
No Netherite Armor: Off
No Diamond Tools: Off
No Diamond Weapons: Off
No Diamond Armor: Off
No Enchanting Table: Off
No Elytra: Off
Allow Monsters: On
Allow a Random SOUL: On
Allow a new look: On
Ghosts in TAB: On
Hardcore
hardcore
Every death counts: Humans and Monsters both have 3 lives, lost to anything, and the last one makes a ghost.Lives: On
Human lives: 3 lives
Humans: only PvP costs a life: Off
Monsters have lives: On
Monster lives: 3 lives
Monsters: only PvP costs a life: Off
Monsters take Humans' lives: On
Humans Get Life-Steal: Off
Monsters Get Life-Steal: On
Ghost Mode: On
Ghosts in TAB: On
Soul-Drain: On
PvP
pvp
For fighting each other: 3 lives lost only to players, Life-Steal for all, Soul-Draining, no Mace enchantments, Freecam kicked.Lives: On
Human lives: 3 lives
Humans: only PvP costs a life: On
Monsters have lives: On
Monster lives: 3 lives
Monsters: only PvP costs a life: On
Monsters take Humans' lives: On
Humans Get Life-Steal: On
Monsters Get Life-Steal: On
Heart shows lives in chat: On
Heart shows lives in TAB: On
Heart shows lives on name tags: On
Soul-Drain: On
No Mace Enchantments: On
Kick Freecam users: On
Admins read ghost chat: On

Save current as... keeps the server's settings as a preset of its own, and Export writes them to a new file; both go in config/soulverse/presets/, where presets can be shared and edited by hand. A saved preset holds every setting and every SOUL's mode. Presets need soulverse.server.presets, and applying one also needs the permission of every category it changes.

Quirk balance

Under Quirks › Balance two settings scale every quirk at once, on top of each quirk's own numbers:

  • All Quirk Waits (100%, 10–500%): every quirk's waits and cooldowns. Ultimate-Duration still means no waits.
  • All Quirk Damage (100%, 10–500%): how strongly quirks make blows harder or softer, and their own strikes (Verdict-Strike, Into-the-Breach, Mark-of-Retribution).

Every setting

Character creation

SettingDefaultRangeWhat it does
Make a character on joining
creation.prompt_on_join
OnOn / OffNew players are taken to character creation when they first join.
Allow Monsters
creation.allow_monsters
OnOn / OffWhether new characters can be Monsters.
Allow a Random SOUL
creation.allow_random_soul
OnOn / OffWhether new characters can leave their SOUL to chance.
Allow a new look
creation.allow_custom_look
OnOn / OffWhether new characters can put together a new look, or only keep their own skin.
Unique names
creation.unique_names
OnOn / OffNo two characters can have the same name (or another player's username).
Award OG
creation.og
OnOn / OffThe first player to choose each SOUL themselves (not left to fate) gets OG.
Smallest size
creation.min_size
90%90% – 110%How small new characters can be, in percent.
Largest size
creation.max_size
110%90% – 110%How large new characters can be, in percent.

Names

SettingDefaultRangeWhat it does
Show chosen names
names.use_chosen_names
OnOn / OffCharacters' names are shown in chat, the tab list and on name tags instead of usernames.
SOUL hearts beside names
names.soul_colored_names
OnOn / OffA heart in each player's SOUL colour before their name in chat, TAB and on name tags. Names stay white.
Vanilla chat formatting
names.vanilla_chat_formatting
OffOn / OffChat as Minecraft writes it (<name> message) for everyone. Off: name » message, the message in light grey.
Profanity Filter
names.profanity_filter
OffOn / OffSlurs and the worst people's names can't be character names (chat is left alone). List: profanity-filter.txt
Shortest Name
names.min_length
3 letters1 letters – 16 lettersThe fewest letters a character's name may have when it is chosen. Names chosen before stay as they are.

Gameplay

SettingDefaultRangeWhat it does
Frisk's Hard Mode
gameplay.frisk_hard_mode
OnOn / OffA character named Frisk plays in Hard Mode, as in Undertale.
No Mace Enchantments
gameplay.no_mace_enchants
OffOn / OffMaces can't be enchanted at the enchanting table or with books on an anvil. Enchanted ones keep theirs.
No Netherite Tools
gameplay.no_netherite_tools
OffOn / OffDiamond pickaxes, axes, shovels and hoes can't be upgraded to netherite at a smithing table. Ones made already stay.
No Netherite Weapons
gameplay.no_netherite_weapons
OffOn / OffDiamond swords and spears can't be upgraded to netherite at a smithing table. Ones made already stay.
No Netherite Armor
gameplay.no_netherite_armor
OffOn / OffDiamond armor can't be upgraded to netherite at a smithing table. Pieces made already stay.
No Diamond Tools
gameplay.no_diamond_tools
OffOn / OffDiamond pickaxes, axes, shovels and hoes can't be crafted, in a crafting table or a crafter. Ones made already stay.
No Diamond Weapons
gameplay.no_diamond_weapons
OffOn / OffDiamond swords and spears can't be crafted, in a crafting table or a crafter. Ones made already stay.
No Diamond Armor
gameplay.no_diamond_armor
OffOn / OffDiamond armor can't be crafted, in a crafting table or a crafter. Pieces made already stay.
No Enchanting Table
gameplay.no_enchanting_table
OffOn / OffEnchanting tables offer no enchantments. Things enchanted already keep theirs; anvils and books are not affected.
No Nether Portal Building
gameplay.no_nether_portal_creation
OffOn / OffNo nether portal can be made by anyone or anything (flint and steel, fire charges, burning wood, lightning), nor generated on the other side of one. Existing portals still work.
No End Portal Building
gameplay.no_end_portal_creation
OffOn / OffThe last eye of ender doesn't open an end portal. Existing portals still work.
Nether Portals Closed
gameplay.no_nether_portal_entry
OffOn / OffExisting nether portals don't take anyone into the Nether (the way back still works). Building them is its own switch.
End Portals Closed
gameplay.no_end_portal_entry
OffOn / OffExisting end portals don't take anyone into the End (the way back still works). Building them is its own switch.
No Elytra
gameplay.no_elytra
OffOn / OffElytras can't be worn, in armour slots or in other mods' slots, and nobody can glide. Worn ones come off.
Disable Early Dragon Fight
gameplay.no_early_dragon_fight
OffOn / OffNo dragon in the End at first: the exit portal is open, so players come and go freely. It never comes by itself.
Enable Manual Dragon Fight
gameplay.manual_dragon_fight
OnOn / OffEnd crystals on the exit portal call the dragon, as when fighting it again. The first one leaves the egg.
Generate All End Gateways
gameplay.all_end_gateways
OffOn / OffAll twenty gateways round the island at once. They close while a dragon is called or fought, and open after.

Lives

SettingDefaultRangeWhat it does
Lives
lives.enabled
OnOn / OffPlayers have a number of lives; once the last is lost they come back as a ghost. Off: dying costs nothing.
Humans Get Life-Steal
lives.lifesteal
OffOn / OffGives the Life-Steal quirk to every Human (those already here and those who come): a player they kill gives them the life it took from that player. Off takes it from them again (unless an admin gave it).
Monsters Get Life-Steal
lives.lifesteal_monsters
OnOn / OffGives the Life-Steal quirk to every Monster while lives are on for them (those already here and those who come). Off takes it from them again (unless an admin gave it).
Human lives
lives.human
3 lives3 lives – 5 livesHow many lives a Human has: 3 or 5.
Humans: only PvP costs a life
lives.human_pvp_only
OnOn / OffA Human loses a life only when another player (or /kill) kills them. Off: any death costs a life.
Monsters have lives
lives.monsters
OffOn / OffMonsters have lives as Humans do. Off: Monsters have none, and never become ghosts by dying.
Monster lives
lives.monster
5 lives3 lives – 5 livesHow many lives a Monster has: 3 or 5 (with Monsters having lives on).
Monsters: only PvP costs a life
lives.monster_pvp_only
OnOn / OffA Monster loses a life only when another player (or /kill) kills them. Off: any death costs a life.
Monsters take Humans' lives
lives.monsters_take_lives
OffOn / OffA Human killed by a Monster player loses a life. Off: Monsters (who have no lives by default) take none.
Heart shows lives in chat
lives.heart_in_chat
OnOn / OffThe SOUL heart before a name in chat is as full as the player's lives, as the death screen shows it.
Heart shows lives in TAB
lives.heart_in_tab
OnOn / OffThe SOUL heart before a name in the TAB list is as full as the player's lives.
Heart shows lives on name tags
lives.heart_on_name_tag
OnOn / OffThe SOUL heart before the name over a player's head is as full as their lives.

Ghost

SettingDefaultRangeWhat it does
Ghost Mode
ghost.enabled
OnOn / OffPlayers out of lives become ghosts; /gamemode ghost and F3+F4 make anyone one. Off: spectator mode.
Ghost-voice filter
ghost.voice_filter
OnOn / OffGhosts may make their voice echoing and ghostly from their ghost menu. Off: nobody can.
New SOUL on revival
ghost.new_soul_on_revival
OffOn / OffA ghost brought back to life has to choose a new SOUL. (Reviving comes in a later version.)
Ghosts pass through walls
ghost.pass_through_walls
OnOn / OffGhosts go through walls, sideways only, as deep as set below. Off: walls stop them.
How deep into walls
ghost.wall_depth
6 blocks0 blocks – 16 blocksHow many blocks of wall a ghost can go through (0 to 16; click to type).
Short sight inside walls
ghost.blind_in_walls
OnOn / OffInside a wall a ghost only sees the blocks round them, so caves aren't given away; the way out still shows.
Follow in third person
ghost.third_person
OnOn / OffFollowing a player or mob (left-click) puts the camera behind them; F5 still changes it.
Ghost aura
ghost.aura
OnOn / OffGhosts give off specks in their SOUL's colour and in white, seen by everyone who can see the ghost.
Ghosts in TAB
ghost.show_in_tab
OnOn / OffGhosts in everyone's TAB list and voice chat lists. Off: only ghosts, operators and soulverse.ghost.see see them there.
Spectators in TAB
ghost.spectators_in_tab
OffOn / OffPlayers in spectator mode in everyone's TAB list. Off: only operators and soulverse.spectators.see see them.
Admins read ghost chat
ghost.admins_see_chat
OnOn / OffOperators and soulverse.ghost.see_chat read the ghosts' chat while alive. Off: only ghosts do.

Possession

SettingDefaultRangeWhat it does
Possession
possession.enabled
OnOn / OffGhosts can possess mobs (and players, if allowed) with the Possess key, E by default.
No time limit
possession.infinite
OffOn / OffPossessions last until the ghost lets go. Off: only soulverse.ghost.possess_infinite may do that.
No Cooldown
possession.no_cooldown
OffOn / OffGhosts can possess again straight after letting go: no wait between possessions, for mobs or players.
Magic circle
possession.circle
OnOn / OffA circle of runes in the ghost's SOUL colour under whatever is being possessed.
Possess bosses
possession.bosses
OffOn / OffGhosts can possess the Elder Guardian, the Warden, the Wither and the Ender Dragon.
Possess others' pets
possession.others_pets
OffOn / OffGhosts can possess tamed animals that belong to another player. Off: only their own and untamed ones.
Mob possession time
possession.mob_duration
150 s10 s – 600 sHow long a ghost can possess a mob before their hold fades (10 seconds to 10 minutes).
Mob possession wait
possession.mob_cooldown
15 min5 min – 60 minHow long a ghost has to wait before possessing a mob again (5 minutes to an hour).
Possess players
possession.players
OffOn / OffGhosts can possess players as well as mobs. A player's own setting in their page of this menu goes first.
Player possession time
possession.player_duration
60 s10 s – 600 sHow long a ghost can possess a player before their hold fades (10 seconds to 10 minutes).
Player possession wait
possession.player_cooldown
30 min5 min – 60 minHow long a ghost has to wait before possessing a player again (5 minutes to an hour).

SOULs

SettingDefaultRangeWhat it does
Love: wait to choose again
souls.love_cooldown
OnOn / OffA player a Love SOUL lets go of can only be their Loved One again after a wait. Off: no wait.
Love: hours to wait
souls.love_cooldown_hours
24 h1 h – 24 hHow long until a player let go of can be that Love SOUL's Loved One again.
Love: losses before Hatred
souls.hate_after
21 – 5How many Loved Ones (players) a Love SOUL must lose before, while Grieving, they may Relinquish into Hatred.
Love: grief for pets
souls.pet_grief
OnOn / OffLoved animals dying make Loving-Touch holders Grieve (half an hour) and count towards Hatred. Off: they don't.
Love: pets lost before Hatred
souls.hate_after_pets
51 – 10How many Loved animals a Loving-Touch holder must lose before, while Grieving, they may become Hate.

Quirks (Balance)

SettingDefaultRangeWhat it does
All Quirk Waits
quirks.all_waits_percent
100%10% – 500%Every quirk's waits and cooldowns, in per cent of their own settings. 100 = as set.
All Quirk Damage
quirks.all_damage_percent
100%10% – 500%How strongly quirks make blows harder or softer, and their own strikes, in per cent. 100 = as set.

Moderation

SettingDefaultRangeWhat it does
Muting for yourself
moderation.personal_mutes
OnOn / OffPlayers can mute others for themselves with /mute chat and /mute vc.
Tell players they're muted
moderation.announce_mutes
OnOn / OffPlayers are told when they are muted or unmuted, and for how long.
Join messages
moderation.join_messages
OnOn / OffChat says when a player joins the game.
Leave messages
moderation.leave_messages
OnOn / OffChat says when a player leaves the game.
Kick Freecam users
moderation.kick_freecam
OffOn / OffPlayers whose game has the Freecam mod are sent away. Freecam (Fair Play) is allowed.

Voice chat

SettingDefaultRangeWhat it does
Voice chat moderation
voice_chat.moderation
OnOn / OffMutes, deafening, volume and voice chat bans apply in Simple Voice Chat.

Expansions

SettingDefaultRangeWhat it does
Additional Souls (restart)
datapacks.additional_souls
OffOn / OffAdditional Souls datapack (14 more SOULs), on or off from the next restart. On by itself if the world has it.
Mythic Souls (restart)
datapacks.mythic
OffOn / OffThe Mythic Souls datapack (Omnipotent, Corrupted, Draconic; chosen only by allowed players), on from the next restart.

Trials

SettingDefaultRangeWhat it does
Trials on This Server
trials.enabled
OnOn / OffPlayers can earn the datapacks' trials: long feats that give a reward once every step is done. Off: nothing counts.
Paths per Group
trials.rewards_per_group
11 – 10How many trials of one group a player may finish. Finishing that many closes the group's others to them for good.

Hardcore worlds

A Hardcore world that has no Soulverse settings yet starts with lives on for everyone (Humans 3, Monsters 5). A world that already has settings keeps them.