VelocityTP

跨服传送插件 — 为 Velocity 代理而生

一款轻量级的 Velocity 代理端插件，支持跨服搜索玩家并一键传送，深度适配 LuckPerms 权限系统，无需在子服务端安装任何内容。

语言 / Language

• 🇨🇳 简体中文
• 🇺🇸 English

简体中文

简介

VelocityTP 是一款运行在 Velocity 代理端 的插件，提供 /vctp 命令让有权限的玩家可以跨服传送到任意在线玩家所在的子服务器。

核心理念： 仅代理端安装，子服务端零侵入。

功能特性

命令

权限

LuckPerms 授权示例：

/lp group default permission set velocitytp.use true
/lp user Steve permission set velocitytp.use true

配置

config.yml

# 语言设置
language: zh_CN    # zh_CN = 简体中文, en_US = English

# 服务器别名（支持 & 颜色代码）
server-aliases:
  lobby: "&a登录服"
  survival: "&b生存服"
  creative: "&6创造服"
  minigame: "&d小游戏"

语言文件

插件启动后会在 plugins/velocitytp/lang/ 目录下生成 zh_CN.yml 和 en_US.yml，你可以直接编辑这些文件修改任意提示文本，支持 & 颜色代码。

编辑后重启 Velocity 代理即可生效。

构建

前置要求： Java 11+、Maven

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

生成的 JAR 文件位于 target/VelocityTP-1.1.0.jar。

安装

1. 将 JAR 文件放入 Velocity 代理端的 plugins/ 目录
2. 重启 Velocity 代理
3. 确认控制台输出包含 "VelocityTP v1.1.0" 的启动横幅
4. 使用 LuckPerms 或权限管理工具授权玩家 velocitytp.use 权限
5. 在游戏中输入 /vctp <玩家ID> 体验跨服传送

兼容性

依赖关系

• Velocity API — 必须（代理端自带）
• LuckPerms — 可选（如有则自动启用权限检查）

工作原理

  ┌─────────────────────────────────┐
  │        Velocity 代理             │
  │  ┌───────────────────────────┐  │
  │  │      VelocityTP 插件       │  │
  │  │  ┌─────┐  ┌────────────┐  │  │
  │  │  │/vctp│→│TeleportMgr │  │  │
  │  │  └─────┘  │ 查找玩家    │  │  │
  │  │           │ 切换服务器  │  │  │
  │  │           └─────┬──────┘  │  │
  │  └─────────────────┼─────────┘  │
  │                    │            │
  └────────────────────┼────────────┘
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
      ┌──────┐    ┌──────┐    ┌──────┐
      │生存服│    │创造服│    │登录服│ ← 子服务端不需要任何插件
      └──────┘    └──────┘    └──────┘

English

Introduction

VelocityTP is a lightweight plugin for the Velocity proxy that enables cross-server teleportation. With the /vctp command, authorized players can teleport to any online player's server — no backend server modifications required.

Core philosophy: Proxy-only installation, zero intrusion on backend servers.

Features

Commands

Permissions

LuckPerms examples:

/lp group default permission set velocitytp.use true
/lp user Steve permission set velocitytp.use true

Configuration

config.yml

# Language setting
language: en_US    # zh_CN = 简体中文, en_US = English

# Server aliases (supports & color codes)
server-aliases:
  lobby: "&aLogin"
  survival: "&bSurvival"
  creative: "&6Creative"
  minigame: "&dMinigame"

Language files

On first startup, the plugin copies zh_CN.yml and en_US.yml to plugins/velocitytp/lang/. You can edit these files directly to customize any message text — & color codes are fully supported.

Restart the Velocity proxy to apply changes.

Installation

1. Place the JAR file in your Velocity proxy's plugins/ directory
2. Restart the Velocity proxy
3. Verify the console shows the "VelocityTP v1.1.0" startup banner
4. Grant players the velocitytp.use permission via LuckPerms or your permission manager
5. Use /vctp <player> in-game to teleport across servers

Compatibility

Dependencies

• Velocity API — Required (provided by the proxy)
• LuckPerms — Optional (auto-detected for permission checks)

How It Works

  ┌─────────────────────────────────┐
  │        Velocity Proxy            │
  │  ┌───────────────────────────┐  │
  │  │      VelocityTP Plugin     │  │
  │  │  ┌─────┐  ┌────────────┐  │  │
  │  │  │/vctp│→│TeleportMgr │  │  │
  │  │  └─────┘  │ Find Player│  │  │
  │  │           │ Switch Srv │  │  │
  │  │           └─────┬──────┘  │  │
  │  └─────────────────┼─────────┘  │
  │                    │            │
  └────────────────────┼────────────┘
                       │
          ┌────────────┼────────────┐
          ▼            ▼            ▼
      ┌──────┐    ┌──────┐    ┌──────┐
      │Surv. │    │Creat.│    │Login │ ← No plugin needed on backend
      └──────┘    └──────┘    └──────┘

License

MIT License © 2024 YuHongChen(LiquidTeam)