FirstJoinRTP

插件

· 作者 LeivurGargiulo

一个轻量级的 Paper 插件,当玩家首次进入特定世界时,会自动将他们传送至配置区域内的随机安全位置。非常适合生存服务器,让玩家的初始位置随机分布,而非固定出生点。

0 本站下载 0 关注 更新于 10 个月前

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

FirstJoinTeleport

FirstJoinTeleport 是一个轻量级的 Paper 插件,当玩家首次加入特定世界时,会自动将他们传送至配置区域内的随机安全位置。非常适合希望玩家在随机地点而非出生点开始游戏的生存服务器。

功能特性

  • 自动传送:玩家进入已配置的世界时将自动被传送
  • 一次性传送:每个玩家在每个世界中仅会被传送一次(防止重复传送)
  • 可配置区域:定义一个正方形半径范围,玩家可在该范围内被传送
  • 倒计时计时器:传送前的可配置倒计时时间(默认 3 秒)
  • 安全位置查找:自动寻找安全位置,支持无限重试
  • 性能优化:使用异步区块加载以防止服务器卡顿
  • 自定义消息:完全可自定义的消息内容(默认为西班牙语)
  • 数据持久化:玩家的传送状态会自动保存
  • 安全检查:避免将玩家传送至水中、岩浆中、虚空或洞穴中(最低 Y 坐标为 60)

要求

  • 服务器软件:Paper 或 Spigot 1.20 或更高版本
  • Java 版本:Java 21 或更高版本

安装步骤

  1. 从 Modrinth 下载最新 JAR 文件
  2. 将 JAR 文件放入服务器的 plugins 文件夹中
  3. 重启服务器或使用 /reload 命令
  4. 插件将在 plugins/randomteleport/ 目录下自动创建 config.yml 文件

配置说明

配置文件位于 plugins/randomteleport/config.yml。修改后,请重新加载插件或重启服务器。

配置选项

target-world(默认值:"world")

应发生传送的世界名称。玩家进入此世界时将被传送(如果此前未被传送过)。

target-world: "world"

radius(默认值:-1000 到 1000)

定义玩家可以被传送的正方形区域。坐标相对于世界的出生点位置。

radius:
  min-x: -1000
  max-x: 1000
  min-z: -1000
  max-z: 1000

示例:若出生点位于 (0, 64, 0),设置 min-x: -1000, max-x: 1000 将创建一个以出生点为中心、大小为 2000x2000 方块的区域。

countdown-seconds(默认值:3)

传送前倒计时的持续时间(秒)。在此期间玩家会看到倒计时消息。

countdown-seconds: 3

注意:将其设置为 0 将立即执行传送(不推荐,因为玩家将看不到任何警告)。

messages(全部可配置)

所有消息均支持使用 & 符号的 Minecraft 颜色代码。占位符 {seconds} 将被替换为倒计时数字。

messages:
  countdown-start: "&aSerás teletransportado en {seconds} segundos..."
  countdown-remaining: "&aTeletransporte en {seconds} segundos..."
  teleporting: "&a¡Teletransportando!"
  teleport-failed: "&cBuscando ubicación segura..."
  already-teleported: "&7Ya has sido teletransportado a este mundo anteriormente."

可用消息:

  • countdown-start:倒计时开始时显示
  • countdown-remaining:倒计时期间每秒显示
  • teleporting:执行传送时显示
  • teleport-failed:如果未能找到位置则显示(在正常运行中不应发生)
  • already-teleported:如果玩家之前已被传送至此世界则显示

工作原理

  1. 当玩家进入已配置的 target-world 时,插件会检查他们此前是否已被传送
  2. 如果此前未被传送,则开始倒计时(默认 3 秒)
  3. 在倒计时期间,玩家会看到提示即将传送的消息
  4. 倒计时结束后,插件会在配置的半径范围内寻找随机安全位置
  5. 插件会无限重试,直到找到安全位置为止
  6. 找到后,通过异步区块加载执行玩家传送
  7. 将该玩家标记为此世界的“已传送”状态(存储在 players.yml 中)

安全特性

插件通过以下方式确保玩家被传送至安全位置:

  • 坚实地面:检查玩家下方是否有坚实地面
  • 空气空间:确保玩家上方至少有 2 个方块的空气空间
  • 液体规避:避开水和岩浆方块
  • 虚空保护:避开虚空位置
  • 洞穴规避:仅传送至 Y=60 以上的位置(避开洞穴)
  • 无限重试:无限重试直到找到安全位置

玩家数据

玩家的传送状态存储在 plugins/randomteleport/players.yml 文件中。该文件:

  • 跟踪哪些玩家已被传送到哪些世界
  • 每 5 分钟自动保存一次
  • 玩家被传送时立即保存
  • 服务器关闭时保存

若要重置玩家的传送状态:

  1. 编辑 plugins/randomteleport/players.yml
  2. 在 players: 下找到该玩家的 UUID 条目
  3. 从其 worlds: 列表中移除世界名称,或移除其整个条目
  4. 保存文件

若要重置所有玩家:

  • 删除 players.yml 文件(它将自动重新创建)

性能

插件经过性能优化:

  • 异步区块加载:使用异步区块加载以防止服务器卡顿
  • 异步位置查找:安全位置查找在异步线程中运行
  • 批量保存:玩家数据保存采用批处理模式(每 5 分钟一次)
  • 最小影响:设计旨在对服务器性能的影响降至最低

故障排除

玩家未被传送

  • 检查 target-world 是否与你的世界名称完全匹配(区分大小写)
  • 验证世界是否存在且已加载
  • 查看服务器日志中的错误信息
  • 确保玩家此前未被传送过(检查 players.yml)

玩家被传送至不安全位置

  • 这不应发生,但如果发生了,请检查世界是否具有有效的地形
  • 确保半径区域内包含有效地形(并非全是虚空/水)
  • 验证世界是否正确生成

倒计时未显示

  • 检查 config.yml 中的消息配置是否正确
  • 确认颜色代码使用的是 & 而不是 §
  • 查看服务器控制台是否有报错信息

重置玩家传送状态

  • 编辑 plugins/randomteleport/players.yml,删除该玩家的 UUID 条目
  • 或者删除该文件以重置所有玩家的状态
  • 重启服务器或等待下一次自动保存

插件未加载

  • 确保你使用的是 Paper 或 Spigot 1.20 或更高版本
  • 检查是否已安装 Java 21 或更高版本
  • 查阅服务器日志以查找错误信息
  • 验证 JAR 文件是否损坏

API 版本

  • 需要 Paper API 版本 1.20 或更高

命令与权限

本插件没有提供命令或权限——它根据世界变化自动运行。

集成

如果你希望与其他插件进行集成,本插件为管理器提供了公开获取方法:

  • getConfigManager() - 访问配置管理器
  • getPlayerDataManager() - 访问玩家数据管理器
  • getTeleportManager() - 访问传送逻辑管理器
  • getCountdownManager() - 访问倒计时管理器

其他插件可以通过调用 reload() 方法来重新加载配置。

支持

如果遇到任何问题或有疑问:

  1. 查看上面的故障排除部分
  2. 查阅服务器日志以查找错误信息
  3. 验证你的配置是否与示例一致
  4. 确保你使用的是兼容的服务器版本

许可证

有关使用和分发的信息,请查阅插件的许可证文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源