FreeTP 随心传送 —— 轻量级分组随机传送模组

FreeTP 是一款专为 Minecraft 服务器设计的分组随机传送管理模组，支持自定义传送点、权限控制与配置热重载，助您轻松实现安全、灵活的玩家传送体验。

✨ 功能亮点

自定义分组管理：支持自由添加/编辑传送点，按需分组管理
多样传送方式：支持随机传送、指定玩家传送、指定人数批量传送
全图随机传送：可配置安全高度、传送半径，支持安全传送检测（避免虚空/岩浆）
权限控制完善：所有指令均支持按权限等级进行管理
热重载配置：修改配置文件后无需重启服务器，指令即时生效
纯中文界面：全中文提示，无多余语言文件，易于理解与使用

🧾 配置文件介绍

"group_id": "1",                // 组的名称
"locations": [
  {
    "name": "出生点",            // 传送点的名称
    "x": 0.0,
    "y": 64.0,
    "z": 0.0
  }
]

"random_world": {
  "enabled": true,              // 是否开启全图随机传送
  "min_y": 60.0,                // 传送高度最小值
  "max_y": 80.0,                // 传送高度最大值
  "radius": 5000.0,             // 传送范围半径（以世界出生点为中心）
  "safe_teleport": true         // 是否启用安全传送（避免虚空/岩浆）
}

"msg_no_locations": {
  "enabled": true,              // 是否启用该提示
  "public_channel": false,      // 是否在公共频道显示
  "text": "错误：配置文件中无有效传送点！" // 提示文本内容
}

🧩 常用指令

指令	说明
`/freetp <分组ID>`	随机传送 1 名玩家到指定分组
`/freetp <分组ID> <玩家>`	传送指定玩家到指定分组
`/freetp <分组ID> random <数量>`	随机传送 N 名玩家到指定分组
`/freetp <分组ID> <玩家> random <数量>`	从指定玩家列表中随机选 N 人传送
`/freetp world`	执行全图随机传送
`/freetp reload`	热重载配置文件

📦 适用版本与环境

支持版本：Minecraft 1.20.1
加载器：Forge
适用服务器类型：生存服、小游戏服、RPG 服等

✅ 模组特点

轻量化设计，运行稳定无卡顿
配置简单，中文注释清晰明了
功能实用，满足多种服务器的传送需求

FreeTP - Random Teleportation

FreeTP is a group-based random teleportation management mod designed exclusively for Minecraft servers. It supports custom waypoints, permission control, and config hot-reloading, allowing server owners to easily implement safe and flexible player teleportation.

✨ Features

Custom Teleport Groups – Freely add and edit waypoints within groups
Flexible Teleportation Modes – Random teleport, target specific players, or teleport a set number of players
Global Random Teleport – Configurable safe Y‑level and radius limits, with safety checks to avoid void/lava
Permission Control – All commands support permission level restrictions
Hot‑Reload Configuration – Changes take effect immediately without server restart
Full Chinese UI – All messages are in Chinese; no extra language files needed

🧾 Configuration Explanation

"group_id": "1",                // Group identifier
"locations": [
  {
    "name": "Spawn",             // Waypoint name
    "x": 0.0,
    "y": 64.0,
    "z": 0.0
  }
]

"random_world": {
  "enabled": true,               // Enable global random teleport
  "min_y": 60.0,                 // Minimum Y‑level
  "max_y": 80.0,                 // Maximum Y‑level
  "radius": 5000.0,              // Teleport radius (centered at world spawn)
  "safe_teleport": true          // Enable safe teleport (avoids void/lava)
}

"msg_no_locations": {
  "enabled": true,               // Whether this message is active
  "public_channel": false,       // Whether to show in public chat
  "text": "Error: No valid waypoints found in config!" // Message text
}

🧩 Common Commands

Command	Description
`/freetp <group-id>`	Randomly teleport 1 player to the specified group
`/freetp <group-id> <player>`	Teleport a specific player to the group
`/freetp <group-id> random <amount>`	Randomly teleport N players to the group
`/freetp <group-id> <player> random <amount>`	From a target player list, randomly select N and teleport them
`/freetp world`	Perform a global random teleport
`/freetp reload`	Hot‑reload the configuration file

📦 Supported Version & Environment

Minecraft Version: 1.20.1
Mod Loader: Forge
Server Types: Survival, Minigame, RPG, and many others

✅ Mod Characteristics

Lightweight, stable, and lag‑free
Simple configuration with clear comments
All text strings are stored in the config file – you can directly modify the language settings
Suitable for a wide range of server styles

[CRTP]CustomRandomTP