Placeholders

Placeholders

EliteEssentials supports placeholders in all configurable messages. This allows for dynamic, context-aware messages and full localization support.

Using Placeholders

Placeholders are wrapped in curly braces: {placeholder}

Example:

"onCooldown": "You must wait {seconds} seconds before using this command again."

Available Placeholders

General Placeholders

Placeholder	Description	Example
{player}	Player name	Steve
{seconds}	Time in seconds	30
{name}	Home/warp name	base
{count}	Current count	2
{max}	Maximum allowed	3
{location}	Formatted coordinates	X: 100, Y: 64, Z: -200
{attempts}	Number of attempts	10
{list}	Comma-separated list	shop, spawn, arena
{permission}	Permission level	all or op
{value}	Input value	invalid
{sleeping}	Players sleeping	3
{needed}	Players needed	5

Complete Message Reference

General Messages

Message Key	Default Value	Placeholders
prefix	[EliteEssentials]	None
noPermission	You don't have permission to use this command.	None
playerNotFound	Player not found.	None
commandDisabled	This command is disabled.	None
onCooldown	You must wait {seconds} seconds before using this command again.	{seconds}
warmupStarted	Teleporting in {seconds} seconds. Don't move!	{seconds}
warmupCancelled	Teleport cancelled - you moved!	None
warmupCountdown	Teleporting in {seconds}...	{seconds}
teleportInProgress	You already have a teleport in progress!	None
couldNotGetPosition	Could not get your position.	None

TPA Messages

Message Key	Default Value	Placeholders
tpaRequestSent	Teleport request sent to {player}.	{player}
tpaRequestReceived	{player} wants to teleport to you.	{player}
tpaRequestInstructions	Type /tpaccept to accept or /tpdeny to deny.	None
tpaSelfRequest	You cannot teleport to yourself.	None
tpaAlreadyPending	You already have a pending request to this player.	None
tpaRequestFailed	Could not send teleport request.	None
tpaNoPending	You have no pending teleport requests.	None
tpaExpired	Teleport request has expired.	None
tpaPlayerOffline	{player} is no longer online.	{player}
tpaAccepted	Teleport request accepted! {player} will teleport to you shortly.	{player}
tpaAcceptedRequester	{player} accepted your teleport request!	{player}
tpaRequesterWarmup	Teleporting to {player} in {seconds} seconds... Stand still!	{player}, {seconds}
tpaRequesterInProgress	The requester already has a teleport in progress.	None
tpaDenied	Teleport request from {player} denied.	{player}
tpaDeniedRequester	{player} denied your teleport request.	{player}
tpaCouldNotFindRequester	Could not find requester.	None
tpaCouldNotGetRequesterPosition	Could not get requester's position.	None

Home Messages

Message Key	Default Value	Placeholders
homeNoHomes	You have no homes set. Use /sethome to create one.	None
homeListHeader	Your homes ({count}/{max}):	{count}, {max}
homeNotFound	Home '{name}' not found.	{name}
homeNoHomeSet	You don't have a home set. Use /sethome first.	None
homeTeleported	Teleported to home '{name}'.	{name}
homeWarmup	Teleporting to home '{name}' in {seconds} seconds... Stand still!	{name}, {seconds}
homeSet	Home '{name}' has been set!	{name}
homeLimitReached	You have reached your home limit ({max}).	{max}
homeInvalidName	Invalid home name.	None
homeSetFailed	Failed to set home.	None
homeDeleted	Home '{name}' has been deleted.	{name}
homeDeleteFailed	Failed to delete home.	None

Warp Messages

Message Key	Default Value	Placeholders
warpNoWarps	No warps available.	None
warpListHeader	Available warps:	None
warpNotFound	Warp '{name}' not found. Available: {list}	{name}, {list}
warpNoPermission	You don't have permission to use this warp.	None
warpTeleported	Teleported to warp '{name}'.	{name}
warpWarmup	Teleporting to warp '{name}' in {seconds} seconds... Stand still!	{name}, {seconds}
warpCreated	Created warp '{name}' for {permission} at {location}.	{name}, {permission}, {location}
warpUpdated	Updated warp '{name}' for {permission} at {location}.	{name}, {permission}, {location}
warpInvalidPermission	Invalid permission '{value}'. Use 'all' or 'op'.	{value}
warpDeleted	Deleted warp '{name}'.	{name}
warpDeleteFailed	Failed to delete warp.	None
warpListTitle	=== Server Warps ===	None
warpListFooter	Use /warp <name> to teleport.	None

Warp Admin Messages

Message Key	Default Value	Placeholders
warpAdminNoWarps	No warps configured.	None
warpAdminCreateHint	Use /setwarp <name> [all|op] to create one.	None
warpAdminTitle	=== Warp Admin Panel ===	None
warpAdminTotal	Total warps: {count}	{count}
warpAdminCommands	Commands:	None
warpAdminInfoTitle	=== Warp: {name} ===	{name}
warpAdminPermissionUpdated	Warp '{name}' permission updated to {permission}.	{name}, {permission}

Back Messages

Message Key	Default Value	Placeholders
backNoLocation	No previous location to go back to.	None
backTeleported	Teleported to your previous location.	None
backWarmup	Teleporting back in {seconds} seconds... Stand still!	{seconds}

Spawn Messages

Message Key	Default Value	Placeholders
spawnNoSpawn	No spawn point configured for this world.	None
spawnNotFound	Could not find spawn point.	None
spawnTeleported	Teleported to spawn!	None
spawnWarmup	Teleporting to spawn in {seconds} seconds... Stand still!	{seconds}

RTP Messages

Message Key	Default Value	Placeholders
rtpSearching	Searching for a safe location...	None
rtpPreparing	Preparing random teleport... Stand still for {seconds} seconds!	{seconds}
rtpTeleported	Teleported to {location}.	{location}
rtpFailed	Could not find a safe location after {attempts} attempts. Try again.	{attempts}
rtpCouldNotDeterminePosition	Could not determine your position.	None

Sleep Messages

Message Key	Default Value	Placeholders
sleepProgress	{sleeping}/{needed} players sleeping...	{sleeping}, {needed}
sleepSkipping	{sleeping}/{needed} players sleeping - Skipping to morning!	{sleeping}, {needed}

Localization Examples

Spanish Translation

"messages": {
  "prefix": "[EliteEssentials] ",
  "noPermission": "No tienes permiso para usar este comando.",
  "playerNotFound": "Jugador no encontrado.",
  "commandDisabled": "Este comando esta deshabilitado.",
  "onCooldown": "Debes esperar {seconds} segundos antes de usar este comando de nuevo.",
  "warmupStarted": "Teletransportando en {seconds} segundos. No te muevas!",
  "warmupCancelled": "Teletransporte cancelado - te moviste!",
  "homeSet": "Casa '{name}' ha sido establecida!",
  "homeTeleported": "Teletransportado a casa '{name}'.",
  "homeNotFound": "Casa '{name}' no encontrada."
}

German Translation

"messages": {
  "prefix": "[EliteEssentials] ",
  "noPermission": "Du hast keine Berechtigung, diesen Befehl zu verwenden.",
  "playerNotFound": "Spieler nicht gefunden.",
  "commandDisabled": "Dieser Befehl ist deaktiviert.",
  "onCooldown": "Du musst {seconds} Sekunden warten, bevor du diesen Befehl erneut verwenden kannst.",
  "warmupStarted": "Teleportiere in {seconds} Sekunden. Nicht bewegen!",
  "warmupCancelled": "Teleport abgebrochen - du hast dich bewegt!",
  "homeSet": "Zuhause '{name}' wurde gesetzt!",
  "homeTeleported": "Zu Zuhause '{name}' teleportiert.",
  "homeNotFound": "Zuhause '{name}' nicht gefunden."
}

Custom Message Tips

1. Keep placeholders intact - Always include the required placeholders or the message may not make sense
2. Test your messages - After changing messages, test each command to ensure they display correctly
3. Use colors - Messages support color codes (handled by the Hytale message system)
4. Prefix is optional - Set prefix to an empty string "" to remove the prefix from all messages