RandomTP - Random Teleportation - RandomTP - 随机传送

RandomTP 是一款允许玩家在世界范围内进行无半径限制随机传送的插件。传送目标点为地图中心向外随机位置的安全最高点，支持跨维度传送，并提供了可配置的传送冷却时间。

💡功能特性

• 无半径限制的随机传送。
• 传送至目标区域的安全最高点。
• 支持跨维度（世界）传送。
• 可配置的传送冷却时间。
• 支持在玩家首次加入或每次加入时自动传送。
• 可配置禁止传送的世界和方块黑名单。
• 内置数据库支持，用于存储冷却时间数据。
• 提供完整的权限与命令系统。

🎮命令列表

• /rtp - 将玩家随机传送。
• /randomtp - 同上。
• /randomteleport - 同上。
• /rteleport - 同上。
• /rtp reload - 重载插件配置文件。
• /rtp [world_name] - 在指定的世界内开始搜索传送位置。若留空，则在玩家当前世界进行传送。

✨权限节点

• randomtp.* - 拥有本插件的所有权限。
• randomtp.usage - 允许使用随机传送功能。
• randomtp.bypass - 绕过传送冷却时间。
• randomtp.reload - 允许重载插件配置。

🔧配置说明

以下为配置文件 (config.yml) 的主要结构及说明：

数据库设置 (DataBase)

插件默认使用 SQLite，也支持 MySQL。

DataBase:
  type: SQLite # 数据库类型，可选 SQLite 或 MySQL
  host: 'localhost' # MySQL 主机地址
  port: 3306 # MySQL 端口
  table-name: 'RandomTP' # 数据表名
  user: 'user' # MySQL 用户名
  password: 'password' # MySQL 密码

传送设置 (Teleport)

核心功能的相关配置。

Teleport:
  # 冷却时间（单位：秒）
  cooldown: 604800
  # 时间单位显示文本（用于消息）
  days: ' day ; day ; days '
  hours: ' hour ; hours ; hours '
  minutes: ' minute ; minutes ; minutes '
  seconds: ' second ; seconds ; seconds '
  # 是否在玩家首次进入世界时传送
  first-join: false
  # 是否在玩家每次加入服务器时传送
  join: false
  # 传送半径（从世界中心算起）
  radius: 10000
  # 允许使用随机传送的世界列表
  Worlds:
    - world
  # 禁止传送至的方块列表
  blacklist-blocks:
    - AIR
    - WATER
    - LAVA

消息设置 (Messages)

所有提示消息均可自定义颜色（使用 & 符号）和内容。

Messages:
  teleport-start: '&eTeleportation has begun, location search...'
  teleport-success: '&aYou have been successfully moved! &eOn &c%cord%'
  teleport-wait: '&eExpect more &c%timer%'
  teleport-err-world: '&cError: &eIn this world it is forbidden to use random teleportation'
  not-permission: '&cNot enough rights!'
  not-player-usage: '&cOnly the player can use this command!'
  reload-config: '&aThe configuration has been reload!'

❓重要提示

• 版本兼容性：插件适用于所有运行在 Java 8 及更高版本上的服务端。
• 世界选择：请勿在存在大片虚空（如 world_the_end）的世界启用此插件。在下界（world_nether）中，玩家将被传送至基岩层顶部。
• 冷却时间：cooldown 值需以秒为单位直接填写数字，无需空格。
• 数据统计：插件集成了 bStats 以收集匿名使用数据。

⭐支持与依赖

• 支持的数据：SQLite, MySQL
• 统计服务：bStats