Universal Perms

Universal Perms

Have you ever had to install mod that doesn’t provide permission nodes for its commands on a server?
Have you had trouble with a mod not allowing you to block access to their root command (looking at you luckperms)?
Well, this mod fixes that, and more.

Usage

First, you’ll need to install another mod to manage permissions for you. I recommend luckperms, but player roles should work just as well.
Before you start using this mod, I recommend logging in once so that luckperms gets to know all the nodes, so you can see them in the web editor.

Now we get to setting up the permissions. This mod provides two permissions for each command, one beginning with universal_perms:use/ and one with universal_perms:view/.

If set, the use permissions overrides the commands normal requirements making anyone with it set to true able to use the command while denying access to anyone with it set to false.
The view permissions is useful if you just want to hide the autocompletion, but still allow functionality for macros or something else.

For all vanilla commands (yes, even execute), subcommands and arguments are visible as their own sub-nodes, for example, to disable the use of /help <command>, but not /help you would use the universal_perms:use/help.command node. However, this doesn’t work with mods that use their own subcommand system (why luckperms?).

You can even affect all commands by using universal_perms:use and universal_perms:view as permission nodes, but I don’t really see the benefit in that.

Misc Permissions

This mod also adds some permission nodes for things that aren’t commands, but still use permission checks.

• (before 26.2) universal_perms.misc.selector allows the use of selectors like @a and @e. In vanilla this requires permission level 2. (after 26.2, this is now added by Minecraft as minecraft:commands/entity_selectors)
• universal_perms:misc/query_block_nbt allows clients to query some block data from the server when using F3 + I. In vanilla this requires permission level 2
• universal_perms:misc/query_entity_nbt is the same as above but for entities
• universal_perms:misc/update_difficulty allows changing the difficulty in the pause menu.
• universal_perms:misc/update_difficulty_lock allows changing the difficulty lock status, defaults to universal_perms:misc/update_difficulty
• universal_perms:misc/use_admin_blocks allows minecrafts isCreativeLevelTwoOp check to pass if the player is in creative mode. This is mostly used for admin tools like command blocks and debug sticks
• (1.21.11+) universal_perms:misc/gamemode_switcher causes the server to accept gamemode switching by players. The client must additionally be made aware of this power through a mod or raised permission level.

There’s also a universal_perms:misc/forced_permission_level meta permission that can be set to give a player a vanilla permission level.
Permission levels are used as defaults for all checks this mod adds. They are also sent to the client and are checked there for certain features like the gamemode switcher
They should cover all permissions checks that aren’t already covered.

Note on permission syntax

With the introduction of a permissions api into Fabric API, the syntax of UniversalPerms permissions has changed.
All permission nodes are now in the form of identifiers, as use elsewhere in Minecraft.
This change occurred during the 26.2 update. On versions before that, replace the : and / in all permission nodes with a ..

Also note that LuckPerms interprets identifier permission names somewhat weirdly: LuckPerms replaces the : with a ..
This means that for example universal_perms:use/help becomes universal_perms.use/help.

Pitfalls and Quirks

1. The view permission has power over the use one when it comes to sending the client the available commands. This means that you can create scenarios where a command is visible, but unusable.
2. Commands that are aliases to other commands behave weirdly when their target is forbidden/hidden, but they are visible. Here is a list of vanilla aliases to watch out for:

• tell and w redirect to msg
• tp redirects to teleport
• xp redirects to experiance
• tm redirects to teammsg

1. Compatibility with other mods isn’t guaranteed if the other mods add their commands later than usual or mess with their requirements after universal perms does.
2. Many of the misc permissions don’t work without modifications to the client, or higher reported permission levels.