ServerHop - Multi-Server Teleporter Plugin

Seamlessly connect your Hytale server network with interactive teleporter blocks!

🌟 Overview

ServerHop is a Hytale server plugin that enables you to create teleporter blocks that transport players between servers in your network. Perfect for lobby servers, hub worlds, or any multi-server setup where you want smooth player navigation.

Simply stand on a block, run a command, and that block becomes a portal to another server!

✨ Features

🚪 Walk-On Activation - Players see a countdown when they walk onto a portal, showing them which world they're about to move to
🎨 Visual Teleporter Blocks - Automatically places portal blocks for clear visual feedback
⚙️ Easy Configuration - Simple commands to set up and manage teleporters
💾 Persistent Storage - All configurations saved automatically in JSON format
🌍 World-Aware - Tracks teleporters across different worlds using unique identifiers
⏱️ Smart Cooldown - 1-second cooldown prevents accidental rapid re-triggers
🔌 Lightweight - Minimal performance impact using efficient entity systems

📦 Installation

Download the latest ServerHop-1.0-SNAPSHOT.jar from the files section
Place the JAR file in your Hytale server's mods/ folder
Restart your server
Configure teleporters using the in-game commands below

The plugin will automatically create its configuration directory at mods/ServerHop/

🎮 Commands

`/setteleporter <host> <port> [displayName]`

Creates a teleporter on the block you're standing on.

Examples:

/setteleporter play.example.com 5520
/setteleporter 192.168.1.100 5520 Survival Server
/setteleporter minigames.mynetwork.com 25565 Fun Minigames

Usage:

Stand on the block you want to convert into a teleporter
Run the command with your destination server details
A visual teleporter block will be placed automatically
Walk onto the block to test the connection!

`/removeteleporter`

Removes the teleporter from the block you're standing on.

Usage:

Stand on any teleporter block
Run /removeteleporter
The block returns to normal

`/listteleporters`

Lists all configured teleporters on the server.

Example Output:

=== Configured Teleporters ===
Total: 3

1. Survival Server
   Location: 10, 64, 20
   Server: play.example.com:5520

2. Minigames Hub
   Location: 15, 64, 20
   Server: minigames.example.com:5520

3. Creative World
   Location: 20, 64, 20
   Server: 192.168.1.150:5520

🏗️ Example Setup: Lobby Server

Create a central hub with teleporters to multiple game servers:

# Create a survival server teleporter
/setteleporter survival.mynetwork.com 5520 Survival Mode

# Create a minigames teleporter
/setteleporter minigames.mynetwork.com 5520 Minigames

# Create a creative server teleporter
/setteleporter creative.mynetwork.com 5520 Creative Building

# List all teleporters to verify
/listteleporters

Now players can walk onto any of these blocks to instantly jump to that server!

🔧 How It Works

Designate a block as a teleporter using /setteleporter
Visual Indicator - Plugin places a portal block at that location
Player Activation - When a player walks onto the block, they're transferred
Seamless Transfer - Uses Hytale's native PlayerRef.referToServer() API
Auto-Save - Configuration persists across server restarts

📋 Requirements

Hytale Server (compatible with QUIC protocol)
Java 25 or higher
Multi-Server Network - Requires at least 2 servers to teleport between

🛠️ Building from Source

If you want to build the plugin yourself:

git clone <your-repository>
cd ServerHop
mvn clean package

The compiled JAR will be located at target/ServerHop-1.0-SNAPSHOT.jar

🐛 Bug Reports & Feature Requests

Found a bug or have an idea for a new feature? Let me know in the comments!

📝 Configuration

All teleporter configurations are stored in mods/ServerHop/teleporters.json. You can manually edit this file if needed, but it's recommended to use the in-game commands for proper validation.

Example Configuration:

{
  "teleporters": {
    "world-abc123_10_64_20": {
      "host": "survival.server.com",
      "port": 5520,
      "displayName": "Survival Server"
    }
  }
}

📊 Version History

Version 1.0-SNAPSHOT

Initial release
Walk-on teleporter activation
Automatic visual block placement
JSON-based configuration system
Block location tracking with world awareness
Three management commands (set, remove, list)
1-second cooldown system
Server transfer using Hytale's native API

Version 1.1-SNAPSHOT

settings.json file added
- You can now configure how long it takes before a player is teleported
- You can now change which block is placed (leave this blank for no block placement)
- You can now adjust the language used in the notifications

Enjoy building your multi-server network with ServerHop! 🚀

If you like this plugin, let us know in the comments!

Server Hop