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