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:
| Group | What'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:
| Node | What it does |
|---|---|
soulverse.ghost.see | See ghosts in TAB while "Ghosts in TAB" is off |
soulverse.spectators.see | See players in spectator mode (who aren't ghosts) in TAB, and as a ghost in the world |
soulverse.ghost.see_chat | Read ghost chat while alive, when "Admins read ghost chat" is on |
soulverse.freecam.allowed | Join with a Freecam mod while "Kick Freecam users" is on |
soulverse.reload | /sv reload |
soulverse.ghost.possess_infinite | Possess with no time limit. Only when given, ops don't have it |
soulverse.possession.immune | Can 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.viewand that setting's category. Someone with onlysoulverse.server.livescan't change lives, they can't even open the tab. - Applying a preset needs
soulverse.server.presetsplus the category of every setting the preset changes (andsoulverse.souls.editif 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.