服务器跃迁

服务器跃迁

轻松创建传送门，使用时可让玩家在不同服务器间移动。

实用

ServerHop - 多服务器传送插件

使用交互式传送方块无缝连接你的 Hytale 服务器网络！

🌟 概述

ServerHop 是一款 Hytale 服务器插件，能让你创建传送方块，将玩家在网络中的不同服务器之间传送。非常适合大厅服务器、集线器世界，或任何需要实现平滑玩家导航的多服务器设置。

只需站在一个方块上，运行一条命令，该方块就会变成通往另一台服务器的门户！

✨ 功能

  • 🚪 行走激活 - 玩家走进传送门时，会看到倒计时，提示他们即将前往哪个世界
  • 🎨 可视化传送方块 - 自动放置传送门方块，提供清晰的视觉反馈
  • ⚙️ 简易配置 - 使用简单命令设置和管理传送器
  • 💾 持久存储 - 所有配置自动以 JSON 格式保存
  • 🌍 世界感知 - 使用唯一标识符追踪不同世界中的传送器
  • ⏱️ 智能冷却 - 1 秒冷却防止意外快速重复触发
  • 🔌 轻量级 - 使用高效实体系统，对性能影响极小

📦 安装

  1. 下载文件部分中的最新版本 ServerHop-1.0-SNAPSHOT.jar
  2. 放置 JAR 文件到你的 Hytale 服务器的 mods/ 文件夹
  3. 重启你的服务器
  4. 使用以下游戏内命令配置传送器

插件会自动在 mods/ServerHop/ 目录创建其配置文件夹。

🎮 命令

/setteleporter <主机> <端口> [显示名称]

在你站立的方块上创建一个传送器。

示例：

/setteleporter play.example.com 5520
/setteleporter 192.168.1.100 5520 生存服务器
/setteleporter minigames.mynetwork.com 25565 趣味小游戏

使用方法：

  1. 站在你要转换的方块上
  2. 使用目标服务器详情运行命令
  3. 一个可视化的传送门方块会自动放置
  4. 走到方块上测试连接！

/removeteleporter

移除你站立方块上的传送器。

使用方法：

  1. 站在任意传送方块上
  2. 运行 /removeteleporter
  3. 方块恢复原状

/listteleporters

列出服务器上所有已配置的传送器。

输出示例：

=== 已配置的传送器 ===
总计：3

1. 生存服务器
   位置：10, 64, 20
   服务器：play.example.com:5520

2. 小游戏大厅
   位置：15, 64, 20
   服务器：minigames.example.com:5520

3. 创造世界
   位置：20, 64, 20
   服务器：192.168.1.150:5520

🏗️ 示例设置：大厅服务器

创建一个带有通往多个游戏服务器传送器的中心枢纽：

# 创建生存服务器传送器
/setteleporter survival.mynetwork.com 5520 生存模式

# 创建小游戏传送器
/setteleporter minigames.mynetwork.com 5520 小游戏

# 创建创造服务器传送器
/setteleporter creative.mynetwork.com 5520 创造建筑

# 列出所有传送器以验证
/listteleporters

现在玩家可以走进这些方块中的任何一个，立即跳转到该服务器！

🔧 工作原理

  1. 指定一个方块作为传送器，使用 /setteleporter
  2. 可视化指示器 - 插件在该位置放置一个传送门方块
  3. 玩家激活 - 当玩家走到方块上时，他们会被传送
  4. 无痕传送 - 使用 Hytale 原生的 PlayerRef.referToServer() API
  5. 自动保存 - 配置在服务器重启后保持持久化

📋 要求

  • Hytale 服务器（兼容 QUIC 协议）
  • Java 25 或更高版本
  • 多服务器网络 - 至少需要 2 台服务器才能实现传送

🛠️ 从源码构建

如果你想自己构建插件：

git clone <你的仓库地址>
cd ServerHop
mvn clean package

编译后的 JAR 文件位于 target/ServerHop-1.0-SNAPSHOT.jar

🐛 Bug 报告与功能请求

发现 Bug 或有新功能的想法？在评论区告诉我！

📝 配置

所有传送器配置存储在 mods/ServerHop/teleporters.json。如果需要，可以手动编辑此文件，但建议使用游戏内命令进行正确验证。

配置示例：

{
  "teleporters": {
    "world-abc123_10_64_20": {
      "host": "survival.server.com",
      "port": 5520,
      "displayName": "生存服务器"
    }
  }
}

 

📊 版本历史

版本 1.0-SNAPSHOT

  • 初始发布
  • 行走激活传送器
  • 自动可视化方块放置
  • 基于 JSON 的配置系统
  • 带世界感知的方块位置追踪
  • 三个管理命令（设置、移除、列表）
  • 1 秒冷却系统
  • 使用 Hytale 原生 API 的服务器传送

版本 1.1-SNAPSHOT

  • 添加了 settings.json 文件
    • 现在可以配置传送玩家前的等待时间
    • 现在可以更改放置的方块（留空则不放置方块）
    • 现在可以调整通知中使用的语言

尽情使用 ServerHop 构建你的多服务器网络！ 🚀

如果你喜欢这个插件，请在评论区告诉我们！