Random TP - ：最佳随机传送插件

只需一条指令，即可将玩家传送至随机地点。本插件由 SergiFerry 开发，支持自定义传送范围、冷却时间、经济收费，并可与 PlayerNPC 等插件联动，为服务器增添便捷的随机传送功能。

🎮指令与权限

主要指令

• /randomtp (world) - 将你随机传送至指定世界。你可以在 config.yml 中修改此指令。
• /rtpreload - 重新加载 RandomTP 的配置文件。
• /rtpnpc create (world) [personal/group] - 创建一个可点击的 NPC 来执行随机传送（需要 PlayerNPC 依赖）。

权限节点

• randomtp.use.command - 允许使用 /randomtp 指令。
• randomtp.reload - 允许使用 /rtpreload 指令。
• randomtp.create.npc - 允许使用 /rtpnpc create 指令。
• randomtp.use - 允许玩家使用随机传送功能。
• randomtp.cooldown.bypass - 无视随机传送的冷却时间（可作为 VIP 功能）。
• randomtp.* - 管理员权限，包含所有功能。

> [!NOTE]

> 若想通过指令随机传送至其他世界，需在配置中将 command-all-worlds 设置为 true。

✨功能特性

自定义传送

• 可为每个世界单独设置传送的坐标边界 (max-x, min-x, max-z, min-z)。
• 可为每个世界设置别名和传送价格。
• 可设置全局冷却时间 (cooldown-sec)。
• 可配置需要避开的方块列表 (avoid-blocks)。

交互方式

• 告示牌：可创建点击后触发传送的告示牌。格式可在配置中自定义。
• NPC：通过与 PlayerNPC 插件联动，可创建点击后触发传送的 NPC。

经济与区域保护

• 支持与 Vault (Economy) 联动，实现收费传送。
• 可启用区域保护，防止传送至被保护区域（需在对应世界配置中设置 prevent-regions: true）。

🔧配置与依赖

配置文件 (`config.yml`)

主要配置项包括

• worlds：为各个世界（如 world, world_nether, world_the_end）设置范围、别名、价格和区域保护。
• cooldown-sec：传送冷却时间（秒）。
• command：自定义主指令名称。
• sign-line：自定义告示牌文本。
• messages：自定义所有提示信息。
• dependencies：控制 Vault 和 PlayerNPC 功能是否启用。

所需依赖

以下依赖需在配置文件中启用后方可生效

• PlayerNPC API：用于创建传送 NPC。
• 链接：https://www.spigotmc.org/resources/playernpc.93625/
• Vault (Economy)：用于经济系统收费。
• 链接：https://www.spigotmc.org/resources/vault.34315/
• Chunky：用于预生成地形，确保传送地点安全。
• 链接：https://www.spigotmc.org/resources/chunky.81534/

💡开发者 API

插件提供了简单的 API 供开发者调用。

主要方法

// 获取指定世界的一个随机位置
RandomTPAPI.getRandomLocation(World world);

// 将玩家随机传送至指定世界（可指定生物群系）
RandomTPAPI.teleport(Player player, World world, Biome biome);
RandomTPAPI.teleport(Player player, World world);

// 取消玩家当前的冷却时间
RandomTPAPI.cancelCooldown(Player player);

事件监听

你可以监听 PlayerRandomTeleportEvent 来获取玩家传送时的信息。

@EventHandler
public void onRandomTP(PlayerRandomTeleportEvent event) {
    Player player = event.getPlayer();
    Location location = event.getLocation();
    // 你的逻辑代码
}

❓常见问题

如何创建可点击的告示牌？

在告示牌上按照 config.yml 中 sign-line 部分定义的格式输入文本即可。默认第一行为 &b&lRandomTP。

传送搜索失败了怎么办？

插件会尝试在 max-search-sec 设置的时间内寻找安全地点。请确保目标区域已用 Chunky 预生成，并检查 avoid-blocks 列表是否过于严格。

如何为特定世界设置不同的价格？

在 config.yml 的 worlds 部分，找到对应世界的配置，修改其 price 项即可。