Teleporting Essentials

Join the Discord!

Epic Discord Server with updates

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

1. Download the JAR
2. Place it in your server's mods/ folder
3. 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.*",
    ]
  }

Looking for quality hosting?