Permissions
Rank setup reference for default player access, admin tools, bypass nodes, limits, shops, auction house, stats, leaderboards, and holograms.
Table of Contents
Jump to a section
Overview
What it is, features, and goals
›
Installation
Install steps + recommended setup
›
Commands
Command list + examples
›
Permissions
Permission nodes and rank setup
›
Configurations
Config options and details
›
Tutorials
Common setups and how-to guides
›
Author & Support
Contact, bugs, feedback, links
›
Try: default, auctionhouse, listings, exempt, hologram, scoreboard, sethome.max, cooldown, staff
Tip: search "cooldown", "tpa", "warp", "mute", "custom."
Copy buttons use your clipboard
Rank-ready
Copy buttons
Limit nodes included
Permission setup without guessing.
HyEssentialsX supports both simple operator-style fallback permissions and full rank-based permission setups.
If usePermissionsSystem is enabled, assign the nodes below through your permission plugin.
Recommended Starting Groups
Use these as a practical baseline, then add or remove features per server.
Default
Homes, warps, spawn, kits, private messages, mail, pay, balance, baltop, TPA, back, rules, playtime, rankup, trash, shops, and auction listing.
VIP / Supporter
Higher home limits, per-kit gates, kit cooldown bypasses, paycheck amount nodes, more auction listings, and longer auction durations.
Staff / Admin
Moderation, inventory tools, vanish, staff lookup, economy admin, shop admin, auction NPCs, scoreboard editor, holograms, world border, and config reloads.
Default Player Access
Common player permissions. When usePermissionsSystem is disabled, these are treated as player-safe defaults by the plugin.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.help
Copy
|
Root help command. | Player | /hyessentialsx help. |
hyessentialsx.info
Copy
|
Plugin info command. | Player | /hyessentialsx info. |
hyessentialsx.language
Copy
|
Player language command. | Player | Per-player language selection. |
hyessentialsx.spawn
Copy
|
Use /spawn. | Player | |
hyessentialsx.sethome
Copy
|
Use /sethome. | Player | Pair with hyessentialsx.sethome.max.<number> for limits. |
hyessentialsx.home
Copy
|
Use /home. | Player | |
hyessentialsx.homes
Copy
|
Use /homes. | Player | |
hyessentialsx.delhome
Copy
|
Use /delhome. | Player | |
hyessentialsx.warp
Copy
|
Use /warp. | Player | Per-warp nodes can also be used. |
hyessentialsx.warps
Copy
|
Use /warps. | Player | |
hyessentialsx.kit
Copy
|
Claim kits or open kit UI. | Player | Pair with hyessentialsx.kit.<kitname> for per-kit gates. |
hyessentialsx.kits
Copy
|
Use /kits. | Player | |
hyessentialsx.msg
Copy
|
Use /msg and /r. | Player | Private messaging. |
hyessentialsx.ignore
Copy
|
Use /ignore and /unignore. | Player | |
hyessentialsx.mail
Copy
|
Use the mail system. | Player | Send, read, reply, delete, and clear mail. |
hyessentialsx.nick
Copy
|
Set or clear your own nickname. | Player | /nick <name|off>. |
hyessentialsx.nick.color
Copy
|
Use color codes in nicknames. | Rank perk | Formatting is still controlled separately. |
hyessentialsx.nick.format
Copy
|
Use formatting codes in nicknames. | Rank perk | Requires nickname support to be enabled. |
hyessentialsx.pay
Copy
|
Use /pay. | Player | Economy must be enabled. |
hyessentialsx.balance
Copy
|
View own balance. | Player | /money, /balance, /bal, /eco, /cash, /wallet. |
hyessentialsx.baltop
Copy
|
Open balance top UI. | Player | |
hyessentialsx.ecogui
Copy
|
Open player economy UI. | Player | |
hyessentialsx.tpa
Copy
|
Use /tpa. | Player | |
hyessentialsx.tpahere
Copy
|
Use /tpahere. | Player | |
hyessentialsx.tpaaccept
Copy
|
Accept TPA requests. | Player | |
hyessentialsx.tpadeny
Copy
|
Deny TPA requests. | Player | |
hyessentialsx.tpacancel
Copy
|
Cancel outgoing TPA requests. | Player | |
hyessentialsx.tpaignore
Copy
|
Ignore TPA requests. | Player | |
hyessentialsx.back
Copy
|
Use /back. | Player | Supports death/back locations. |
hyessentialsx.list
Copy
|
Use /list. | Player | Aliases include /online and /who. |
hyessentialsx.rules
Copy
|
Use /rules. | Player | |
hyessentialsx.motd
Copy
|
Use /motd. | Player | |
hyessentialsx.discord
Copy
|
Use /discord. | Player | |
hyessentialsx.near
Copy
|
Use /near. | Player | |
hyessentialsx.afk
Copy
|
Use /afk. | Player | |
hyessentialsx.seen
Copy
|
Use /seen. | Player | |
hyessentialsx.playtime
Copy
|
View own playtime. | Player | /playtime and /pt. |
hyessentialsx.playtime.other
Copy
|
View another player's playtime. | Player | Default-access helper in plugin fallback mode. |
hyessentialsx.rankup
Copy
|
Use /rankup. | Player | Also used by rewards flow. |
hyessentialsx.rtp
Copy
|
Use /rtp. | Player | Only if RTP is enabled. |
hyessentialsx.trash
Copy
|
Open trash UI. | Player | |
hyessentialsx.scoreboard.move
Copy
|
Move own scoreboard. | Player | |
hyessentialsx.scoreboard.reset
Copy
|
Reset own scoreboard placement. | Player | |
hyessentialsx.scoreboard.show
Copy
|
Show own scoreboard. | Player | |
hyessentialsx.scoreboard.hide
Copy
|
Hide own scoreboard. | Player | |
hyessentialsx.adminshop.use
Copy
|
Open/use admin shops. | Player | Does not grant editing. |
hyessentialsx.playershop.use
Copy
|
Open player shop directory. | Player | |
hyessentialsx.playershop.create
Copy
|
Create player shops. | Player | Creation cost and limits still apply. |
hyessentialsx.playershop.delete
Copy
|
Delete owned player shops. | Player | |
hyessentialsx.auctionhouse.use
Copy
|
Open auction house UI. | Player | |
hyessentialsx.auctionhouse.sell
Copy
|
List items from the auction UI. | Player | Listing fee, max listings, and duration limits still apply. |
Economy, Auction, and Market Admin
Money controls, exclusion nodes, shops, auction house admin tools, and rank-based auction limits.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.ui
Copy
|
Open the staff command center. | Admin | /hexadmin, /hyadmin, /essadmin, /admincenter, /staffcenter, /hyessentialsx ui, and /ess admin. |
hyessentialsx.ui.playerdetails
Copy
|
View full selected-player details, staff notes, cases, and profile modules in the staff command center. | Staff | Without this or whois permission, sensitive profile details are limited. |
hyessentialsx.balance.others
Copy
|
View another player's balance. | Staff | |
hyessentialsx.money.set
Copy
|
Set a player's balance. | Admin | Also covered by hyessentialsx.money.admin. |
hyessentialsx.money.give
Copy
|
Give money to a player. | Admin | Also covered by hyessentialsx.money.admin. |
hyessentialsx.money.admin
Copy
|
Broad money admin permission. | Admin | Use for trusted economy admins. |
hyessentialsx.ecoadmin
Copy
|
Open admin economy dashboard. | Admin | |
hyessentialsx.baltop.exempt
Copy
|
Hide a player from /baltop. | Staff optional | Useful for devs/admins with test balances. |
hyessentialsx.adminshop.admin
Copy
|
Create, move, delete, and manage admin shops. | Admin | |
hyessentialsx.adminshop.npc
Copy
|
Legacy/admin NPC shop permission path. | Admin | Kept for compatibility with older permission setups. |
hyessentialsx.shop
Copy
|
Legacy shop use permission. | Player compat | Prefer current admin/player shop nodes for new setups. |
hyessentialsx.shop.admin
Copy
|
Legacy admin shop permission. | Admin compat | |
hyessentialsx.playershop
Copy
|
Legacy player shop permission. | Player compat | Prefer hyessentialsx.playershop.use. |
hyessentialsx.playershop.admin
Copy
|
Administer player shops and bypass ownership where supported. | Admin | |
hyessentialsx.playershop.npc
Copy
|
Legacy/admin player-shop NPC permission path. | Admin | Compatibility node. |
hyessentialsx.auctionhouse.admin
Copy
|
Create/remove/list auction house NPCs and use admin AH tools. | Admin | NPC placement and moving are admin-only. |
hyessentialsx.auctionhouse.listings.<number>
Copy
|
Raise max active auction listings for a rank. | Rank limit | Example: hyessentialsx.auctionhouse.listings.25. |
hyessentialsx.auctionhouse.listings.unlimited
Copy
|
No auction listing count limit. | Trusted/admin | |
hyessentialsx.auctionhouse.duration.<hours>
Copy
|
Raise max auction listing duration for a rank. | Rank limit | Example: hyessentialsx.auctionhouse.duration.72. |
hyessentialsx.auctionhouse.duration.unlimited
Copy
|
No listing duration limit. | Trusted/admin |
Travel, Teleport, and World Admin
Staff teleport powers, warp/spawn administration, world border, and time/sleep controls.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.setspawn
Copy
|
Use /setspawn. | Admin | |
hyessentialsx.delspawn
Copy
|
Use /delspawn. | Admin | |
hyessentialsx.spawnroute
Copy
|
List and modify flexible spawn routing. | Admin | /spawnroute mode, firstjoin, death, world, group, groupdel, and order. |
hyessentialsx.spawn.<name>
Copy
|
Resolve a named spawn for players through permission spawn routing. | Rank route | Create the target with /setspawn <name>. |
hyessentialsx.spawn.other
Copy
|
Teleport another player to spawn. | Staff | |
hyessentialsx.spawn.all
Copy
|
Teleport all players to spawn. | Admin | |
hyessentialsx.home.other
Copy
|
Access another player's homes. | Staff | |
hyessentialsx.setwarp
Copy
|
Create/update warps. | Admin | |
hyessentialsx.delwarp
Copy
|
Delete warps. | Admin | |
hyessentialsx.warp.other
Copy
|
Warp another player where supported. | Staff | |
hyessentialsx.playerwarp.use
Copy
|
Browse and visit player warps. | Player | /pwarp, /playerwarp, /playerwarps. |
hyessentialsx.playerwarp.create
Copy
|
Create, rename, move, describe, delete, and change visibility for owned player warps. | Trusted player | Limits and costs are configured under playerWarps. |
hyessentialsx.playerwarp.admin
Copy
|
Moderate any player warp and bypass player warp ownership/visibility checks. | Admin | Also used by staff dashboard player warp inspection paths. |
hyessentialsx.playerwarp.bypasscost
Copy
|
Bypass player warp create/visit costs. | Staff/VIP optional | |
hyessentialsx.playerwarp.bypass
Copy
|
Bypass player warp cooldown/warmup checks where supported. | Staff optional | |
hyessentialsx.tphere
Copy
|
Teleport another player to you. | Staff | |
hyessentialsx.tpahereall
Copy
|
Mass TPA-here/admin TPA flow. | Admin | |
hyessentialsx.back.other
Copy
|
Use /back for another player where supported. | Staff | |
hyessentialsx.rtp.other
Copy
|
Random teleport another player where supported. | Staff | |
hyessentialsx.top
Copy
|
Use /top. | Staff | |
hyessentialsx.bottom
Copy
|
Use /bottom. | Staff | |
hyessentialsx.bottom.other
Copy
|
Use /bottom on another player. | Staff | |
hyessentialsx.jumpto
Copy
|
Use /jumpto. | Staff | |
hyessentialsx.thru
Copy
|
Use /thru. | Staff | |
hyessentialsx.worldborder
Copy
|
Use /worldborder status/on/off/set/center. | Admin | Automatic expansion is configured in config.json. |
hyessentialsx.sleeppercent
Copy
|
Use /sleeppercent. | Admin | |
hyessentialsx.time.day
Copy
|
Use /day. | Admin | |
hyessentialsx.time.night
Copy
|
Use /night. | Admin |
Communication and Staff Chat
Messaging, mail broadcast paths, moderation visibility, and chat controls.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.adminchat
Copy
|
Use /adminchat. | Staff | Alias /a. |
hyessentialsx.broadcast
Copy
|
Use /broadcast. | Staff | Aliases include /bc and /alert. |
hyessentialsx.announcement.admin
Copy
|
Manage announcement presets and open the announcement editor. | Admin | Controls /announcement and the staff command center announcement launch button. |
hyessentialsx.clearchat
Copy
|
Use /clearchat. | Staff | |
hyessentialsx.socialspy
Copy
|
Toggle social spy. | Staff | Private message monitoring. |
hyessentialsx.commandspy
Copy
|
Toggle command spy and manage command filters. | Staff | /commandspy, /cmdspy, /cspy. |
hyessentialsx.commandspy.bypass
Copy
|
Hide the player's command usage from command spy. | Staff optional | Privacy-sensitive commands can also be ignored by config. |
hyessentialsx.nick.other
Copy
|
Set or clear another player's nickname. | Staff | /nick <player> <name|off>. |
hyessentialsx.realname
Copy
|
Look up the account behind a nickname. | Staff | /realname <name>. |
hyessentialsx.mail.sendall
Copy
|
Send mail to all players. | Admin | |
hyessentialsx.near.bypass
Copy
|
Hide from /near where supported. | Staff optional | |
hyessentialsx.afk.bypass
Copy
|
Bypass AFK handling where supported. | Staff optional | |
hyessentialsx.custom.<command>
Copy
|
Use a configured custom command. | Configured | Example: hyessentialsx.custom.discord. |
Moderation, Inventory, and Player Powers
Punishments, staff lookup tools, freeze, vanish, inventory tools, and personal power commands.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.freeze
Copy
|
Freeze a player. | Staff | |
hyessentialsx.freeze.all
Copy
|
Freeze all players. | Admin | |
hyessentialsx.freeze.bypass
Copy
|
Prevent being frozen. | Staff optional | |
hyessentialsx.unfreeze
Copy
|
Unfreeze a player. | Staff | |
hyessentialsx.kickall
Copy
|
Kick all online players except the sender. | Admin | Requires a reason. |
hyessentialsx.mute
Copy
|
Mute and currently unmute players. | Staff | Current /unmute implementation checks mute permission. |
hyessentialsx.unmute
Copy
|
Compatibility/admin permission prefix for unmute. | Staff compat | Safe to include in staff groups. |
hyessentialsx.ban
Copy
|
Permanently ban players. | Staff | |
hyessentialsx.tempban
Copy
|
Temporarily ban players. | Staff | |
hyessentialsx.unban
Copy
|
Unban players. | Staff | |
hyessentialsx.warn
Copy
|
Warn players. | Staff | Supports optional expire:<duration> warning expiry. Warning escalation rules can apply after /warn or staff panel warnings. |
hyessentialsx.warnings
Copy
|
View warning history. | Staff | |
hyessentialsx.clearwarnings
Copy
|
Clear warning history. | Admin | |
hyessentialsx.warnrules
Copy
|
Create, edit, toggle, delete, list, and reset warning escalation rules. | Admin | Used by /warnrules and the staff command center Configuration tab. hyessentialsx.admin is also accepted by the panel editor. |
hyessentialsx.ipban
Copy
|
IP ban and currently IP unban players. | Staff | Current /unipban implementation checks IP ban permission. |
hyessentialsx.unipban
Copy
|
Compatibility/admin permission prefix for IP unban. | Staff compat | Safe to include in staff groups. |
hyessentialsx.banlist
Copy
|
View ban lists. | Staff | |
hyessentialsx.whois
Copy
|
Use /whois. | Staff | |
hyessentialsx.iphistory
Copy
|
Use /iphistory. | Staff | |
hyessentialsx.vanish
Copy
|
Toggle vanish. | Staff | |
hyessentialsx.vanish.others
Copy
|
Toggle vanish for others. | Admin | |
hyessentialsx.clearinventory
Copy
|
Use /clearinventory. | Staff | |
hyessentialsx.invsee
Copy
|
Use /invsee. | Staff | |
hyessentialsx.more
Copy
|
Use /more. | Staff | |
hyessentialsx.more.other
Copy
|
Use /more on another target where supported. | Staff | |
hyessentialsx.repair
Copy
|
Use /repair. | Staff | |
hyessentialsx.repair.all
Copy
|
Repair full inventory. | Staff | |
hyessentialsx.repair.bypass
Copy
|
Bypass repair restrictions/cooldowns where supported. | Staff optional | |
hyessentialsx.fly
Copy
|
Use /fly. | Staff | |
hyessentialsx.fly.time
Copy
|
Buy timed flight with /fly buy or /fly time <minutes>. | Configured | Only applies when fly.timedEnabled is true and fly.timedRequirePermission is enabled. |
hyessentialsx.flyspeed
Copy
|
Use /flyspeed. | Staff | |
hyessentialsx.god
Copy
|
Use /god. | Staff | |
hyessentialsx.heal
Copy
|
Use /heal. | Staff | |
hyessentialsx.heal.all
Copy
|
Heal every online player. | Admin | /heal all. |
hyessentialsx.kit.all
Copy
|
Give a kit to every online player. | Admin | /kit all <kit>. |
hyessentialsx.freecam
Copy
|
Use /freecam. | Staff | |
hyessentialsx.infinitestamina
Copy
|
Use /infinitestamina. | Staff | |
hyessentialsx.combatlog
Copy
|
Use combat log admin reload/tools. | Admin |
Stats, Scoreboard, and Holograms
Stats UI, leaderboard UI, exclusion nodes, scoreboard editor, and hologram commands.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.stats
Copy
|
Open own stats UI. | Player or assigned | Stats feature must be enabled. |
hyessentialsx.stats.other
Copy
|
Open another player's stats. | Staff | |
hyessentialsx.leaderboard
Copy
|
Open leaderboard UI. | Player or assigned | |
hyessentialsx.leaderboard.exempt
Copy
|
Hide from leaderboards. | Staff optional | Useful for devs/admins/test accounts. |
hyessentialsx.scoreboard.edit
Copy
|
Open scoreboard editor. | Admin | |
hyessentialsx.scoreboard.adminmove
Copy
|
Admin scoreboard move/default placement tools. | Admin | |
hyessentialsx.scoreboard.reload
Copy
|
Reload scoreboard config. | Admin | |
hyessentialsx.hologram.admin
Copy
|
All hologram permissions. | Admin | Grants create, delete, edit, list, move, reload, and cleanup. |
hyessentialsx.hologram.create
Copy
|
Create holograms. | Admin | |
hyessentialsx.hologram.delete
Copy
|
Delete holograms. | Admin | |
hyessentialsx.hologram.edit
Copy
|
Edit holograms and lines. | Admin | |
hyessentialsx.hologram.list
Copy
|
List holograms. | Admin | |
hyessentialsx.hologram.move
Copy
|
Move to/from holograms. | Admin | |
hyessentialsx.hologram.reload
Copy
|
Reload holograms. | Admin | |
hyessentialsx.hologram.cleanup
Copy
|
Clean up hologram state. | Admin | |
hyessentialsx.hologramservice.*
Copy
|
Internal/service hologram permission prefix. | Integration | Only needed by integrations that explicitly use it. |
Dynamic Limits and Bypass Patterns
Rank-scale permissions that accept names, numbers, or command keys.
| Permission | Use | Typical Group | Notes |
|---|---|---|---|
hyessentialsx.sethome.max.<number>
Copy
|
Set max homes for a rank. | Rank limit | Example: hyessentialsx.sethome.max.10. |
hyessentialsx.kit.<kitname>
Copy
|
Allow a specific kit. | Rank gate | Example: hyessentialsx.kit.starter. |
hyessentialsx.kit.<kitname>.bypass
Copy
|
Bypass a specific kit cooldown. | Rank perk | Example: hyessentialsx.kit.vip.bypass. |
hyessentialsx.warp.<warp>
Copy
|
Allow a specific warp. | Rank gate | Example: hyessentialsx.warp.market. |
hyessentialsx.paycheck.amount.<amount>
Copy
|
Set paycheck amount for a rank. | Rank perk | Highest matching permission wins. |
hyessentialsx.<command>.cooldown.bypass
Copy
|
Bypass a command cooldown. | Rank perk | Used by commands that define cooldowns. |
hyessentialsx.<command>.warmup.bypass
Copy
|
Bypass a command warmup. | Rank perk | Used by teleport-style commands. |
hyessentialsx.<command>.price.bypass
Copy
|
Bypass a command rule price. | Rank perk | hyessentialsx.price.bypass and hyessentialsx.cost.bypass also bypass all command-rule prices. |
hyessentialsx.<command>.cooldown.reduction.50
Copy
|
Default example permission for a 50% command cooldown reduction. | Rank perk | Custom reduction permissions can be configured under commandRules.commands.<command>.reductions. |
hyessentialsx.<command>.warmup.reduction.50
Copy
|
Default example permission for a 50% command warmup reduction. | Rank perk | |
hyessentialsx.<command>.price.reduction.50
Copy
|
Default example permission for a 50% command price reduction. | Rank perk | |
hyessentialsx.commandrules.disabled.bypass
Copy
|
Bypass commandRules disabled-command checks. | Admin | Per-command form: hyessentialsx.commandrules.disabled.bypass.<command>. |
hyessentialsx.commandrules.world.bypass
Copy
|
Bypass commandRules world blacklists. | Admin | Per-command form: hyessentialsx.commandrules.world.bypass.<command>. |
hyessentialsx.spawn.bypass
Copy
|
Bypass spawn restrictions where supported. | Staff optional | |
hyessentialsx.home.bypass
Copy
|
Bypass home restrictions where supported. | Staff optional | |
hyessentialsx.warp.bypass
Copy
|
Bypass warp restrictions where supported. | Staff optional | |
hyessentialsx.tpa.bypass
Copy
|
Bypass TPA restrictions where supported. | Staff optional | |
hyessentialsx.rtp.bypass
Copy
|
Bypass RTP restrictions where supported. | Staff optional | |
hyessentialsx.back.bypass
Copy
|
Bypass /back restrictions where supported. | Staff optional | |
hyessentialsx.bottom.bypass
Copy
|
Bypass /bottom command rule checks where supported. | Staff optional | |
hyessentialsx.auctionhouse.listings.*
Copy
|
Wildcard for listing limit permissions. | Permission plugin wildcard | Use only if your permission plugin supports wildcard semantics. |
hyessentialsx.auctionhouse.duration.*
Copy
|
Wildcard for auction duration permissions. | Permission plugin wildcard | Use only if your permission plugin supports wildcard semantics. |