🔐 Permissions

New to Permissions?

If you're wondering why permissions are needed and how to set them up, check out our Permissions Setup Tutorial which explains the basics and provides a step-by-step setup guide for beginners.

Here is a complete list of all plugin permissions:

Permission	Description	Default
`essentialsplus.list`	Allows use of `/list`	OP
`essentialsplus.home.self`	Allows use of `/home`	OP
`essentialsplus.sethome`	Allows use of `/sethome`	OP
`essentialsplus.sethome.limit.[number]`	Allow a maximum of homes	OP
`essentialsplus.sethome.limit.infinite`	Allow unlimeted homes	OP
`essentialsplus.homes`	Allows use of `/homes`	OP
`essentialsplus.delhome`	Allows use of `/delhome`	OP
`essentialsplus.warp`	Allows use of `/warp`	OP
`essentialsplus.setwarp`	Allows use of `/setwarp`	OP
`essentialsplus.warps`	Allows use of `/warps`	OP
`essentialsplus.warp.[warpname]`	Allows access to specific warp	OP
`essentialsplus.warp.*`	Allows access to all warps	OP
`essentialsplus.delwarp`	Allows use of `/delwarp`	OP
`essentialsplus.kit.self`	Allows use of `/kit`	OP
`essentialsplus.kit.[kitname]`	Allows claiming specific kit	OP
`essentialsplus.kit.other`	Allows use of `/kit [player] [name]`	OP
`essentialsplus.kit.all`	Allows use of `/kit all [name]`	OP
`essentialsplus.kitbypas.[kitname]`	Bypass cooldown for specific kit	OP
`essentialsplus.kitbypas.*`	Bypass cooldown for all kits	OP
`essentialsplus.kitcreate`	Allows use of `/kitcreate`	OP
`essentialsplus.kitdelete`	Allows use of `/kitdelete`	OP
`essentialsplus.kitlist`	Allows use of `/kitlist`	OP
`essentialsplus.msg`	Allows use of `/msg` and `/r`	OP
`essentialsplus.socialspy.self`	Allows use of `/socialspy`	OP
`essentialsplus.socialspy.bypass`	Messages not visible in SocialSpy	OP
`essentialsplus.tpa`	Allows use of `/tpa`	OP
`essentialsplus.tpahere`	Allows use of `/tpahere`	OP
`essentialsplus.tpaaccept`	Allows use of `/tpaaccept`	OP
`essentialsplus.tpadeny`	Allows use of `/tpadeny`	OP
`essentialsplus.tpahereall`	Allows use of `/tpahereall`	OP
`essentialsplus.mute`	Allows use of `/mute` and `/unmute`	OP
`essentialsplus.kick`	Base permission for `/kick` command	OP
`essentialsplus.kick.other`	Allows kicking individual players	OP
`essentialsplus.kick.all`	Allows use of `/kick all`	OP
`essentialsplus.kick.bypass`	Protects player from being kicked	OP
`essentialsplus.tempban`	Allows use of `/tempban` and `/untempban`	OP
`essentialsplus.ipban`	Allows use of `/ipban` and `/unipban`	OP
`essentialsplus.god.self`	Allows use of `/god`	OP
`essentialsplus.god.other`	Allows use of `/god [player]`	OP
`essentialsplus.heal.self`	Allows use of `/heal`	OP
`essentialsplus.heal.other`	Allows use of `/heal [player]`	OP
`essentialsplus.heal.all`	Allows use of `/heal all`	OP
`essentialsplus.freecam.self`	Allows use of `/freecam`	OP
`essentialsplus.freecam.other`	Allows use of `/freecam [player]`	OP
`essentialsplus.moonwalk.self`	Allows use of `/moonwalk`	OP
`essentialsplus.moonwalk.other`	Allows use of `/moonwalk [player]`	OP
`essentialsplus.adminchat`	Allows use of `/adminchat`	OP
`essentialsplus.broadcast`	Allows use of `/broadcast`	OP
`essentialsplus.top.self`	Allows use of `/top` on self	OP
`essentialsplus.top.other`	Allows use of `/top [player]`	OP
`essentialsplus.bottom.self`	Allows use of `/bottom` on self	OP
`essentialsplus.bottom.other`	Allows use of `/bottom [player]`	OP
`essentialsplus.back.self.last`	Allows use of `/back` (last location)	OP
`essentialsplus.back.self.home`	Allows use of `/back home`	OP
`essentialsplus.back.self.death`	Allows use of `/back death`	OP
`essentialsplus.back.self.spawn`	Allows use of `/back spawn`	OP
`essentialsplus.back.self.warp`	Allows use of `/back warp`	OP
`essentialsplus.back.self.tpa`	Allows use of `/back tpa`	OP
`essentialsplus.back.self.teleport`	Allows use of `/back teleport`	OP
`essentialsplus.back.other`	Allows use of `/back [player]`	OP
`essentialsplus.back.save.home`	Allow saving HOME locations	OP
`essentialsplus.back.save.death`	Allow saving DEATH locations	OP
`essentialsplus.back.save.spawn`	Allow saving SPAWN locations	OP
`essentialsplus.back.save.warp`	Allow saving WARP locations	OP
`essentialsplus.back.save.tpa`	Allow saving TPA locations	OP
`essentialsplus.back.save.teleport`	Allow saving TELEPORT locations	OP
`essentialsplus.back.save.world`	Allow saving WORLD locations	OP
`essentialsplus.back.save.back`	Allow saving BACK locations	OP
`essentialsplus.jumpto`	Allows use of `/jumpto`	OP
`essentialsplus.thru.self`	Allows use of `/thru`	OP
`essentialsplus.spawn.self`	Allows use of `/spawn` on self	OP
`essentialsplus.spawn.other`	Allows use of `/spawn [player]`	OP
`essentialsplus.spawn.all`	Allows use of `/spawn all`	OP
`essentialsplus.setspawn`	Allows use of `/setspawn`	OP
`essentialsplus.protection.bypass`	Bypass spawn protection restrictions	OP
`essentialsplus.whois`	Allows use of `/whois`	OP
`essentialsplus.ipinfo`	Allows use of `/ipinfo`	OP
`essentialsplus.seen`	Allows use of `/seen`	OP
`essentialsplus.near`	Allows use of `/near`	OP
`essentialsplus.clearchat.self`	Allows use of `/clearchat`	OP
`essentialsplus.clearchat.other`	Allows use of `/clearchat [player]`	OP
`essentialsplus.clearchat.all`	Allows use of `/clearchat all`	OP
`essentialsplus.clearinventory.self`	Allows use of `/clearinventory`	OP
`essentialsplus.clearinventory.other`	Allows use of `/clearinventory [player]`	OP
`essentialsplus.disposal`	Allows use of `/disposal`	OP
`essentialsplus.motd`	Allows use of `/motd`	OP
`essentialsplus.fly.self`	Allows use of `/fly` on yourself	OP
`essentialsplus.fly.other`	Allows use of `/fly [player]`	OP
`essentialsplus.more`	Allows use of `/more` to max own item	OP
`essentialsplus.more.other`	Allows use of `/more [player]`	OP
`essentialsplus.repair.self`	Allows use of `/repair` on self	OP
`essentialsplus.repair.other`	Allows use of `/repair [player]`	OP
`essentialsplus.repair.self.all`	Allows use of `/repair all` on self	OP
`essentialsplus.repair.other.all`	Allows use of `/repair all [player]`	OP
`essentialsplus.rtp`	Allows use of `/rtp`	OP
`essentialsplus.rtp.other`	Allows use of `/rtp [player]`	OP
`essentialsplus.rtp.customRadius`	Allows custom radius via --minRadius/--maxRadius	OP
`essentialsplus.rtp.minRadius.[value]`	Sets minimum radius (e.g., .minRadius.500)	OP
`essentialsplus.rtp.maxRadius.[value]`	Sets maximum radius (e.g., .maxRadius.10000)	OP
`essentialsplus.discord`	Allows use of `/discord`	OP
`essentialsplus.afk.self`	Allows use of `/afk` on self	OP
`essentialsplus.afk.other`	Allows use of `/afk [player]`	OP
`essentialsplus.afk.bypass.autoafktime`	Bypass automatic AFK detection	OP
`essentialsplus.afk.bypass.autokicktime`	Bypass automatic AFK kick	OP
`essentialsplus.rules`	Allows use of `/rules`	OP
`essentialsplus.vanish.self`	Allows use of `/vanish` on self	OP
`essentialsplus.vanish.other`	Allows use of `/vanish [player]`	OP
`essentialsplus.freeze.self`	Allows use of `/freeze` on self	OP
`essentialsplus.freeze.other`	Allows use of `/freeze [player]`	OP
`essentialsplus.freeze.all`	Allows use of `/freeze all`	OP
`essentialsplus.ignore.self`	Allows use of `/ignore`, `/ignore remove`, and `/ignore clear`	OP
`essentialsplus.ignore.bypass`	Cannot be ignored by other players	OP
`essentialsplus.ignore.silentmode`	Allows use of `--silent` parameter in `/ignore` command	OP
`essentialsplus.ignore.list.self`	Allows use of `/ignore list` to view own list	OP
`essentialsplus.ignore.list.others`	Allows use of `/ignore list [player]` to view others' lists	OP
`essentialsplus.money.view.self`	Allows use of `/money` to view own balance	OP
`essentialsplus.money.view.others`	Allows use of `/money [player]`	OP
`essentialsplus.money.send`	Allows use of `/pay` and `/money send`	OP
`essentialsplus.money.set`	Allows use of `/money set`	OP
`essentialsplus.money.add`	Allows use of `/money add`	OP
`essentialsplus.money.remove`	Allows use of `/money remove`	OP
`essentialsplus.money.top`	Allows use of `/money top`	OP
`essentialsplus.adminshop.use`	Base permission for admin shop	OP
`essentialsplus.adminshop.buy`	Allows use of `/adminshop buy`	OP
`essentialsplus.adminshop.sell`	Allows use of `/adminshop sell`	OP
`essentialsplus.adminshop.sellall`	Allows use of `/adminshop sellall`	OP
`essentialsplus.adminshop.admin`	Base permission for shop management	OP
`essentialsplus.adminshop.admin.add`	Allows use of `/adminshop add`	OP
`essentialsplus.adminshop.admin.remove`	Allows use of `/adminshop remove`	OP
`essentialsplus.adminshop.admin.list`	Allows use of `/adminshop list`	OP
`essentialsplus.mail`	Allows use of `/mail` (view inbox)	OP
`essentialsplus.mail.send`	Allows use of `/mail send` and `/mail reply`	OP
`essentialsplus.mail.sendall`	Allows use of `/mail sendall`	OP
`essentialsplus.mail.delete`	Allows use of `/mail delete`	OP
`essentialsplus.mail.clear`	Allows use of `/mail clear`	OP
`essentialsplus.reload`	Allows use of `/essentialsplus reload`	OP
`essentialsplus.migrate`	Allows use of migration commands	OP
`essentialsplus.announce`	Allows use of `/announce` (base command)	OP
`essentialsplus.announce.send.all`	Allows use of `/announce send`	OP
`essentialsplus.announce.add`	Allows use of `/announce add`	OP
`essentialsplus.announce.remove`	Allows use of `/announce remove`	OP
`essentialsplus.announce.list`	Allows use of `/announce list`	OP
`essentialsplus.announce.reload`	Allows use of `/announce reload`	OP
`essentialsplus.announce.toggle`	Allows use of `/announce toggle`	OP

Note: Commands without listed permission (/essentialsplus) are available to all players.

Enhanced Permission Systems

The Enhanced Permission System expands on the permissions listed in the table above. It allows you to access additional server functions. This includes, for example, enabling certain kits or warps for players. It also expands on the so-called Command Interceptions, which allow you to set cooldowns, warmups, and prices for all commands, if you wish.

Kit Cooldown Bypass:

Grant essentialsplus.kitbypas.[kitname] to bypass cooldown for a specific kit (e.g., essentialsplus.kitbypas.bonus for the kit bonus)
Grant essentialsplus.kitbypas.* to bypass cooldowns for all kits
Useful for VIP ranks or donator perks

Warp Access Control:

Grant essentialsplus.warp.[warpname] to allow access to a specific warp (e.g., essentialsplus.warp.mining for the warp mining)
Grant essentialsplus.warp.* to allow access to all warps
Players need both essentialsplus.warp AND the specific warp permission
Useful for VIP warps or restricted areas

Sethome Limits:

Permission System Compatibility

This feature require support from your permission system. The following systems have been tested and are fully functional:

Hytale's built-in permission system
LuckPerms
HyperPerms

Other permission systems may work but have not been verified.

Configuration Required

To use home limits, you must enable them in config.json:

json

"homes": {
  "limitsEnabled": true
}

Important Note for Admins

If you have the admin wildcard permission (*), you automatically receive all .infinite permissions.

Grant essentialsplus.sethome.limit.[number] to set a maximum number of homes (e.g., essentialsplus.sethome.limit.limit.3 for 3 homes)
Grant essentialsplus.sethome.limit.infinite to allow unlimited homes
Players need the base essentialsplus.sethome permission AND a limit permission
The highest limit permission takes precedence if a player has multiple
Useful for tiered VIP ranks (Basic: 5 homes, VIP: 10 homes, Premium: unlimited)

Command Interceptions:

Permission System Compatibility

These reduction features require support from your permission system. The following systems have been tested and are fully functional:

Hytale's built-in permission system
LuckPerms
HyperPerms

Other permission systems may work but have not been verified.

Important Note for Admins

If you have the admin wildcard permission (*), you automatically receive all .infinite permissions.

All Essentialsplus commands can be extended by CommandInterceptions
The Interceptions can in turn be modified via Permissions in order to reduce them for certain players
All CommandInterception settings are optional
Cooldown Reduction:
- essentialsplus.[command].reduce.cooldown.[time] - Reduce cooldown by time (e.g., 10s, 5m)
- essentialsplus.[command].reduce.cooldown.infinite - Bypass cooldown completely
Warmup Reduction:
- essentialsplus.[command].reduce.warmup.[time] - Reduce warmup by time
- essentialsplus.[command].reduce.warmup.infinite - Bypass warmup completely
Price Reduction:
- essentialsplus.[command].reduce.price.[amount] - Reduce price by amount (e.g., 10, 50)
- essentialsplus.[command].reduce.price.infinite - No cost for command execution
Example: Grant essentialsplus.home.reduce.cooldown.30s to VIP players to reduce home cooldown by 30 seconds
Example: Grant essentialsplus.home.reduce.price.5 to VIP players to reduce home price by 5$
commandInterceptions are defined in the config.json.
More information about command Interceptions => Configuration

Custom Commands:

Every custom command automatically gets permission: essentialsplus.customcommands.[name]
Example: Command /gmc requires permission essentialsplus.customcommands.gmc
Aliases use the same permission as the main command
Players need this permission to execute the custom command
Use essentialsplus.customcommands.* to grant access to all custom commands
customCommands are defined in the config.json.

Permissions Setup Tutorial

Setup Guide

Step 1 of 3 - ← Back to Installation | Next: Configure Settings →

Why are Permissions Important?

By default, all EssentialsPlus commands require OP (operator) status. Without proper permission setup:

Regular players won't be able to use basic commands like /home, /tpa, or /warp
You would need to give everyone OP status, which is a security risk
You can't create different player ranks (VIP, Moderator, Admin, etc.)

Quick Setup Guide

For Beginners: Start with Hytale's built-in permission system

Stop your server (important!)
Edit the permissions.json file in your main server directory
Use the Example Configuration below as a starting point
Assign groups to players and grant permissions
Restart your server

For Advanced Users: Consider using LuckPerms or another permissions mod.

More powerful group management
In-game commands to manage permissions
Web editor for easy configuration
No server restart needed for changes

Example Permission Configuration

In general, any permission system can be used to grant rights to players. This example shows the contents of the permissions.json file from the main server directory using Hytale's own permissions system.

Tutorial

For a detailed step-by-step guide on configuring permissions, see the Chat Formatting Tutorial in the Tutorials section.

Important

The permissions.json file can only be edited when the server is stopped. Changes made while the server is running will be overwritten and reset when the server shuts down.

json

{
  "users": {
    "e4f5c3c3-57ea-43b3-aa15-7ea78c6bce75": {
      "groups": [
        "Adventure"
      ]
    },
    "5db52eec-7220-4161-be23-3bcba14d7bc8": {
      "groups": [
        "Adventure"
      ]
    },
    "79f4de26-a0a0-42ce-903e-581716430dcd": {
      "groups": [
        "VIP",
        "Adventure"
      ]
    },
    "cd590768-3885-41f1-99de-e718d9eaa00f": {
      "groups": [
        "Moderator",
        "VIP",
        "Adventure"
      ]
    },
    "c3f13aae-432d-4627-9892-e8901144c63b": {
      "groups": [
        "OP",
        "Adventure"
      ]
    }
  },
  "groups": {
    "Default": [],
    "Moderator": [
      "essentialsplus.adminchat",
      "essentialsplus.back.other",
      "essentialsplus.broadcast",
      "essentialsplus.clearchat.other"
      "essentialsplus.clearchat.self",
      "essentialsplus.freeze.other",
      "essentialsplus.ipinfo",
      "essentialsplus.mute",
      "essentialsplus.seen",
      "essentialsplus.spawn.other",
      "essentialsplus.tempban",
      "essentialsplus.top.other",
      "essentialsplus.vanish.self",
      "essentialsplus.whois",
    ],
    "OP": [
      "*"
    ],
    "Adventure": [
      "essentialsplus.back.save.death",
      "essentialsplus.back.save.spawn",
      "essentialsplus.back.self.death",
      "essentialsplus.back.self.spawn",
      "essentialsplus.back.self",
      "essentialsplus.delhome",
      "essentialsplus.discord",
      "essentialsplus.home.self",
      "essentialsplus.homes"
      "essentialsplus.kit.self",
      "essentialsplus.kit.starter",
      "essentialsplus.kitlist",
      "essentialsplus.list",
      "essentialsplus.motd",
      "essentialsplus.msg",
      "essentialsplus.near",
      "essentialsplus.rules",
      "essentialsplus.sethome.limit.3",
      "essentialsplus.sethome",
      "essentialsplus.spawn.self",
      "essentialsplus.tpa",
      "essentialsplus.tpaaccept",
      "essentialsplus.tpadeny",
      "essentialsplus.tpahere",
      "essentialsplus.warp",
    ],
    "VIP": [
      "essentialsplus.back.save.home",
      "essentialsplus.back.save.tpa"
      "essentialsplus.back.save.warp",
      "essentialsplus.back.self.home",
      "essentialsplus.back.self.tpa",
      "essentialsplus.back.self.warp",
      "essentialsplus.back.self",
      "essentialsplus.clearinventory.self",
      "essentialsplus.disposal",
      "essentialsplus.fly.self",
      "essentialsplus.kit.vip",
      "essentialsplus.rtp",
      "essentialsplus.sethome.limit.10",
      "essentialsplus.top.self",
    ]
  }
}

⚙️ Configuration

🎓 Tutorials

🔐 Permissions

Enhanced Permission Systems

Permissions Setup Tutorial

Why are Permissions Important?

Quick Setup Guide

Example Permission Configuration

🔐 Permissions ​

Enhanced Permission Systems ​

Permissions Setup Tutorial ​

Why are Permissions Important? ​

Quick Setup Guide ​

Example Permission Configuration ​

🔐 Permissions

Enhanced Permission Systems

Permissions Setup Tutorial

Why are Permissions Important?

Quick Setup Guide

Example Permission Configuration