Join the Discord!

Teleport Essentials (TPE)

A comprehensive Hytale plugin that provides teleportation features including homes, random teleportation, public locations, and player-to-player teleport requests.

Commands (players)

/home [name] - Teleport to your saved home (default or named)
/sethome [name] - Set your home at your current location (optional name)
/sethome <x> <y> <z> - Set default home at specific coordinates
/sethome <name> <x> <y> <z> - Set a named home at specific coordinates
/homes - List all of your homes with coordinates (message is private)
/homewipe [name] - Delete a specific home or all homes (no name = delete all)
/rtp - Randomly teleport to a location for exploration
/location <name> - Teleport to a public/admin-defined location
/locations - See all available public locations
/tpr <player> - Request to teleport to another player
/tpa - Accept the most recent teleport request sent to you

Features

Multiple Homes: Players can set multiple named homes (configurable limit)
Group-based Home Limits: Operators can set different home caps per custom group
Random Teleportation: /rtp command for exploration with safe location finding
Public Locations: Admin-defined teleport points for all players
Player Teleport Requests: Request and accept teleportation between players
Flexible Home Management: Delete specific homes or all homes at once
Cooldown System: Configurable delays to prevent teleport spam
Persistent Storage: All data saved across server restarts
Unified Messaging: All commands use consistent "[TPE]" prefix

Admin-only Commands

/sethome max <number> - Set the max homes per player (0 = unlimited). Requires OP group permission.
/group create <name> - Create a custom home-limit group (for example: donators)
/group <name> homelimit <number> - Set max homes for a group (default exists automatically)
/group adduser <group> <username> - Assign a user to a custom group
/group removeuser <username> - Remove a user from custom groups (falls back to default)
/group list - List groups and their configured home limits
/homecooldown <seconds> - Set the cooldown between home teleports (0 = no cooldown). Requires OP group permission.
/location set <name> [<x> <y> <z>] - Save a public teleport location (defaults to your current position)
/location remove <name> - Delete a previously saved public location

Installation

Download the JAR
Place it in your server's mods/ folder
Restart your server

Data Storage

Homes are saved in: plugins/Snipr_HomePlugin/homes.txt
Max homes setting is saved in: plugins/Snipr_HomePlugin/maxhomes.txt
Group home limits are saved in: plugins/Snipr_HomePlugin/homegroups.txt
Group user assignments are saved in: plugins/Snipr_HomePlugin/homegroup_users.txt
Home cooldown setting is saved in: plugins/Snipr_HomePlugin/homecooldown.txt
Public /location entries are saved in: plugins/Snipr_HomePlugin/locations.txt

Each player can have multiple homes (subject to the max homes setting) that persist across server restarts. The RTP command generates random coordinates within configurable bounds (default: 500-5000 blocks from spawn).

⚠️ Important: Permissions Setup

By default, Hytale prevents non-Operators from using slash commands. For regular players to use this plugin, you must add the permission node to your server's permissions.json file.

Note: You must STOP your server before editing this file, or it may reset your changes.

Configuration

Locate permissions.json in your server root and add the permission string to the default group list.

Correct Syntax: Ensure you use a List [], not an Object {}.

{
  "groups": {
    "Default": [],
    "OP": [
      "*"
    ],
    "default": [
      "snipr.homeplugin.*",
    ],
    "Adventure": [
      "snipr.homeplugin.*",
    ]
  }

Teleporting Essentials