FAQ

Frequently Asked Questions

General Questions

What is EliteEssentials?

EliteEssentials is a server-side essentials mod for Hytale that provides teleportation commands (homes, warps, TPA, RTP, back, spawn) and utility features (sleep percentage, death messages) for survival multiplayer servers.

What Hytale version is required?

EliteEssentials requires Hytale Server version 2026.1.0 or higher.

Is EliteEssentials client-side or server-side?

EliteEssentials is entirely server-side. Players do not need to install anything to use the features.

Does EliteEssentials work with other mods?

Yes, EliteEssentials is designed to work alongside other server mods. It uses standard Hytale APIs and does not modify core game behavior.

Installation

Where do I put the mod file?

Place the EliteEssentials.jar file in your server's mods folder.

How do I know if it installed correctly?

Check your server logs on startup. You should see messages like:

EliteEssentials is setting up...
EliteEssentials setup complete.
EliteEssentials started successfully!

The mod is not loading, what should I check?

1. Verify the JAR file is in the correct mods folder
2. Check that your Hytale server version meets the requirements
3. Look for error messages in the server logs
4. Ensure the JAR file is not corrupted (re-download from CurseForge if needed)

Commands

Why does a command say "This command is disabled"?

The command has been disabled in config.json. To enable it, set enabled: true for that command section and run /eliteessentials reload.

Why am I getting "You don't have permission"?

In Simple Mode (default):

• Check if the command requires Admin access
• Admins need OP status or eliteessentials.admin.* permission

In Advanced Mode:

• Verify you have the specific permission node for that command
• Check with your server admin about your permissions

How do I make a command instant (no warmup)?

Set warmupSeconds: 0 for that command in config.json:

"homes": {
  "warmupSeconds": 0
}

How do I remove cooldowns from a command?

Set cooldownSeconds: 0 for that command in config.json:

"rtp": {
  "cooldownSeconds": 0
}

Can I disable specific commands?

Yes, set enabled: false for any command section:

"rtp": {
  "enabled": false
}

Disabled commands still work for admins but are hidden from regular players.

Homes

How many homes can players have?

By default, 3 homes. This is controlled by homes.maxHomes in config.json.

In Advanced Mode, you can grant different limits via permissions:

• eliteessentials.command.home.limit.5 for 5 homes
• eliteessentials.command.home.limit.unlimited for unlimited homes

Can players have homes in different worlds?

Yes, homes store the world name and work across dimensions.

What characters are allowed in home names?

Home names must be alphanumeric: letters (a-z, A-Z), numbers (0-9), underscore (_), and dash (-). Maximum 32 characters.

Are home names case-sensitive?

No, home names are stored and matched case-insensitively. "Base", "BASE", and "base" all refer to the same home.

Warps

What is the difference between ALL and OP warps?

• ALL warps can be used by any player with warp permission
• OP warps can only be used by admins/OPs

How do I create a warp for everyone?

/setwarp shopname all

Or simply /setwarp shopname (defaults to ALL).

How do I create an admin-only warp?

/setwarp adminarea op

Can I change a warp's permission after creating it?

Yes, use /setwarp <name> <newpermission> to update it, or use the /warpadmin panel.

Teleport Requests (TPA)

How long do TPA requests last?

By default, 30 seconds. Configure with tpa.timeoutSeconds in config.json.

Can I have multiple pending requests?

Yes, you can receive multiple TPA requests from different players. /tpaccept accepts the most recent one.

What happens if I log out with a pending request?

The request is automatically cancelled when either player logs out.

Random Teleport (RTP)

RTP keeps failing to find a location, why?

Possible causes:

1. maxRange is too small for your world
2. minSurfaceY is too high for your terrain
3. Most of the world is water or unsuitable terrain

Try increasing maxRange or decreasing minSurfaceY in config.json.

Can I limit RTP to certain areas?

Currently, RTP teleports within a radius of the world center. You can adjust minRange and maxRange to control the area.

Why do I take fall damage after RTP?

RTP includes invulnerability protection by default (5 seconds). If you are still taking damage:

1. Check that invulnerabilitySeconds is not set to 0
2. The protection may have expired before you landed

Permissions

What is the difference between Simple and Advanced mode?

• Simple Mode (default): Commands are either for Everyone or Admin only. No setup required.
• Advanced Mode: Full granular permission nodes for fine-tuned control. Requires LuckPerms or similar.

How do I enable Advanced permissions?

Set advancedPermissions: true in config.json and reload. Then set up permissions using LuckPerms.

See the LuckPerms Setup Guide for ready-to-use commands.

Do I need a permission plugin?

For Simple Mode, no. For Advanced Mode, you need LuckPerms or Hytale's built-in permission system.

What permission do admins need?

Admins need either:

• OP status (hytale.command.op.*)
• The eliteessentials.admin.* permission
• The eliteessentials.admin permission (without wildcard also works)

Players can see warps but can't teleport to them

This is the warp permission system working as intended:

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

Give players warp.use for all warps, or warp.<name> for specific warps.

/eehelp shows no commands for a player

The player needs:

1. eliteessentials.command.misc.eehelp permission to use the command
2. Permissions for the commands they want to see listed

How do I give VIP players more homes?

In Advanced Mode, use home limit permissions:

/lp group vip permission set eliteessentials.command.home.limit.10 true

How do I let players bypass cooldowns?

Use bypass permissions:

/lp group vip permission set eliteessentials.command.tp.bypass.cooldown true

Or for specific commands:

/lp group vip permission set eliteessentials.command.tp.bypass.cooldown.rtp true

Configuration

How do I reload the config without restarting?

Run /eliteessentials reload as an admin.

My config changes are not applying, why?

1. Make sure you saved the file
2. Run /eliteessentials reload
3. Check for JSON syntax errors in server logs
4. Validate your JSON with an online validator

How do I reset to default configuration?

1. Stop the server
2. Delete mods/EliteEssentials/config.json
3. Start the server (a new default config will be generated)

Can I translate all messages?

Yes, all 60+ player-facing messages are configurable in the messages section of config.json. See the Placeholders page for details.

Data and Storage

Where is player data stored?

In mods/EliteEssentials/:

• homes.json - Player homes
• warps.json - Server warps
• back.json - Back locations

How do I backup player data?

Copy the entire mods/EliteEssentials/ folder to a safe location.

Can I edit data files manually?

Yes, but:

1. Stop the server first
2. Validate JSON syntax before saving
3. Start the server to load changes

Will updating the mod delete my data?

No, data files are preserved during updates.

Troubleshooting

Commands are not registering

Check server logs for registration errors. Common causes:

• Conflicting command names with other mods
• Missing dependencies
• Corrupted JAR file

Players cannot use commands but admins can

This usually means:

• The command is disabled (admins bypass this)
• In Advanced Mode, players lack the permission node

Server crashes on startup

1. Check for full error stack trace in logs
2. Verify Hytale server version compatibility
3. Try removing other mods to isolate the issue
4. Re-download EliteEssentials from CurseForge in case of corruption

High memory usage

For servers with many players:

• Consider reducing back.maxHistory
• Periodically clean up unused homes/warps
• Monitor the size of data files

Feature Requests

How do I request a new feature?

Open an issue on the GitHub repository with the "feature request" label.

Economy

How do I enable the economy system?

Set "economy": { "enabled": true } in config.json and reload.

How do I charge players for commands?

Set costs in config.json:

"homes": {
  "cost": 5.0,
  "setHomeCost": 25.0
},
"rtp": {
  "cost": 10.0
}

How do VIP players bypass costs?

Give them the bypass permission:

/lp group vip permission set eliteessentials.bypass.cost true

Or for specific commands:

/lp group vip permission set eliteessentials.bypass.cost.rtp true

Can other mods use the economy?

Yes! Use the public API at com.eliteessentials.api.EconomyAPI:

EconomyAPI.getBalance(playerUUID);
EconomyAPI.withdraw(playerUUID, amount);
EconomyAPI.deposit(playerUUID, amount);

Aliases

How do I create a command alias?

Use /alias create <name> <command>:

/alias create explore warp explore

Now /explore executes /warp explore.

How do I make an alias silent (no teleport messages)?

Edit aliases.json and add "silent": true:

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

Why does my alias show "no permission" even though it's silent?

Silent mode only suppresses success messages. Error messages (no permission, warp not found, etc.) always show so players know why nothing happened.

Can I chain multiple commands in an alias?

Yes, use ; to separate commands:

/alias create prep warp spawn; heal; fly