Commands

Commands

This page documents all commands available in EliteEssentials.

Command Overview

Command	Description	Default Access
/home [name]	Teleport to a home	Everyone
/sethome [name]	Set a home location	Everyone
/delhome <name>	Delete a home	Everyone
/homes	Open homes GUI	Everyone
/back	Return to previous location	Everyone
/spawn	Teleport to spawn	Everyone
/setspawn	Set server spawn location	Admin
/rtp	Random teleport	Everyone
/rtp <player>	Admin: RTP player in their world	Admin
/rtp <player> <world>	Admin: RTP player to specific world	Admin
/tpa <player>	Request teleport to player	Everyone
/tpahere <player>	Request player to teleport to you	Everyone
/tpaccept	Accept teleport request	Everyone
/tpdeny	Deny teleport request	Everyone
/tphere <player>	Teleport player to you (instant)	Admin
/list	Show all online players	Everyone
/warp	Open warps GUI	Everyone
/warp <name>	Teleport to a warp	Everyone
/warp list	List all warps (text)	Everyone
/warpadmin create <name>	Create a warp	Admin
/warpadmin delete <name>	Delete a warp	Admin
/warpadmin info <name>	View warp details	Admin
/warpsetperm <name> <perm>	Set warp permission	Admin
/warpsetdesc <name> <desc>	Set warp description	Admin
/kit	Open kit GUI	Everyone
/kit <name>	Claim specific kit	Everyone
/kit create <name> <cooldown> <onetime>	Create a kit	Admin
/kit delete <name>	Delete a kit	Admin
/msg <player> <message>	Send private message	Everyone
/reply <message>	Reply to last message	Everyone
/gc [chat] <message>	Send message to chat channel	Everyone
/g [chat] <message>	Alias for /gc	Everyone
/chats	List available chat channels	Everyone
/gcset [chat]	Set default group chat	Everyone
/gcspy	Toggle group chat spy mode	Admin
/motd	Display Message of the Day	Everyone
/rules	Display server rules	Everyone
/discord	Display server discord info	Everyone
/eehelp	Show available commands	Everyone
/seen <player>	View when player was last online	Everyone
/playerinfo	View your detailed player info	Everyone
/playerinfo <name>	View another player's detailed info	Everyone*
/joindate [player]	View first join date	Everyone
/playtime [player]	View total play time	Everyone
/ignore <player>	Ignore a player's messages	Everyone
/ignore list	List ignored players	Everyone
/unignore <player>	Stop ignoring a player	Everyone
/unignore all	Stop ignoring all players	Everyone
/mute <player> [reason]	Mute a player server-wide	Admin
/unmute <player>	Unmute a player	Admin
/ban <player> [reason]	Permanently ban a player	Admin
/tempban <player> <time> [reason]	Temporarily ban a player	Admin
/ipban <player> [reason]	Ban a player's IP address	Admin
/unban <player>	Unban a player	Admin
/unipban <player>	Remove an IP ban	Admin
/freeze <player>	Toggle freeze on a player	Admin
/broadcast <message>	Broadcast to all players	Admin
/clearchat	Clear chat for all players	Admin
/clearinv	Clear all inventory items	Admin
/trash	Open disposal window to trash items	Everyone
/top	Teleport to highest block	Admin
/god	Toggle invincibility	Admin
/heal	Restore full health	Admin
/fly	Toggle flight mode	Admin
/flyspeed <speed>	Set fly speed (1-100 or reset)	Admin
/vanish	Toggle invisibility to other players	Admin
/invsee <player>	View another player's inventory	Admin
/repair	Repair item in hand	Admin
/repair all	Repair all items in inventory	Admin
/sleeppercent [%]	Set sleep percentage	Admin
/wallet	View your balance	Everyone
/wallet <player>	View another player's balance	Everyone*
/pay <player> <amount>	Send money to another player	Everyone
/baltop	View richest players	Everyone
/eco	Economy admin commands	Admin
/sendmessage	Send formatted message to player/group/all	Admin
/mail	Send and receive mail	Everyone
/nick <nickname>	Set your display nickname	Admin
/nick off	Clear your nickname	Admin
/nick <player> <nickname|off>	Set/clear another player's nickname	Admin+
/realname <name>	Look up real username behind a nickname	Admin
/alias	Manage command aliases	Admin
/eliteessentials reload	Reload configuration	Admin
/afk	Toggle AFK status	Everyone
/eemigration <source>	Migrate data from other plugins	Admin

Home Commands

/home [name]

Teleport to one of your saved home locations.

Usage:

• /home - Teleport to your default home named "home"
• /home base - Teleport to your home named "base"

Behavior:

• If warmup is configured, you must stand still for the warmup duration
• Moving during warmup cancels the teleport
• Your current location is saved for /back

/sethome [name]

Save your current location as a home.

Usage:

• /sethome - Set your default home (named "home")
• /sethome base - Set a home named "base"

Behavior:

• Home names are case-insensitive and stored lowercase
• Setting a home with an existing name updates that home
• Players are limited by maxHomes config or permission-based limits

Home Name Rules:

• Must be alphanumeric (letters, numbers, underscore, dash)
• Maximum 32 characters

/delhome

Delete one of your saved homes.

Usage:

• /delhome base - Delete your home named "base"

/homes

Open the homes GUI to view and teleport to your saved homes.

Usage:

• /homes - Opens the homes selection GUI

Behavior:

• Opens a clickable GUI showing all your homes
• Click any home to teleport directly to it
• Shows home name, coordinates, and world
• Your current location is saved for /back when teleporting

Back Command

/back

Return to your previous location.

Usage:

• /back - Teleport to your last location

Behavior:

• Remembers multiple locations (configurable via maxHistory)
• Can return to death location if workOnDeath is enabled
• Each teleport command saves your location for /back

Spawn Commands

/spawn

Teleport to the server spawn point.

Usage:

• /spawn - Teleport to spawn

Behavior:

• Teleports to the location set by /setspawn
• If no spawn is set, displays an error message
• Supports warmup and cooldown

/setspawn

Set the server spawn location at your current position.

Usage:

• /setspawn - Set spawn at your current location

Behavior:

• Saves your current position as the server spawn
• This location is used for /spawn teleports
• Also used as the center for spawn protection (if enabled)
• Persisted to spawn.json

Permission: Admin only

Random Teleport

/rtp

Teleport to a random safe location in the world.

Usage:

• /rtp - Find and teleport to a random location (self)
• /rtp <player> - Admin: RTP player in their current world
• /rtp <player> <world> - Admin: RTP player to a specific world

Behavior:

• Searches within configured min/max range from world center
• Attempts to find safe ground (not underground, not in water/lava)
• Maximum attempts configurable to prevent infinite loops
• Grants brief invulnerability after teleport (configurable)

Admin Usage:

• Can be executed from console for automation (e.g., portal NPCs)
• Admin RTP bypasses warmup and cooldown
• Cross-world RTP teleports player to a random location in the specified world
• Example: /rtp Steve explore - RTP Steve to a random location in the "explore" world

Per-World Ranges: You can configure different RTP ranges for each world in config.json:

"rtp": {
  "minRange": 100,
  "maxRange": 5000,
  "worldRanges": {
    "explore": { "minRange": 500, "maxRange": 10000 },
    "hub": { "minRange": 50, "maxRange": 500 }
  }
}

If a world isn't in worldRanges, it uses the default minRange/maxRange.

Configuration Options:

• minRange - Minimum distance from center (default: 100)
• maxRange - Maximum distance from center (default: 5000)
• maxAttempts - Max tries to find safe location (default: 10)
• minSurfaceY - Minimum Y level to accept (default: 50)
• invulnerabilitySeconds - Protection after teleport (default: 5)
• worldRanges - Per-world range overrides

Permissions:

• eliteessentials.command.tp.rtp - Use /rtp (self)
• eliteessentials.admin.rtp - RTP other players / use from console

Teleport Requests

/tpa

Request to teleport to another player.

Usage:

• /tpa Steve - Send teleport request to Steve

Behavior:

• Target player receives a notification
• Request expires after timeout (default: 30 seconds)
• Cannot send multiple requests to the same player
• Cannot request to teleport to yourself

/tpahere

Request a player to teleport to you (opposite of /tpa).

Usage:

• /tpahere Steve - Request Steve to teleport to you

Behavior:

• Target player receives a notification
• Request expires after timeout (default: 30 seconds)
• If accepted, the target player teleports to you
• Cannot send multiple requests to the same player
• Cannot request yourself

/tpaccept

Accept a pending teleport request.

Usage:

• /tpaccept - Accept the most recent request

Behavior:

• Accepts the most recent non-expired request (TPA or TPAHERE)
• For TPA: Requester teleports to you
• For TPAHERE: You teleport to requester
• Warmup applies to the person being teleported
• Both players are notified of the result

/tpdeny

Deny a pending teleport request.

Usage:

• /tpdeny - Deny the most recent request

Behavior:

• Denies the most recent non-expired request
• Requester is notified their request was denied

/tphere

Instantly teleport a player to your location (admin command).

Usage:

• /tphere Steve - Teleport Steve to your location

Behavior:

• Instant teleport with no warmup or cooldown
• Target player's location is saved for /back
• Admin only
• Useful for bringing players to you for assistance or moderation

Permission: Admin only

Warp Commands

/warp

Open the warps GUI or teleport to a warp.

Usage:

• /warp - Open the warps GUI
• /warp <name> - Teleport to a specific warp
• /warp list - Show text list of warps

Behavior:

• GUI shows all warps you have permission to access
• Click a warp in the GUI to teleport
• Shows warp name and description (if set)
• Admins see "[OP Only]" indicator for restricted warps
• Respects warmup, cooldown, and cost settings

Permission System:

• warp.list - Can open GUI and see warp list
• warp.use - Can teleport to ALL public warps
• warp.<name> - Can teleport to ONLY that specific warp

This allows players to browse warps but only use certain ones.

/warpadmin

Warp administration commands.

Usage:

• /warpadmin create <name> - Create a warp at your location
• /warpadmin delete <name> - Delete a warp
• /warpadmin info <name> - View warp details

Behavior:

• Creates warps accessible to everyone by default
• Use /warpsetperm to change access level
• Use /warpsetdesc to add a description
• Admin only

/warpsetperm

Set the permission level for a warp.

Usage:

• /warpsetperm <name> all - Everyone can use this warp
• /warpsetperm <name> op - Only admins can use this warp

Permission Levels:

• all - Everyone with warp permission can use
• op - Only admins/OPs can use

Behavior:

• Changes who can teleport to the warp
• Does not affect warp visibility in the list
• Admin only

/warpsetdesc

Set a description for a warp.

Usage:

• /warpsetdesc <name> <description...> - Set warp description
• /warpsetdesc shop Welcome to the server shop!

Behavior:

• Description appears in the warp GUI
• Supports color codes (&a, &c, etc.)
• Use to provide context about the warp destination
• Admin only

Kit Commands

/kit [name]

Open the kit selection GUI or claim a specific kit directly.

Usage:

• /kit - Opens the kit selection GUI
• /kit knight - Claims the "knight" kit directly

Aliases: /kits

Behavior:

• Without a name: Opens the kit selection GUI (requires kit.gui permission)
• With a name: Claims that specific kit directly (requires kit.<name> permission)
• Shows cooldown status and one-time claim status
• Items are added to inventory, overflow drops on ground

Kit Types:

• Cooldown kits - Can be claimed again after cooldown expires
• One-time kits - Can only be claimed once per player ever
• Starter kit - Named "Starter", auto-given to new players on first join

Kit Commands: Kits can execute server commands when claimed. Add a commands list to any kit in kits.json:

• Commands run as console with full permissions
• Supports {player} and %player% placeholders (replaced with the claiming player's name)
• Works with ANY registered server command, including commands from other mods
• Commands execute from all claim paths: /kit <name>, the kit GUI, and starter kits on first join

Example kits.json with commands:

{
  "id": "vip",
  "displayName": "VIP Kit",
  "commands": [
    "eco add {player} 500",
    "lp user {player} group add vip",
    "broadcast {player} claimed the VIP kit!"
  ]
}

NPC Integration: The /kit <name> syntax is designed to work with NPCs. Assign /kit knight to an NPC's command and players can receive kits by interacting with the NPC. The command checks the player's permissions, not the NPC's.

Permissions:

• eliteessentials.command.kit.use - Base permission for /kit command
• eliteessentials.command.kit.gui - Permission to open the kit GUI
• eliteessentials.command.kit.<name> - Permission to claim a specific kit
• eliteessentials.command.kit.bypass.cooldown - Bypass kit cooldowns

/kit create

Create a new kit from your current inventory.

Usage:

• /kit create knight 3600 no - Create "knight" kit with 1 hour cooldown
• /kit create starter 0 yes - Create one-time "starter" kit (auto-given to new players)

Parameters:

• name - Kit name (alphanumeric, underscores, hyphens)
• cooldown - Cooldown in seconds (0 = no cooldown)
• onetime - yes or no - Can only be claimed once ever

Behavior:

• Captures all items from your hotbar, storage, armor, utility, and tools
• Skips editor/debug items
• Kit named "Starter" is automatically given to new players on first join
• Admin only

/kit delete

Delete an existing kit.

Usage:

• /kit delete knight - Delete the "knight" kit

Behavior:

• Permanently removes the kit from kits.json
• Does not affect players who already claimed the kit
• Admin only

Configuration: Kits are stored in kits.json. See the Configuration page for details.

Private Messaging

/msg

Send a private message to another player.

Usage:

• /msg Steve Hello! - Send "Hello!" to Steve

Aliases: /m, /message, /whisper, /pm, /tell

Behavior:

• Message is only visible to sender and recipient
• Saves the recipient as your "last conversation" for /reply

/reply

Reply to your last private message conversation.

Usage:

• /reply Thanks! - Send "Thanks!" to your last conversation partner

Aliases: /r

Behavior:

• Sends to whoever you last messaged or received a message from
• Shows error if you haven't messaged anyone yet

Group Chat

/gc [chat]

Send a message to a private chat channel.

Usage:

• /gc Hello team! - Send to your primary chat (or only chat)
• /gc admin Need help with a griefer - Send to a specific chat you have access to
• /g trade WTS Diamond Sword 500g - Send to trade chat using the /g alias
• /gc local Anyone nearby? - Send to a range-limited local chat

Aliases: /groupchat, /gchat, /g

Behavior:

• Messages are only visible to players who have access to the same chat channel
• If you have access to multiple chats, you can specify which chat to use
• If you only have access to one chat, you don't need to specify it
• Range-limited chats only send to players within the specified block distance

Chat Channel Types:

1. Group-based chats (requiresGroup: true, default)

   • Tied to LuckPerms groups
   • Players in the LuckPerms group can use the chat
   • Example: Admin chat for players in the "admin" group

2. Permission-based chats (requiresGroup: false)

   • Tied to a permission node: eliteessentials.chat.<chatname>
   • Any player with the permission can use the chat
   • Useful for cross-group chats like "Trade" or "Help"
   • Example: Trade chat accessible to anyone with eliteessentials.chat.trade

3. Range-limited chats (range: <blocks>)

   • Only players within the specified block range can see messages
   • Perfect for RP servers with local/say chat channels
   • Players must be in the same world to receive messages
   • Range is calculated in 3D (includes vertical distance)
   • Example: Local chat with 50 block range for nearby players only

/chats

List all chat channels you have access to.

Usage:

• /chats - Display your available chat channels

Behavior:

• Shows all chats you can use (both group-based and permission-based)
• Displays chat name, display name, prefix, type, and range (if limited)
• Helpful for seeing which chats are available to you

Example Output:

=== Your Chat Channels (4) ===
[ADMIN] admin - Admin Chat [group]
[STAFF] staff - Staff Chat [group]
[TRADE] trade - Trade Chat [permission]
[LOCAL] local - Local Chat [permission] (50 blocks)
Use /gc [chat] <message> or /g [chat] <message> to chat.

/gcset [chat]

Set your default group chat channel for the /gc command.

Usage:

• /gcset - Show your current default chat
• /gcset trade - Set "trade" as your default chat

Behavior:

• When you have access to multiple chat channels, this sets which one /gc <message> sends to by default
• Without an argument, shows your current default chat
• If you only have access to one chat, that chat is used automatically
• Default chat persists until changed or server restart
• Everyone can use (requires group chat permission)

Permissions:

• eliteessentials.command.misc.groupchat - Use /gcset (same as /gc)

/gcspy

Toggle group chat spy mode to see all group chat messages.

Usage:

• /gcspy - Toggle spy mode on/off

Behavior:

• When enabled, shows all group chat messages from all channels
• Messages from channels you're not in appear with a dimmed [GC-SPY] prefix
• Perfect for monitoring multiple channels as an admin
• Spy state persists until toggled off or server restart

Spy Format: The spy message format is configurable in config.json:

"groupChat": {
  "spyFormat": "&8[GC-SPY] &7[{channel}] {player}: {message}"
}

Permissions:

• eliteessentials.command.misc.groupchat.spy - Use /gcspy (Admin only)

Configuration:

• groupChat.allowSpy - Enable/disable the spy feature (default: true)
• groupChat.spyFormat - Customize the spy message format

Example:

[GC-SPY] [admin] Steve: Need help with a griefer
[GC-SPY] [trade] Jane: WTS Diamond Sword 500g

Note: You can still use /gc [chat] <message> normally while spy mode is enabled. Spy mode only affects what you see, not what you can send.

Communication Commands

Configuration: Chat channels are configured in groupchat.json. Each chat can have:

• groupName - The chat identifier (case-insensitive)
• displayName - Friendly name shown in messages
• prefix - Prefix shown before messages (e.g., "[ADMIN]")
• color - Hex color for the prefix (e.g., "#f85149")
• enabled - Whether this chat is active
• requiresGroup - true for group-based, false for permission-based
• range - Block range limit (null or 0 = unlimited, positive = limited)

Example groupchat.json:

[
  {
    "groupName": "admin",
    "displayName": "Admin Chat",
    "prefix": "[ADMIN]",
    "color": "#f85149",
    "enabled": true,
    "requiresGroup": true
  },
  {
    "groupName": "trade",
    "displayName": "Trade Chat",
    "prefix": "[TRADE]",
    "color": "#f0c674",
    "enabled": true,
    "requiresGroup": false
  },
  {
    "groupName": "local",
    "displayName": "Local Chat",
    "prefix": "[LOCAL]",
    "color": "#8b949e",
    "enabled": true,
    "requiresGroup": false,
    "range": 50
  }
]

Range-Limited Chat Setup (for RP servers): To create a local/say chat where only nearby players can see messages:

1. Add the chat to groupchat.json with "range": 50 (or your desired block distance)
2. Set "requiresGroup": false and grant eliteessentials.chat.local permission
3. Players within 50 blocks of the sender will see the message
4. Players in different worlds or outside the range won't see it

Permission-Based Chat Setup: To create a chat like "Trade" that anyone can access with a permission:

1. Add the chat to groupchat.json with "requiresGroup": false
2. Grant the permission eliteessentials.chat.trade to groups/players who should have access
3. Players with that permission can now use /gc trade <message> or /g trade <message>

Note: Group-based chats require LuckPerms to be installed. Permission-based chats work with any permission system.

Nickname Commands

/nick [player] [nickname|off]

Set or clear a player's display nickname.

Usage:

• /nick <nickname> - Set your own nickname
• /nick off - Clear your own nickname
• /nick <player> <nickname> - Set another player's nickname (requires nickname.others)
• /nick <player> off - Clear another player's nickname (requires nickname.others)

Behavior:

• Nicknames replace the display name shown in chat and the tab list
• Color codes (&a, &c, etc.) are supported if the sender has the nick.color permission
• Without color permission, color codes are stripped from the input
• Setting a nick for another player also notifies that player
• Nicknames persist across sessions (stored in players.json)
• Admin only in simple mode

Nickname Rules:

• Maximum 32 characters (after stripping color codes)
• Must contain only valid characters (letters, numbers, basic punctuation)

Permissions:

• eliteessentials.command.misc.nick - Set your own nickname (Admin in simple mode)
• eliteessentials.command.misc.nick.color - Use color codes in nicknames
• eliteessentials.command.misc.nickname.others - Set/clear other players' nicknames

Configuration:

"nick": {
  "enabled": false
}

/realname

Look up the real username of a player who is using a nickname.

Usage:

• /realname CoolPlayer - Find who is using the nickname "CoolPlayer"

Behavior:

• Searches all online players by both real name and nickname
• If the player has no nickname, reports that they are using their real name
• If no match is found, reports not found
• Admin only

Permission: eliteessentials.command.misc.nickname.lookup (Admin)

Communication Commands

/motd

Display the Message of the Day.

Usage:

• /motd - Display the server's MOTD

Behavior:

• Shows the MOTD configured in motd.json
• Supports color codes (&a, &c, &l, &o, &r)
• Automatically detects and makes URLs clickable
• Supports labeled links: [display text](https://url) for clickable text
• Supports placeholders: {player}, {server}, {world}, {playercount}
• Can be configured to auto-display on player join

Configuration: Edit mods/EliteEssentials/motd.json to customize the MOTD content.

Example motd.json:

{
  "lines": [
    "",
    "&e&lWelcome to {server}, {player}!",
    "&7There are &a{playercount}&7 players online.",
    "&7You are in world &b{world}&7.",
    "",
    "&6> Server Resources:",
    "&7* Type &a/help&7 for commands",
    "&7* Type &a/rules&7 for rules",
    "",
    "&9https://github.com/EliteScouter/EliteEssentials",
    ""
  ]
}

/rules

Display the server rules.

Usage:

• /rules - Display the server rules

Behavior:

• Shows the rules configured in rules.json
• Supports color codes for attractive formatting
• Supports labeled links: [display text](https://url) for clickable text
• Fully customizable content

Configuration: Edit mods/EliteEssentials/rules.json to customize the rules.

Example rules.json:

{
  "lines": [
    "",
    "&c&l========================================",
    "&e&l              SERVER RULES",
    "&c&l========================================",
    "",
    "&a1. &7Be Respectful to others",
    "&a2. &7No Cheating / Hacking",
    "&a3. &7No Griefing",
    "&a4. &7Have fun!",
    "",
    "&6Breaking these rules may result in a ban.",
    ""
  ]
}

/discord

Display the server's discord information with clickable invite link.

Usage:

• /discord - Display the server's discord info

Behavior:

• Shows the discord info configured in discord.json
• Supports color codes for attractive formatting
• URLs are automatically made clickable
• Supports labeled links: [display text](https://url) for clickable text
• Fully customizable content

Configuration: Edit mods/EliteEssentials/discord.json to customize the discord info.

/broadcast

Broadcast a message to all online players.

Usage:

• /broadcast Server restart in 5 minutes! - Send announcement to everyone
• /broadcast &l&6Important: &fMaintenance tonight - With color codes
• /bc Welcome to the server! - Using the alias

Aliases: /bc

Behavior:

• Message is sent to all online players
• Supports color codes (&a, &c, &l, &o, &r)
• Supports labeled links: [display text](https://url) for clickable text
• Displayed with [BROADCAST] prefix (customizable in config)
• Admin only

/list

Show all online players.

Usage:

• /list - Display all online players

Aliases: /online, /who

Behavior:

• Shows player count and maximum players
• Lists all player names in alphabetical order
• Helpful for finding exact player names for commands
• Everyone can use

Example Output:

Online Players (5/100):
Alice, Bob, Charlie, Dave, EliteScouter

Note: This command is especially useful since Hytale doesn't currently support tab completion for player names in commands.

/eehelp

Show all EliteEssentials commands you have permission to use.

Usage:

• /eehelp - Display available commands

Aliases: /ehelp

Behavior:

• Dynamically filters commands based on your permissions
• Only shows commands you can actually use
• Hides admin commands from non-admin players
• Admins see all commands
• Everyone can use (requires eliteessentials.command.misc.eehelp in advanced mode)

/seen

View information about a player.

Usage:

• /seen <player> - View player info

Behavior:

• Shows when the player was last online
• Shows first join date
• Shows total play time
• Works for both online and offline players
• Everyone can use

Example Output:

Player: EliteScouter
First Joined: 2026-01-15 10:30:00
Last Seen: Online now
Play Time: 5h 23m

/joindate [player]

View when a player first joined the server.

Usage:

• /joindate - View your own join date
• /joindate Steve - View Steve's join date

Behavior:

• Without a player name, shows your own first join date
• With a player name, shows that player's first join date (requires .others permission)
• Displays formatted date (e.g., "Jan 15, 2026 at 14:30")
• Works for both online and offline players
• Everyone can use (viewing others requires separate permission)

Permissions:

• eliteessentials.command.misc.joindate - View your own join date
• eliteessentials.command.misc.joindate.others - View other players' join date

Use Case: Great for rank perks on non-pay-to-win servers. Grant .joindate.others to higher ranks so they can look up player info.

/playtime [player]

View total play time on the server.

Usage:

• /playtime - View your own playtime
• /playtime Steve - View Steve's playtime

Behavior:

• Without a player name, shows your own total playtime
• With a player name, shows that player's total playtime (requires .others permission)
• Includes current session time for accurate live totals
• Formatted output (e.g., "2d 3h", "45m", "12s")
• Works for both online and offline players
• Everyone can use (viewing others requires separate permission)

Permissions:

• eliteessentials.command.misc.playtime - View your own playtime
• eliteessentials.command.misc.playtime.others - View other players' playtime

Use Case: Pairs well with /joindate and /seen for server rank perks. Grant .playtime.others to staff or higher ranks.

/playerinfo [player]

View detailed player information (UUID, nickname, first join, last seen, wallet, playtime, kit claims, milestones, and more).

Usage:

• /playerinfo - View your own player info
• /playerinfo <name> - View another player's info (requires playerinfo.others permission)

Behavior:

• Displays a formatted block with: UUID (clickable link to HytaleID for lookup/copy), Username, Nickname (if set), First join, Last seen (or "Online now"), Wallet, Playtime, Kit claims, Claimed milestones, Homes count, Default group chat
• UUID is a clickable link that opens https://hytaleid.com/?q=<uuid> in the browser so players can copy it or use the lookup tool
• All labels and headers are translatable via messages.json (e.g. playerinfoHeaderSelf, playerinfoLabelUuid, playerinfoOnlineNow)
• Works for both online and offline players (offline players are looked up by name from the player index)
• Listed in /eehelp

Permissions:

• eliteessentials.command.misc.playerinfo - View your own player info
• eliteessentials.command.misc.playerinfo.others - View other players' player info

Message keys (messages.json):

• playerinfoHeaderSelf - Header when viewing your own info (e.g. "=== Your player info ===")
• playerinfoHeaderOther - Header when viewing another player (e.g. "=== Player: {player} ===")
• playerinfoLabelUuid, playerinfoLabelUsername, playerinfoLabelNickname, playerinfoLabelFirstJoin, playerinfoLabelLastSeen, playerinfoOnlineNow, playerinfoLabelWallet, playerinfoLabelPlaytime, playerinfoLabelKitClaims, playerinfoLabelClaimedMilestones, playerinfoLabelHomes, playerinfoLabelDefaultGroupChat
• playerinfoNoData, playerinfoNoDataFor - Error messages

Use Case: Replaces or supplements Hytale's built-in /whoami. Useful for staff to look up player UUIDs (e.g. for finding player data files) and for players to see their own stats. Grant playerinfo.others to staff or support roles.

/afk

Toggle your AFK (Away From Keyboard) status.

Usage:

• /afk - Toggle AFK status on/off

Behavior:

• When you go AFK, other players see an [AFK] prefix before your name in the tab player list
• Movement automatically removes AFK status (walking, jumping, flying)
• Optional chat broadcast when players go AFK or return (configurable)
• AFK status persists until toggled off or player disconnects

Tab List Display: When AFK, your name appears as [AFK] YourName in the player list. If tabList.showLuckPermsPrefix is enabled, it shows [AFK] [LuckPermsPrefix] YourName.

Permissions:

• eliteessentials.command.misc.afk - Use /afk (Everyone)

Configuration:

"afk": {
  "enabled": true,
  "inactivityTimeoutMinutes": 5,
  "broadcastAfk": true,
  "showInTabList": true,
  "excludeFromRewards": true
}

Option	Type	Default	Description
enabled	boolean	true	Enable/disable the /afk command
inactivityTimeoutMinutes	int	5	Minutes of inactivity before auto-AFK
broadcastAfk	boolean	true	Broadcast when player goes AFK/returns
showInTabList	boolean	true	Show [AFK] prefix in tab list
excludeFromRewards	boolean	true	Exclude AFK players from PlayTime Rewards

/clearinv

Clear all items from your inventory.

Usage:

• /clearinv - Clear all inventory items

Aliases: /clearinventory, /ci

Behavior:

• Clears all items from hotbar, storage, armor, utility, and tool slots
• Shows count of items cleared
• Cannot be undone - use with caution!
• Admin only

/clearchat

Clear chat for all online players.

Usage:

• /clearchat - Clear chat for everyone

Aliases: /cc

Behavior:

• Sends blank lines to clear the chat window for all players
• Displays a configurable message after clearing (default: "Chat has been cleared by an administrator.")
• Useful for clearing inappropriate content or starting fresh
• Admin only

Permission: eliteessentials.command.misc.clearchat

/trash [size]

Open a disposal window to trash unwanted items.

Usage:

• /trash - Open trash window with default size (27 slots)
• /trash 45 - Open trash window with 45 slots
• /trash 9 - Open a smaller trash window

Aliases: /dispose, /disposal

Behavior:

• Opens an inventory window where you can drag in items to delete
• All items placed in the window are permanently deleted when the window is closed
• Uses Hytale's native ContainerWindow system for a familiar inventory feel
• Optional size argument lets you choose how many slots (1-45, capped by maxSize config)
• Supports cooldowns with permission-based overrides
• Everyone can use

Permissions:

• eliteessentials.command.misc.trash - Use /trash (Everyone)
• eliteessentials.command.misc.trash.bypass.cooldown - Bypass trash cooldown
• eliteessentials.command.misc.trash.cooldown.<seconds> - Set custom cooldown per group

Configuration:

"trash": {
  "enabled": true,
  "cooldownSeconds": 0,
  "defaultSize": 27,
  "maxSize": 45
}

Option	Type	Default	Description
enabled	boolean	true	Enable/disable the /trash command
cooldownSeconds	int	0	Cooldown between uses (0 = no cooldown)
defaultSize	int	27	Default number of slots when no size argument given
maxSize	int	45	Maximum allowed slots (caps the size argument)

Utility Commands

/top

Teleport to the highest block at your current X/Z position.

Usage:

• /top - Teleport straight up to the surface

Behavior:

• Finds the highest solid block at your X/Z coordinates
• Teleports you on top of that block
• Useful for getting out of caves or underground areas
• Admin only

/god

Toggle invincibility mode.

Usage:

• /god - Toggle god mode on/off

Behavior:

• When enabled, you take no damage from any source
• Persists until toggled off or server restart
• Admin only

/heal

Fully restore your health.

Usage:

• /heal - Restore to full health

Behavior:

• Instantly sets health to maximum
• Admin only

/fly

Toggle creative flight mode.

Usage:

• /fly - Toggle flight on/off

Behavior:

• Enables creative-style flight without being in creative mode
• Double-tap jump to start flying
• Admin only
• Cost-per-minute (optional): If fly.costPerMinute is set in config, each use charges that amount (when economy is enabled), enables flight, and automatically disables flight after fly.costPerMinuteDurationSeconds (default 60 seconds). Use this to give players limited paid flight. Cost bypass: eliteessentials.bypass.cost.fly

/flyspeed

Set your fly speed multiplier.

Usage:

• /flyspeed reset - Reset to default speed (15)
• /flyspeed 1 - Set to very slow speed
• /flyspeed 15 - Set to default speed
• /flyspeed 50 - Set to 50x speed (very fast!)
• /flyspeed 100 - Set to maximum speed

Valid Range: 1-100, or "reset" to restore default (15)

Behavior:

• Modifies how fast you fly when flight is enabled
• Higher values = faster flight
• Default speed is 15
• Admin only

/vanish

Toggle invisibility to other players.

Usage:

• /vanish - Toggle vanish mode on/off

Aliases: /v

Behavior:

• When enabled, you are invisible to other players
• Other players cannot see you in the player list
• Useful for monitoring players or investigating issues
• Persists until toggled off or server restart
• Admin only

/invsee

View another player's inventory.

Usage:

• /invsee <player> - Open the target player's inventory
• /invsee - Show usage help and permission info

Behavior:

• Opens the target player's live inventory on the Bench page
• Read-only by default (items cannot be moved)
• With the invsee.modify permission, you can move items in and out of the target's inventory
• Works cross-world (runs on the target player's world thread)
• Uses the same approach as Hytale's built-in /inv see command
• Admin only

Permissions:

• eliteessentials.command.misc.invsee - View player inventories (read-only)
• eliteessentials.command.misc.invsee.modify - Move items in/out of viewed inventory

/repair

Repair items in your inventory.

Usage:

• /repair - Repair the item in your hand
• /repair all - Repair all items in your inventory

Aliases: /fix

Behavior:

• Without "all": Repairs only the item in your active hotbar slot
• With "all": Repairs all damaged items in hotbar, storage, armor, utility, and backpack
• Only repairs items that have durability (tools, weapons, armor)
• Shows count of items repaired when using "all"
• Admin only
• Cost and cooldown can be set separately for single repair vs repair all (see config)

Config (repair): enabled, cooldownSeconds, cooldownAllSeconds, cost, costAll (0 = free)

Permissions:

• eliteessentials.command.misc.repair - Use /repair (single item)
• eliteessentials.command.misc.repair.all - Use /repair all
• eliteessentials.command.misc.repair.bypass.cooldown - Skip cooldown (both single and all)
• eliteessentials.command.misc.repair.cooldown.<seconds> - Cooldown for single repair
• eliteessentials.command.misc.repair.all.cooldown.<seconds> - Cooldown for /repair all
• eliteessentials.bypass.cost.repair - Bypass cost for single repair
• eliteessentials.bypass.cost.repair.all - Bypass cost for repair all

Admin Commands

/sleeppercent [percentage]

Set the percentage of players required to skip the night.

Usage:

• /sleeppercent - View current percentage
• /sleeppercent 30 - Set to 30%

Valid Range: 0-100

Behavior:

• 0% means one player sleeping skips night
• 100% means all players must sleep
• Progress messages shown to all players
• Admin only

/eliteessentials reload

Reload the plugin configuration from disk.

Usage:

• /eliteessentials reload - Reload config.json

Aliases: /ee reload

Behavior:

• Reloads all configuration values
• Does not reload homes, warps, or back data (already in memory)
• Useful for applying config changes without restart
• Admin only

Command Aliases

/alias

Create custom shortcut commands that execute existing commands.

Usage:

• /alias create <name> <command> [permission] - Create an alias
• /alias delete <name> - Delete an alias
• /alias list - List all aliases
• /alias info <name> - Show alias details

Examples:

• /alias create explore warp explore - Makes /explore execute /warp explore
• /alias create hub warp spawn everyone - Creates /hub accessible to everyone
• /alias create staffwarp warp staff op - Creates /staffwarp for admins only

Command Chains: Use ; to execute multiple commands in sequence:

• /alias create prep warp spawn; heal; fly - Teleports to spawn, heals, and enables fly

Compatible Commands: warp, spawn, home

Permission Levels:

• everyone (default) - All players can use
• op - Only admins can use
• Custom permission node - Requires specific permission

Silent Mode: To suppress teleport confirmation messages when using an alias, manually edit aliases.json and add "silent": true to the alias entry:

{
  "explore": {
    "command": "warp explore",
    "permission": "everyone",
    "silent": true
  }
}

When silent mode is enabled:

• The initial "Teleporting to warp 'X' in Y seconds..." message is hidden
• The warmup countdown messages (3... 2... 1...) still display
• The final "Teleported to warp 'X'" message is hidden

This is useful when combined with per-world MOTDs that provide context about the destination.

Behavior:

• Aliases are registered as real commands immediately (no restart needed)
• Stored in aliases.json
• Admin only to create/delete

Disabled Commands

Any command can be disabled in config.json by setting its enabled option to false. Disabled commands:

• Are hidden from non-admin players
• Return "This command is disabled" for non-admins
• Still work for admins (bypass disabled state)

Example to disable RTP:

"rtp": {
  "enabled": false,
  ...
}

Economy Commands

The economy system is disabled by default. Enable it in config.json with "economy": { "enabled": true }.

EliteEssentials supports VaultUnlocked integration for cross-mod economy compatibility. When VaultUnlocked is installed, EliteEssentials registers as an economy provider, allowing other mods to use its economy system.

/wallet

View your balance or manage other players' balances.

Usage:

• /wallet - View your own balance
• /wallet Steve - View Steve's balance (requires permission)
• /wallet set Steve 1000 - Set Steve's balance to 1000 (admin)
• /wallet add Steve 500 - Add 500 to Steve's balance (admin)
• /wallet remove Steve 100 - Remove 100 from Steve's balance (admin)

Behavior:

• Shows balance formatted with currency symbol
• Admin subcommands require admin permission
• Viewing others' balance requires wallet.others permission in advanced mode

/pay

Send money to another player.

Usage:

• /pay Steve 100 - Send 100 coins to Steve

Behavior:

• Cannot pay yourself
• Cannot pay more than you have
• Minimum payment amount configurable in config
• Both players receive confirmation messages

/baltop

View the richest players leaderboard.

Usage:

• /baltop - Display top players by balance

Behavior:

• Shows configurable number of top players (default: 10)
• Displays rank, player name, and formatted balance
• Only shows players who have joined the server

/eco

Console/admin command for economy management.

Usage:

• /eco check Steve - Check Steve's balance
• /eco set Steve 1000 - Set Steve's balance
• /eco add Steve 500 - Add to Steve's balance
• /eco remove Steve 100 - Remove from Steve's balance

Aliases: /economy

Behavior:

• Can be run from console or by admins in-game
• Useful for server scripts and automation
• Admin only

/sendmessage

Send a formatted message to a player, group, or all players. Can be executed from console.

Usage:

• /sendmessage player <name> <message> - Send to a specific player
• /sendmessage group <group> <message> - Send to all players in a LuckPerms group
• /sendmessage all <message> - Send to all online players

Aliases: /sm

Examples:

• /sm player Steve &aWelcome back! - Send green welcome to Steve
• /sm group admin &#FF5555Server maintenance in 5 minutes - Send red message to admins
• /sm all &l&6Important: &fServer restart soon! - Broadcast to everyone

Placeholders:

• {player} - Recipient's username
• {server} - Server name
• {world} - Recipient's current world
• {playercount} - Number of online players

Color Codes:

• Standard codes: &0-f, &l (bold), &o (italic), &r (reset)
• Hex colors: &#RRGGBB (e.g., &#FF5555 for red)

Behavior:

• Can be run from console or by admins in-game
• Supports full chat formatting including hex colors
• Group messages require LuckPerms
• Useful for server scripts, automation, and console announcements
• Admin only

Mail Commands

/mail

Send and receive mail from other players, even when they're offline.

Usage:

• /mail - List your mail (same as /mail list)
• /mail list - List all your mail messages
• /mail read [number] - Read a specific mail (or first unread)
• /mail send <player> <message> - Send mail to a player
• /mail clear - Clear all mail
• /mail clear read - Clear only read mail
• /mail delete <number> - Delete a specific mail

Examples:

• /mail send Steve Hey, want to trade tomorrow? - Send mail to Steve
• /mail read - Read your first unread message
• /mail read 3 - Read mail #3
• /mail clear read - Delete all messages you've already read

Behavior:

• Mail is stored in each player's data file and persists across server restarts
• Recipients are notified on login if they have unread mail
• Mail shows sender, timestamp, and read/unread status
• Maximum mail per player is configurable (default: 50)
• Everyone can use

Permissions:

• eliteessentials.command.mail.use - Use /mail command (list, read, clear, delete)
• eliteessentials.command.mail.send - Send mail to other players

Configuration:

"mail": {
  "enabled": true,
  "maxMailPerPlayer": 50
}

Ignore Commands

/ignore

Block a player's public and private messages.

Usage:

• /ignore Steve - Ignore Steve's messages
• /ignore list - View all players you are currently ignoring

Behavior:

• Ignored players' public chat messages are hidden only for you (other players still see them)
• Private messages (/msg) from ignored players are silently blocked (the sender sees it as "sent" but you don't receive it)
• You cannot ignore yourself
• Ignore data is stored in your player file and persists across server restarts
• Everyone can use

Permissions:

• eliteessentials.command.misc.ignore - Use /ignore and /unignore commands

/unignore

Stop ignoring a player.

Usage:

• /unignore Steve - Stop ignoring Steve
• /unignore all - Stop ignoring all players (reset your ignore list)

Behavior:

• Removes a player from your ignore list so you can see their messages again
• /unignore all clears your entire ignore list and shows how many players were removed
• Shows an error if you weren't ignoring the specified player
• Everyone can use

Mute Commands (Admin)

/mute [reason]

Mute a player server-wide, preventing them from sending any messages.

Usage:

• /mute Steve - Mute Steve
• /mute Steve Spamming in chat - Mute Steve with a reason

Behavior:

• Muted players cannot send public chat messages or private messages (/msg, /reply)
• The muted player is notified that they have been muted
• If a reason is provided, it is shown to the muted player
• Mute data is stored in mutes.json and persists across server restarts
• You cannot mute yourself
• Admin only

Permissions:

• eliteessentials.admin.mute - Use /mute command

/unmute

Unmute a previously muted player.

Usage:

• /unmute Steve - Unmute Steve

Behavior:

• Removes the mute from the player, allowing them to send messages again
• The unmuted player is notified that they have been unmuted (if online)
• Shows an error if the player is not currently muted
• Admin only

Permissions:

• eliteessentials.admin.unmute - Use /unmute command

Ban Commands (Admin)

/ban [reason]

Permanently ban a player from the server.

Usage:

• /ban Steve - Ban Steve
• /ban Steve Griefing the spawn area - Ban Steve with a reason

Behavior:

• Banned players are kicked immediately and cannot rejoin
• If a reason is provided, it is shown to the banned player on kick and on future join attempts
• Ban data persists across server restarts
• You cannot ban yourself
• Admin only

Permission: eliteessentials.admin.ban

/tempban [reason]

Temporarily ban a player for a specified duration.

Usage:

• /tempban Steve 1h - Ban Steve for 1 hour
• /tempban Steve 7d Repeated rule violations - Ban Steve for 7 days with a reason

Time Format:

• s = seconds (e.g., 30s)
• m = minutes (e.g., 15m)
• h = hours (e.g., 2h)
• d = days (e.g., 7d)

Behavior:

• Player is kicked immediately and cannot rejoin until the ban expires
• Ban automatically expires after the specified duration
• If a reason is provided, it is shown to the banned player
• Admin only

Permission: eliteessentials.admin.tempban

/ipban [reason]

Ban a player's IP address, preventing them from joining with any account.

Usage:

• /ipban Steve - Ban Steve's IP address
• /ipban Steve Alt account abuse - Ban Steve's IP with a reason

Behavior:

• Bans the player's IP address, not just their username
• Any account connecting from the banned IP will be rejected
• Useful for preventing ban evasion with alt accounts
• Admin only

Permission: eliteessentials.admin.ipban

/unban

Remove a ban from a player.

Usage:

• /unban Steve - Unban Steve

Behavior:

• Removes both permanent and temporary bans
• The player can rejoin the server after being unbanned
• Shows an error if the player is not currently banned
• Admin only

Permission: eliteessentials.admin.unban

/unipban

Remove an IP ban from a player.

Usage:

• /unipban Steve - Remove the IP ban for Steve

Behavior:

• Removes the IP ban associated with the player
• Any account from that IP can connect again
• Shows an error if the player does not have an active IP ban
• Admin only

Permission: eliteessentials.admin.unipban

Freeze Command (Admin)

/freeze

Toggle freeze on a player, preventing them from moving.

Usage:

• /freeze Steve - Toggle freeze on Steve

Behavior:

• Frozen players cannot move, jump, or fly
• Useful for moderation situations (e.g., investigating a player)
• Toggle command: run again to unfreeze
• The frozen player is notified when frozen/unfrozen
• Freeze state persists until toggled off or player disconnects
• Admin only

Permission: eliteessentials.admin.freeze

See Also

• Configuration - Full configuration reference
• Permissions - All permission nodes
• LuckPerms Setup - Advanced permission configuration
• Chat Formatting - Color codes and formatting
• Placeholders - Available message placeholders