Permissions

Registering a permission

Before you're able to use a permission for your plugin, you first need to register the permission so that you're able to assign it to players or groups. When registering there is one condition that always must be met, the start of the permission name must include the plugins exact name.

namespace Oxide.Plugins
{
    [Info("MyFirstPlugin", "Author Name", "1.0.0")]
    public class MyFirstPlugin : RustPlugin
    {
        void Init() => permission.RegisterPermission("myfirstplugin.use", this);
    }
}

Checking a player for a permission

To check if a player has a specific permission, you must first make sure the permission is registered, and both the registered permission and permission you're checking for are the same.

namespace Oxide.Plugins;

[Info("MyFirstPlugin", "Author Name", "1.0.0")]
public class MyFirstPlugin : RustPlugin
{
    void Init() => permission.RegisterPermission("myfirstplugin.use", this);

    [ChatCommand("hello")]
    private void HelloCommand(BasePlayer player, string command, string[] args)
    {
        if(!permission.UserHasPermission(player.UserIDString, "myfirstplugin.use"))
        {
            PrintToChat(player, "You don't have permission to use this command!");
            return;
        }

        PrintToChat(player, "Hello, you have permission to use this command!");
    }
}