PERMISSIONS

Every part of the SV menu and every Soulverse command has its own permission node, soulverse.<something>. They're checked through Fabric's permission API, so LuckPerms (or any permission mod that hooks into it) can give or take each one.

Without a permission mod

  • Operators (level 2 and up) have everything, apart from two nodes that are only ever given on purpose (see below).
  • Everyone else can open /sv (soulverse.menu) and mute people for themselves (soulverse.mute). The rest of the menu shows up greyed out with "You don't have permission for this".

For a small server with a couple of trusted ops that's usually all you need.

How the nodes are grouped

The dots make groups, so a wildcard gives a whole group at once:

GroupWhat's in it
soulverse.server.*The Server tab: view, one node per category (creation, names, gameplay, expansions, souls, lives, quirks, moderation, voice_chat, ghost, possession) and presets
soulverse.players.*The Players tab and each player's page: inventories, moderation, lives, SOULs, mutes, voice, teleports, logs and more
soulverse.players.inventory.*Just the inventory parts: view, enderchest, edit
soulverse.souls.*The SOULs tab: view, edit
soulverse.quirks.*The Quirks tab: view, assign
soulverse.trials.*The Trials tab: view, edit
soulverse.modconfigs.*Mod Configs: view, edit

A few nodes aren't about the menu but about how the game treats someone:

NodeWhat it does
soulverse.ghost.seeSee ghosts in TAB while "Ghosts in TAB" is off
soulverse.spectators.seeSee players in spectator mode (who aren't ghosts) in TAB, and as a ghost in the world
soulverse.ghost.see_chatRead ghost chat while alive, when "Admins read ghost chat" is on
soulverse.freecam.allowedJoin with a Freecam mod while "Kick Freecam users" is on
soulverse.reload/sv reload
soulverse.ghost.possess_infinitePossess with no time limit. Only when given, ops don't have it
soulverse.possession.immuneCan never be possessed. Only when given, ops don't have it

The full list with what each one allows is on the permissions page.

Two things that trip people up

  • Changing a Server tab setting needs two nodes: soulverse.server.view and that setting's category. Someone with only soulverse.server.lives can't change lives, they can't even open the tab.
  • Applying a preset needs soulverse.server.presets plus the category of every setting the preset changes (and soulverse.souls.edit if it changes a SOUL's mode). Missing one greys out Apply and says which.

LuckPerms examples

Ops keep everything unless you set a node to false, so with LuckPerms you usually build groups for staff who aren't ops.

A helper who can look people up, read their logs and mute:

/lp creategroup helper
/lp group helper permission set soulverse.players.view true
/lp group helper permission set soulverse.players.page true
/lp group helper permission set soulverse.players.log true
/lp group helper permission set soulverse.players.mute true
/lp group helper permission set soulverse.ghost.see_chat true

A moderator who handles people:

/lp creategroup moderator
/lp group moderator parent add helper
/lp group moderator permission set soulverse.players.moderation true
/lp group moderator permission set soulverse.players.deafen true
/lp group moderator permission set soulverse.players.voice true
/lp group moderator permission set soulverse.players.spectate true
/lp group moderator permission set soulverse.players.tp true
/lp group moderator permission set soulverse.players.tp_offline true
/lp group moderator permission set soulverse.players.inventory.view true
/lp group moderator permission set soulverse.players.inventory.enderchest true
/lp group moderator permission set soulverse.freecam.allowed true
/lp group moderator permission set soulverse.spectators.see true

Leave soulverse.players.inventory.edit off for moderators: they can look into inventories (read-only), but can't take anything.

An admin who runs the server:

/lp creategroup admin
/lp group admin parent add moderator
/lp group admin permission set soulverse.players.* true
/lp group admin permission set soulverse.server.* true
/lp group admin permission set soulverse.souls.* true
/lp group admin permission set soulverse.quirks.* true
/lp group admin permission set soulverse.trials.* true
/lp group admin permission set soulverse.modconfigs.* true
/lp group admin permission set soulverse.reload true

The owner can have the lot:

/lp group owner permission set soulverse.* true

Careful with soulverse.*: in LuckPerms it also covers the two "only when given" nodes, so the owner would possess forever and never be possessed. If you don't want that:

/lp group owner permission set soulverse.ghost.possess_infinite false
/lp group owner permission set soulverse.possession.immune false

Taking something away from an op

Set the node to false for that player:

/lp user Steve permission set soulverse.players.inventory.edit false

Hiding the menu from players

Players can open /sv by default, though they can't do much there. To take it away:

/lp group default permission set soulverse.menu false

Keep soulverse.mute if you want players to still be able to mute others for themselves.

Checking what someone has

/lp user Steve permission check soulverse.server.view

If a button is greyed out in the menu, that's almost always a missing node. The menu and the server check the same thing, so a greyed-out option is also refused if someone tries the command instead.