Server Teleporters

Server Teleporters

Simple plugin for creating teleporters that send users across servers

407.0 загрузок
Обновлён 15 дней назад

Описание

Плагин Cross-Server Teleporter

Плагин Hytale, который обеспечивает бесшовную кросс-серверную телепортацию с использованием собственных телепортаторов и варп-систем игры.

Особенности

Кросс-серверная телепортация

  • Перенос игроков между несколькими Серверы Hytale используют внутриигровые телепортеры
  • Работает с нативными блоками телепорта Hytale и системой варпа
  • Автоматическое нерест игрока в определенных местах на целевом сервере

Простой командный интерфейс

  • Короткие, легко запоминающиеся команды
  • Перечислите, создайте и удалите деформации и места нереста

Постоянное хранение

  • Кросс-серверные варп-данные, хранящиеся в crossserver_warps.json
  • Перезапуск Survives Server
  • Отдельно от Hytale's vs.json Чтобы избежать конфликтов

Коренная интеграция

  • Использует встроенные блоки телепорта Hytale
  • Настройка пунктов назначения через обычный UI телепортатора
  • Не требуются пользовательские блоки или сложная настройка

командование

Кросс-серверные варпы

Зарегистрируйте варп кросс-сервера

/csw <warpName> <targetServer> <teleporterId>

Удалить крест-серверный варп

/delcsw <warpName>

Список всех кросс-серверных варпов

/listcsw

Местонахождение Teleporter Spawn

Установите местоположение нереста в текущем положении

/settp <teleporterId>

Удалить место нереста

/deltp <teleporterId>

Список всех мест нереста

/listtp

Как это работает

Шаг 1: Зарегистрируйте деформацию кросс-сервера

Над Источник сервераСоздайте варп, который перенаправит игроков:

/csw hubWarp localhost:25565 spawn1

Это создает варп по имени хабWarp Это приводит игроков к Локальный хозяин: 25565 и посеять их на телепорте ID нерест1.

Шаг 2: Установите местоположение Spwn

Над целевой серверСтойте там, где вы хотите, чтобы игроки испарялись и бегали:

/settp нерест 1 1

Шаг 3: Настройка телепортатора

Поместите блок телепортера в игру, щелкните правой кнопкой мыши, чтобы настроить его, и выберите хабWarp Варп из списка.

Шаг 4: Используйте телепорт.

Когда игрок проходит через настроенный телепорт, он:

  1. Переносится на целевой сервер
  2. Спаун в зарегистрированном месте телепортации

Технические детали

Позиционное варп-совпадение

Текущая реализация очень хакка из-за невозможности получить доступ к варп-имя портала назначения, когда игрок проходит (работая над этим).

  • Каждому деформатору присваиваются уникальные координаты (например, 10000, 100, 10000).
  • Система перехватывает телепортированные события и соответствует координатам места назначения.
  • Если совпадение найдено в реестре кросс-сервера, передача запускается.

ECS Системная интеграция

  • CrossServerTeleportИнтерцептор - RefChangeSystem, который перехватывает Добавление компонентов Teleport
  • Изменение назначения телепорта для предотвращения нежелательных движений
  • Звонки PlayerRef.referToServer() Инициировать кросс-серверную передачу

Хранение данных

Плагин хранит данные о деформации кросс-сервера в Universe/crossserver_warps.json:

{
"Варпс": {
"хубварп": {
"targetServer": "localhost:25565",
"teleporterId": "spawn1"
?
?
?
  1. Копия файла банка на ваш Сервер Hytale модс/ папка

  2. Перезагрузить сервер

  3. Настройка кросс-серверных варпов с использованием команд выше

Случаи использования

Серверные сети Подключение нескольких игровых серверов (лобби к мини-играм для выживания)

Инстанционно-ориентированный контент Перенос игроков на выделенные серверы для подземелий / рейдов

Балансировка нагрузки Распределение игроков по нескольким серверам

Региональные серверы Подключение серверов в разных географических точках

Рассмотрение вопросов безопасности

Важно: Этот плагин в настоящее время находится в разработке и не имеет встроенных функций безопасности. Большая часть из них в настоящее время разрабатывается

  • Любой сервер может отправлять игроков на любой другой сервер.
  • Нет аутентификации между серверами
  • Данные рефералов не шифруются и не проверяются
  • Командование не основано на разрешении
Показать оригинальное описание (English)

Cross-Server Teleporter Plugin

A Hytale plugin that enables seamless cross-server teleportation using the game's native teleporter and warp systems.

Features

Cross-Server Teleportation

  • Transfer players between multiple Hytale servers using in-game teleporters
  • Works with Hytale's native teleporter blocks and warp system
  • Automatic player spawning at designated locations on the target server

Simple Command Interface

  • Short, easy-to-remember commands
  • List, create, and remove warps and spawn locations

Persistent Storage

  • Cross-server warp data stored in crossserver_warps.json
  • Survives server restarts
  • Separate from Hytale's warps.json to avoid conflicts

Native Integration

  • Uses Hytale's built-in teleporter blocks
  • Configure destinations through the normal teleporter UI
  • No custom blocks or complex setup required

Commands

Cross-Server Warps

Register a cross-server warp

/csw <warpName> <targetServer> <teleporterId>

Remove a cross-server warp

/delcsw <warpName>

List all cross-server warps

/listcsw

Teleporter Spawn Locations

Set spawn location at current position

/settp <teleporterId>

Remove a spawn location

/deltp <teleporterId>

List all spawn locations

/listtp

How It Works

Step 1: Register a Cross-Server Warp

On the source server, create a warp that will redirect players:

/csw hubWarp localhost:25565 spawn1

This creates a warp named hubWarp that transfers players to localhost:25565 and spawns them at teleporter ID spawn1.

Step 2: Set Spawn Location

On the target server, stand where you want players to spawn and run:

/settp spawn1

Step 3: Configure Teleporter

Place a teleporter block in-game, right-click to configure it, and select the hubWarp warp from the list.

Step 4: Use the Teleporter

When a player walks through the configured teleporter, they will:

  1. Be transferred to the target server
  2. Spawn at the registered teleporter location

Technical Details

Position-Based Warp Matching

Current implementation is very hacky due to not being able to access a portals destination warp name when the player walks through (working on this)

  • Each cross-server warp is assigned unique coordinates (e.g., 10000, 100, 10000)
  • The system intercepts teleport events and matches destination coordinates
  • If a match is found in the cross-server registry, the transfer is triggered

ECS System Integration

  • CrossServerTeleportInterceptor - RefChangeSystem that intercepts Teleport component additions
  • Modifies teleport destination to prevent unwanted movement
  • Calls PlayerRef.referToServer() to initiate cross-server transfer

Data Storage

The plugin stores cross-server warp data in universe/crossserver_warps.json:

{
  "warps": {
    "hubwarp": {
      "targetServer": "localhost:25565",
      "teleporterId": "spawn1"
    }
  }
}
  1. Copy jar file to your Hytale server's mods/ folder

  2. Restart the server

  3. Configure cross-server warps using the commands above

Use Cases

Server Networks Connect multiple game servers (lobby to minigames to survival)

Instance-Based Content Transfer players to dedicated servers for dungeons/raids

Load Balancing Distribute players across multiple servers

Regional Servers Connect servers in different geographic locations

Security Considerations

Important: This plugin is currently in development and has no built-in security features. Most of these are currently being worked on

  • Any server can send players to any other server
  • No authentication between servers
  • Referral data is not encrypted or validated
  • Commands are not permission based

Последние версии

ServerPortals-1.0.2.jar

Early Access 18.01.2026 315.1 КБ
Скачать