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.
| Preset | What it is for | What it sets |
|---|---|---|
Casualcasual | 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 |
Hardcorehardcore | 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 |
PvPpvp | 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
| Setting | Default | Range | What it does |
|---|---|---|---|
Make a character on joiningcreation.prompt_on_join | On | On / Off | New players are taken to character creation when they first join. |
Allow Monsterscreation.allow_monsters | On | On / Off | Whether new characters can be Monsters. |
Allow a Random SOULcreation.allow_random_soul | On | On / Off | Whether new characters can leave their SOUL to chance. |
Allow a new lookcreation.allow_custom_look | On | On / Off | Whether new characters can put together a new look, or only keep their own skin. |
Unique namescreation.unique_names | On | On / Off | No two characters can have the same name (or another player's username). |
Award OGcreation.og | On | On / Off | The first player to choose each SOUL themselves (not left to fate) gets OG. |
Smallest sizecreation.min_size | 90% | 90% – 110% | How small new characters can be, in percent. |
Largest sizecreation.max_size | 110% | 90% – 110% | How large new characters can be, in percent. |
Names
| Setting | Default | Range | What it does |
|---|---|---|---|
Show chosen namesnames.use_chosen_names | On | On / Off | Characters' names are shown in chat, the tab list and on name tags instead of usernames. |
SOUL hearts beside namesnames.soul_colored_names | On | On / Off | A heart in each player's SOUL colour before their name in chat, TAB and on name tags. Names stay white. |
Vanilla chat formattingnames.vanilla_chat_formatting | Off | On / Off | Chat as Minecraft writes it (<name> message) for everyone. Off: name » message, the message in light grey. |
Profanity Filternames.profanity_filter | Off | On / Off | Slurs and the worst people's names can't be character names (chat is left alone). List: profanity-filter.txt |
Shortest Namenames.min_length | 3 letters | 1 letters – 16 letters | The fewest letters a character's name may have when it is chosen. Names chosen before stay as they are. |
Gameplay
| Setting | Default | Range | What it does |
|---|---|---|---|
Frisk's Hard Modegameplay.frisk_hard_mode | On | On / Off | A character named Frisk plays in Hard Mode, as in Undertale. |
No Mace Enchantmentsgameplay.no_mace_enchants | Off | On / Off | Maces can't be enchanted at the enchanting table or with books on an anvil. Enchanted ones keep theirs. |
No Netherite Toolsgameplay.no_netherite_tools | Off | On / Off | Diamond pickaxes, axes, shovels and hoes can't be upgraded to netherite at a smithing table. Ones made already stay. |
No Netherite Weaponsgameplay.no_netherite_weapons | Off | On / Off | Diamond swords and spears can't be upgraded to netherite at a smithing table. Ones made already stay. |
No Netherite Armorgameplay.no_netherite_armor | Off | On / Off | Diamond armor can't be upgraded to netherite at a smithing table. Pieces made already stay. |
No Diamond Toolsgameplay.no_diamond_tools | Off | On / Off | Diamond pickaxes, axes, shovels and hoes can't be crafted, in a crafting table or a crafter. Ones made already stay. |
No Diamond Weaponsgameplay.no_diamond_weapons | Off | On / Off | Diamond swords and spears can't be crafted, in a crafting table or a crafter. Ones made already stay. |
No Diamond Armorgameplay.no_diamond_armor | Off | On / Off | Diamond armor can't be crafted, in a crafting table or a crafter. Pieces made already stay. |
No Enchanting Tablegameplay.no_enchanting_table | Off | On / Off | Enchanting tables offer no enchantments. Things enchanted already keep theirs; anvils and books are not affected. |
No Nether Portal Buildinggameplay.no_nether_portal_creation | Off | On / Off | No 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 Buildinggameplay.no_end_portal_creation | Off | On / Off | The last eye of ender doesn't open an end portal. Existing portals still work. |
Nether Portals Closedgameplay.no_nether_portal_entry | Off | On / Off | Existing nether portals don't take anyone into the Nether (the way back still works). Building them is its own switch. |
End Portals Closedgameplay.no_end_portal_entry | Off | On / Off | Existing end portals don't take anyone into the End (the way back still works). Building them is its own switch. |
No Elytragameplay.no_elytra | Off | On / Off | Elytras can't be worn, in armour slots or in other mods' slots, and nobody can glide. Worn ones come off. |
Disable Early Dragon Fightgameplay.no_early_dragon_fight | Off | On / Off | No 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 Fightgameplay.manual_dragon_fight | On | On / Off | End crystals on the exit portal call the dragon, as when fighting it again. The first one leaves the egg. |
Generate All End Gatewaysgameplay.all_end_gateways | Off | On / Off | All twenty gateways round the island at once. They close while a dragon is called or fought, and open after. |
Lives
| Setting | Default | Range | What it does |
|---|---|---|---|
Liveslives.enabled | On | On / Off | Players have a number of lives; once the last is lost they come back as a ghost. Off: dying costs nothing. |
Humans Get Life-Steallives.lifesteal | Off | On / Off | Gives 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-Steallives.lifesteal_monsters | On | On / Off | Gives 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 liveslives.human | 3 lives | 3 lives – 5 lives | How many lives a Human has: 3 or 5. |
Humans: only PvP costs a lifelives.human_pvp_only | On | On / Off | A Human loses a life only when another player (or /kill) kills them. Off: any death costs a life. |
Monsters have liveslives.monsters | Off | On / Off | Monsters have lives as Humans do. Off: Monsters have none, and never become ghosts by dying. |
Monster liveslives.monster | 5 lives | 3 lives – 5 lives | How many lives a Monster has: 3 or 5 (with Monsters having lives on). |
Monsters: only PvP costs a lifelives.monster_pvp_only | On | On / Off | A Monster loses a life only when another player (or /kill) kills them. Off: any death costs a life. |
Monsters take Humans' liveslives.monsters_take_lives | Off | On / Off | A Human killed by a Monster player loses a life. Off: Monsters (who have no lives by default) take none. |
Heart shows lives in chatlives.heart_in_chat | On | On / Off | The 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 TABlives.heart_in_tab | On | On / Off | The SOUL heart before a name in the TAB list is as full as the player's lives. |
Heart shows lives on name tagslives.heart_on_name_tag | On | On / Off | The SOUL heart before the name over a player's head is as full as their lives. |
Ghost
| Setting | Default | Range | What it does |
|---|---|---|---|
Ghost Modeghost.enabled | On | On / Off | Players out of lives become ghosts; /gamemode ghost and F3+F4 make anyone one. Off: spectator mode. |
Ghost-voice filterghost.voice_filter | On | On / Off | Ghosts may make their voice echoing and ghostly from their ghost menu. Off: nobody can. |
New SOUL on revivalghost.new_soul_on_revival | Off | On / Off | A ghost brought back to life has to choose a new SOUL. (Reviving comes in a later version.) |
Ghosts pass through wallsghost.pass_through_walls | On | On / Off | Ghosts go through walls, sideways only, as deep as set below. Off: walls stop them. |
How deep into wallsghost.wall_depth | 6 blocks | 0 blocks – 16 blocks | How many blocks of wall a ghost can go through (0 to 16; click to type). |
Short sight inside wallsghost.blind_in_walls | On | On / Off | Inside a wall a ghost only sees the blocks round them, so caves aren't given away; the way out still shows. |
Follow in third personghost.third_person | On | On / Off | Following a player or mob (left-click) puts the camera behind them; F5 still changes it. |
Ghost auraghost.aura | On | On / Off | Ghosts give off specks in their SOUL's colour and in white, seen by everyone who can see the ghost. |
Ghosts in TABghost.show_in_tab | On | On / Off | Ghosts in everyone's TAB list and voice chat lists. Off: only ghosts, operators and soulverse.ghost.see see them there. |
Spectators in TABghost.spectators_in_tab | Off | On / Off | Players in spectator mode in everyone's TAB list. Off: only operators and soulverse.spectators.see see them. |
Admins read ghost chatghost.admins_see_chat | On | On / Off | Operators and soulverse.ghost.see_chat read the ghosts' chat while alive. Off: only ghosts do. |
Possession
| Setting | Default | Range | What it does |
|---|---|---|---|
Possessionpossession.enabled | On | On / Off | Ghosts can possess mobs (and players, if allowed) with the Possess key, E by default. |
No time limitpossession.infinite | Off | On / Off | Possessions last until the ghost lets go. Off: only soulverse.ghost.possess_infinite may do that. |
No Cooldownpossession.no_cooldown | Off | On / Off | Ghosts can possess again straight after letting go: no wait between possessions, for mobs or players. |
Magic circlepossession.circle | On | On / Off | A circle of runes in the ghost's SOUL colour under whatever is being possessed. |
Possess bossespossession.bosses | Off | On / Off | Ghosts can possess the Elder Guardian, the Warden, the Wither and the Ender Dragon. |
Possess others' petspossession.others_pets | Off | On / Off | Ghosts can possess tamed animals that belong to another player. Off: only their own and untamed ones. |
Mob possession timepossession.mob_duration | 150 s | 10 s – 600 s | How long a ghost can possess a mob before their hold fades (10 seconds to 10 minutes). |
Mob possession waitpossession.mob_cooldown | 15 min | 5 min – 60 min | How long a ghost has to wait before possessing a mob again (5 minutes to an hour). |
Possess playerspossession.players | Off | On / Off | Ghosts can possess players as well as mobs. A player's own setting in their page of this menu goes first. |
Player possession timepossession.player_duration | 60 s | 10 s – 600 s | How long a ghost can possess a player before their hold fades (10 seconds to 10 minutes). |
Player possession waitpossession.player_cooldown | 30 min | 5 min – 60 min | How long a ghost has to wait before possessing a player again (5 minutes to an hour). |
SOULs
| Setting | Default | Range | What it does |
|---|---|---|---|
Love: wait to choose againsouls.love_cooldown | On | On / Off | A player a Love SOUL lets go of can only be their Loved One again after a wait. Off: no wait. |
Love: hours to waitsouls.love_cooldown_hours | 24 h | 1 h – 24 h | How long until a player let go of can be that Love SOUL's Loved One again. |
Love: losses before Hatredsouls.hate_after | 2 | 1 – 5 | How many Loved Ones (players) a Love SOUL must lose before, while Grieving, they may Relinquish into Hatred. |
Love: grief for petssouls.pet_grief | On | On / Off | Loved animals dying make Loving-Touch holders Grieve (half an hour) and count towards Hatred. Off: they don't. |
Love: pets lost before Hatredsouls.hate_after_pets | 5 | 1 – 10 | How many Loved animals a Loving-Touch holder must lose before, while Grieving, they may become Hate. |
Quirks (Balance)
| Setting | Default | Range | What it does |
|---|---|---|---|
All Quirk Waitsquirks.all_waits_percent | 100% | 10% – 500% | Every quirk's waits and cooldowns, in per cent of their own settings. 100 = as set. |
All Quirk Damagequirks.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
| Setting | Default | Range | What it does |
|---|---|---|---|
Muting for yourselfmoderation.personal_mutes | On | On / Off | Players can mute others for themselves with /mute chat and /mute vc. |
Tell players they're mutedmoderation.announce_mutes | On | On / Off | Players are told when they are muted or unmuted, and for how long. |
Join messagesmoderation.join_messages | On | On / Off | Chat says when a player joins the game. |
Leave messagesmoderation.leave_messages | On | On / Off | Chat says when a player leaves the game. |
Kick Freecam usersmoderation.kick_freecam | Off | On / Off | Players whose game has the Freecam mod are sent away. Freecam (Fair Play) is allowed. |
Voice chat
| Setting | Default | Range | What it does |
|---|---|---|---|
Voice chat moderationvoice_chat.moderation | On | On / Off | Mutes, deafening, volume and voice chat bans apply in Simple Voice Chat. |
Expansions
| Setting | Default | Range | What it does |
|---|---|---|---|
Additional Souls (restart)datapacks.additional_souls | Off | On / Off | Additional 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 | Off | On / Off | The Mythic Souls datapack (Omnipotent, Corrupted, Draconic; chosen only by allowed players), on from the next restart. |
Trials
| Setting | Default | Range | What it does |
|---|---|---|---|
Trials on This Servertrials.enabled | On | On / Off | Players can earn the datapacks' trials: long feats that give a reward once every step is done. Off: nothing counts. |
Paths per Grouptrials.rewards_per_group | 1 | 1 – 10 | How 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.