EasyTPA

插件

· 作者 ZO3N-Dev

EasyTPA:一款适用于各种规模服务器的易用插件。

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

最新 1.0.2 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

EasyTPA

适用于你的 Minecraft 服务器的简易传送插件


English Description

? 商业使用: 本插件对个人免费。 如果你是企业或通过使用此插件产生收益, 你必须联系我以获得授权。

✨ 功能

  • 玩家传送 — /tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tptoggle
  • 家园 — /home, /sethome, /delhome,支持每位玩家的数量限制和权限层级
  • 传送点 — /warp, /setwarp, /delwarp, /warps,支持每位玩家的拥有权和可点击列表
  • 出生点 — /spawn, /setspawn
  • 返回 — /back(回到上一位置或可配置的死亡位置)
  • 随机传送 — /rtp(别名 /wild),支持异步区块加载
  • 重载 — /tpreload
  • 全局冷却时间:可在两次传送之间配置(可通过权限绕过)
  • 防移动延迟:如果玩家移动,传送将被取消
  • 可配置的 TPA 超时:请求会自动过期
  • 可选的权限系统:对于没有权限插件的服务器可以禁用
  • 100% 可自定义的消息:MiniMessage 格式,支持颜色、悬停提示、点击事件
  • 聊天中可点击的传送点,通过 /warps 查看

? 安装

  1. 从 Releases 下载 easytpa-1.0.0.jar
  2. 将文件放入服务器的 plugins/ 文件夹
  3. 启动(或重启)服务器
  4. 根据你的需求编辑 plugins/EasyTPA/config.yml 和 messages.yml
  5. 使用 /tpreload 重载(无需重启服务器)

要求: Paper 1.21.4+ — Java 21+


⚙️ 配置 — config.yml

# false → 所有人无需权限即可使用玩家命令
# true  → 检查权限(兼容 LuckPerms 和任何 Bukkit 插件)
permissions: false

# 传送前的延迟时间(秒)。设为 0 以禁用。
# 在此期间玩家不能移动,否则传送会被取消。
teleport-delay: 3

# TPA 请求过期的持续时间(秒)
tpa-timeout: 60

# 两次传送之间的全局冷却时间(秒)。设为 0 以禁用。
# 使用以下权限绕过:teleport.cooldown.bypass
teleport-cooldown: 30

# 如果为 true,/back 可以带玩家回到死亡位置
back-on-death: true

# 每位玩家的最大家园数量
# 如果 permissions: true,可通过 teleport.home.multiple.<number> 扩展
max-homes: 1

# 每位玩家的最大传送点数量
max-warps: 5

# /rtp 的最大半径(方块)
rtp-radius: 5000

# /rtp 的最小半径(方块)(避免出生在出生点附近)
rtp-min-radius: 100

# /rtp 寻找安全位置的最大尝试次数
rtp-max-attempts: 20

# 消息前缀(MiniMessage 格式)
messages-prefix: "<dark_gray>[<aqua>EasyTPA<dark_gray>]<reset> "

? 命令

命令 描述 所需权限
/tpa <player> 请求传送到某玩家处 teleport.tpa
/tpahere <player> 请求某玩家来到你身边 teleport.tpahere
/tpaccept 接受 TPA 请求 teleport.tpaccept
/tpdeny 拒绝 TPA 请求 teleport.tpdeny
/tpcancel 取消你待处理的请求 teleport.tpcancel
/tptoggle 启用/禁用接收请求 teleport.tptoggle
/home [name] 传送到家园 teleport.home
/sethome [name] 在你当前位置设置家园 teleport.sethome
/delhome [name] 删除一个家园 teleport.delhome
/warp <name> 传送到传送点 teleport.warp
/setwarp <name> 创建/编辑传送点 teleport.setwarp
/delwarp <name> 删除传送点 传送点所有者或管理员
/warps 列出传送点(可点击) teleport.warps
/spawn 传送到出生点 teleport.spawn
/setspawn 设置出生点 teleport.admin
/back 返回上一位置 teleport.back
/rtp 或 /wild 安全的随机传送 teleport.rtp
/tpreload 重载配置 teleport.admin

如果在 config.yml 中设置 permissions: false,所有玩家命令均可在无需权限的情况下使用。管理员命令始终需要 OP 权限或 teleport.admin。


? 权限

权限 描述 默认值
teleport.tpa 使用 /tpa true
teleport.tpahere 使用 /tpahere true
teleport.tpaccept 使用 /tpaccept true
teleport.tpdeny 使用 /tpdeny true
teleport.tpcancel 使用 /tpcancel true
teleport.tptoggle 使用 /tptoggle true
teleport.home 使用 /home true
teleport.sethome 使用 /sethome true
teleport.delhome 使用 /delhome true
teleport.warp 使用 /warp true
teleport.warps 使用 /warps true
teleport.setwarp 创建/编辑传送点 op
teleport.delwarp 删除任意传送点 op
teleport.spawn 使用 /spawn true
teleport.back 使用 /back true
teleport.rtp 使用 /rtp true
teleport.cooldown.bypass 忽略传送冷却时间 op
teleport.home.multiple.<n> 最多拥有 n 个家园(例如 .5, .10) —
teleport.admin 所有管理员权限 op

? 消息 — messages.yml

所有消息均使用 Adventure 的 MiniMessage 格式。你可以使用颜色、特效、可点击链接等。

可用的占位符:

占位符 描述
<player> 玩家名称
<home> 家园名称
<warp> 传送点名称
<delay> 延迟时间(秒)
<max> 最大限制
<remaining> 剩余秒数(冷却时间)
<usage> 命令语法

MiniMessage 自定义示例:

# 颜色
teleport-success: "<green>Teleportation successful!"

# 渐变色
tpa-sent: "<gradient:#55ff55:#00aa00>Request sent to <player></gradient>"

# 加粗文本与表情符号
teleport-pending: "<gold><bold>⏳ Teleporting in <delay>s... Don't move!</bold>"

# 可点击链接(TPA 按钮已使用此格式)
tpa-received-buttons: "<green><click:run_command:/tpaccept>[Accept]</click>"

?️ 从源代码构建

要求: Java 21, Maven 3.8+

git clone https://github.com/crafteria-dev/EasyTPA.git
cd EasyTPA
mvn package

编译后的 JAR 文件位于 target/easytpa-1.0.0.jar。


? 项目结构

src/main/java/fr/easytpa/
├── EasyTPA.java                    # 主类,初始化
├── commands/                       # 每个命令一个文件(共 17 个命令)
│   ├── TpaCommand.java
│   ├── TpaHereCommand.java
│   ├── TpAcceptCommand.java
│   ├── TpDenyCommand.java
│   ├── TpCancelCommand.java
│   ├── TpToggleCommand.java
│   ├── HomeCommand.java
│   ├── SetHomeCommand.java
│   ├── DelHomeCommand.java
│   ├── WarpCommand.java
│   ├── SetWarpCommand.java
│   ├── DelWarpCommand.java
│   ├── WarpsCommand.java
│   ├── SpawnCommand.java
│   ├── SetSpawnCommand.java
│   ├── BackCommand.java
│   ├── RtpCommand.java
│   └── TpReloadCommand.java
├── managers/                       # 业务逻辑与持久化
│   ├── ConfigManager.java          # config.yml 读取器
│   ├── MessageManager.java         # MiniMessage + 前缀
│   ├── TpaManager.java             # TPA 请求、超时、开关状态
│   ├── TeleportDelayManager.java   # 延迟、防移动、冷却时间
│   ├── CooldownManager.java        # 全局玩家冷却时间
│   ├── HomeManager.java            # 家园数据 (homes.yml)
│   ├── WarpManager.java            # 传送点数据 (warps.yml)
│   ├── SpawnManager.java           # 出生点数据 (spawn.yml)
│   └── BackManager.java            # 上一个位置(内存中存储)
├── listeners/
│   └── TeleportListener.java       # PlayerMove, PlayerDeath, PlayerQuit
└── utils/
    ├── LocationUtils.java          # YAML 序列化、安全检查
    └── PermissionUtils.java        # 玩家/管理员权限检查

src/main/resources/
├── plugin.yml                      # 命令与权限声明
├── config.yml                      # 主配置文件
└── messages.yml                    # 可自定义的消息

? 内部工作原理

传送流程

  1. 指令(例如 /home spawn)调用 TeleportDelayManager.scheduleTeleport()
  2. 检查冷却时间——如果处于冷却中,则发送消息并取消请求
  3. 启动防移动延迟(持续 teleport-delay 秒)
  4. 如果玩家移动 → 取消传送(触发 PlayerMoveEvent)
  5. 否则 → 执行 executeTeleport():保存用于 /back 的位置,并异步调用 player.teleportAsync()
  6. 传送成功 → 更新冷却时间,回调函数发送成功消息

传送点系统

  • 每个传送点存储创建者的 UUID(保存在 warps.yml 中)
  • 玩家只能删除或覆盖自己的传送点
  • 管理员(拥有 teleport.admin 权限或 OP)可以管理所有传送点
  • max-warps 限制是针对每个玩家的(而非全服全局限制)

随机传送 (/rtp)

  • 在 rtp-min-radius 和 rtp-radius 之间的环形区域内生成坐标
  • 使用 world.getChunkAtAsync() 异步加载区块,避免阻塞服务器
  • 检查位置安全性(需有 2 个空气方块、坚实的地面、无岩浆/营火)
  • 如果位置不安全,最多重试 rtp-max-attempts 次

? 许可证

本项目遵循 公平核心许可证 (FCL)。

  • ✅ 免费用于个人用途和非商业服务器
  • ✅ 允许修改和重新分发源代码,但必须署名
  • ❌ 禁止在未获得授权的情况下进行商业使用(即通过该插件产生收入)

如有任何商业合作意向,请联系 GitHub 上的 ZO3N。


Made with ❤️ by ZO3N
github.com/crafteria-dev/EasyTPA

法语说明

? 商业用途: 本插件对个人用户免费。 如果您是企业实体,或通过此插件获取收益, 您必须联系我以获得授权。

✨ 功能特性

  • 玩家间传送 — /tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tptoggle
  • 家园 — /home, /sethome, /delhome,支持按玩家设置上限及权限等级
  • 传送点 — /warp, /setwarp, /delwarp, /warps,支持玩家所有权及可点击列表
  • 出生点 — /spawn, /setspawn
  • 返回 — /back(前往上一个位置或可配置的死前位置)
  • 随机传送 — /rtp(别名 /wild),采用异步区块加载
  • 重载配置 — /tpreload
  • 全局冷却 — 两次传送之间可配置的冷却时间(可通过权限绕过)
  • 防移动延迟 — 如果玩家在延迟期间移动,传送将被取消
  • TPA 超时 — 可配置的 TPA 请求超时,请求会自动过期
  • 可选权限系统 — 可在没有权限插件的服务器上禁用
  • 100% 可自定义消息 — 支持 MiniMessage 格式、颜色、悬停提示、点击动作
  • 聊天中可点击的传送点 — 通过 /warps 命令展示

? 安装

  1. 从 Releases 下载 easytpa-1.0.0.jar
  2. 将文件放入 Paper 服务器的 plugins/ 文件夹中
  3. 启动(或重启)服务器
  4. 根据需要修改 plugins/EasyTPA/config.yml 和 messages.yml
  5. 使用 /tpreload 重新加载(无需重启服务器)

要求: Paper 26.1.2+ — Java 25+

⚙️ 配置 — config.yml

# false → 所有玩家无需权限即可使用玩家命令
# true  → 检查权限(兼容 LuckPerms 及所有 Bukkit 插件)
permissions: false

# 传送前的延迟时间(秒)。设为 0 以禁用。
# 若玩家在等待期间移动,则传送将被取消。
teleport-delay: 3

# TPA 请求过期前的持续时间(秒)
tpa-timeout: 60

# 两次传送之间的全局冷却时间(秒)。设为 0 以禁用。
# 可通过 teleport.cooldown.bypass 绕过此限制
teleport-cooldown: 30

/back 可设置返回死亡地点(若为 true)

back-on-death: true

每个玩家的最大家园数量

如果 permissions: true,可通过 teleport.home.multiple.<数字> 进行扩展

max-homes: 1

每个玩家的最大传送点数量

max-warps: 5

/rtp 命令的最大半径(方块)

rtp-radius: 5000

/rtp 命令的最小半径(方块,避免生成在出生点附近)

rtp-min-radius: 100

寻找安全位置的最大尝试次数

rtp-max-attempts: 20

消息前缀(MiniMessage 格式)

messages-prefix: "<dark_gray>[<aqua>EasyTPA<dark_gray>]<reset> "


---

## ? 命令

| 命令 | 描述 | 所需权限 |
|----------|-------------|-------------------|
| `/tpa <玩家>` | 请求传送到某玩家身边 | `teleport.tpa` |
| `/tpahere <玩家>` | 请求某玩家传送到你身边 | `teleport.tpahere` |
| `/tpaccept` | 接受传送请求 | `teleport.tpaccept` |
| `/tpdeny` | 拒绝传送请求 | `teleport.tpdeny` |

| `/tpcancel` | 取消待处理的传送请求 | `teleport.tpcancel` |
| --- | --- | --- |
| `/tptoggle` | 启用/禁用接收传送请求 | `teleport.tptoggle` |

| `/home [nom]` | 传送至家园 | `teleport.home` |
| | `/sethome [nom]` | 在当前位置设置家园 | `teleport.sethome` |
| | `/delhome [nom]` | 删除家园 | `teleport.delhome` |
| | `/warp <nom>` | 传送至传送点 | `teleport.warp` |
| | `/setwarp <nom>` | 创建/修改传送点 | `teleport.setwarp` |
| | `/delwarp <nom>` | 删除传送点 | 传送点创建者或管理员 |
| | `/warps` | 列出传送点(可点击) | `teleport.warps` |
| | `/spawn` | 传送至出生点 | `teleport.spawn` |
| | `/setspawn` | 设置出生点 | `teleport.admin` |

| `/back` | 返回到上一个位置 | `teleport.back` |

| `/rtp` 或 `/wild` | 安全随机传送 | `teleport.rtp` |
| | `/tpreload` | 重新加载配置 | `teleport.admin` |

> 如果 `config.yml` 中的 `permissions: false`,则所有玩家命令无需权限即可使用。管理员命令始终需要 OP 或 `teleport.admin` 权限。

---

## ? 权限

| 权限 | 描述 | 默认值 |
|-----------|-------------|--------|
| `teleport.tpa` | 使用 /tpa | `true` |
| `teleport.tpahere` | 使用 /tpahere | `true` |
| `teleport.tpaccept` | 使用 /tpaccept | `true` |
| `teleport.tpdeny` | 使用 /tpdeny | `true` |
| `teleport.tpcancel` | 使用 /tpcancel | `true` |
| `teleport.tptoggle` | 使用 /tptoggle | `true` |
| `teleport.home` | 使用 /home | `true` |
| `teleport.sethome` | 使用 /sethome | `true` |
| `teleport.delhome` | 使用 /delhome | `true` |
| `teleport.warp` | 使用 /warp | `true` |
| `teleport.warps` | 使用 /warps | `true` |
| `teleport.setwarp` | 创建/修改传送点 | `op` |
| `teleport.delwarp` | 删除任意传送点 | `op` |
| `teleport.spawn` | 使用 /spawn | `true` |
| `teleport.back` | 使用 /back | `true` |
| `teleport.rtp` | 使用 /rtp | `true` |
| `teleport.cooldown.bypass` | 忽略传送冷却时间 | `op` |
| `teleport.home.multiple.<n>` | 最多拥有 `n` 个出生点(例如 `.5`, `.10`) | — |
| `teleport.admin` | 所有管理员权限 | `op` |

---

## ? 消息配置 — `messages.yml`

所有消息均使用 Adventure 的 **[MiniMessage](https://docs.advntr.dev/minimessage)** 格式。您可以使用颜色、效果、可点击链接等。

**可用的占位符:**

| 占位符 | 描述 |
|------------|-------------|
| `<player>` | 玩家名称 |
| `<home>` | 出生点名称 |
| `<warp>` | 传送点名称 |
| `<delay>` | 延迟秒数 |
| `<max>` | 最大限制 |
| `<remaining>` | 剩余秒数(冷却时间) |
| `<usage>` | 命令语法 |

**MiniMessage 自定义示例:**
```yaml
# 颜色
teleport-success: "<green>传送完成!"

# 渐变色
tpa-sent: "<gradient:#55ff55:#00aa00>已向 <player> 发送请求</gradient>"

# 加粗文本与表情符号
teleport-pending: "<gold><bold>⏳ <delay>秒后传送... 请勿移动!</bold>"

# 可点击链接(TPA 按钮已使用此功能)
tpa-received-buttons: "<green><click:run_command:/tpaccept>[接受]</click>"

?️ 从源代码编译

前置要求: Java 25, Maven 3.8+

git clone https://github.com/crafteria-dev/EasyTPA.git
cd EasyTPA
mvn package

编译后的 JAR 文件位于 target/easytpa-1.0.0.jar。


? 项目结构

src/main/java/fr/easytpa/
├── EasyTPA.java                    # 主类,初始化
├── commands/                       # 每个命令一个文件(共 17 个命令)
│   ├── TpaCommand.java
│   ├── TpaHereCommand.java
│   ├── TpAcceptCommand.java
│   ├── TpDenyCommand.java
│   ├── TpCancelCommand.java
│   ├── TpToggleCommand.java
│   ├── HomeCommand.java
│   ├── SetHomeCommand.java
│   ├── DelHomeCommand.java
│   ├── WarpCommand.java
│   ├── SetWarpCommand.java
│   ├── DelWarpCommand.java
│   ├── WarpsCommand.java
│   ├── SpawnCommand.java
│   ├── SetSpawnCommand.java
│   ├── BackCommand.java
│   ├── RtpCommand.java
│   └── TpReloadCommand.java
├── managers/                       # 业务逻辑与持久化
│   ├── ConfigManager.java          # 读取 config.yml
│   ├── MessageManager.java         # MiniMessage + 前缀
│   ├── TpaManager.java             # TPA 请求、超时、切换状态
│   ├── TeleportDelayManager.java   # 延迟、防移动、冷却时间
│   ├── CooldownManager.java        # 玩家全局冷却时间
│   ├── HomeManager.java            # 家园 (homes.yml)
│   ├── WarpManager.java            # 传送点 (warps.yml)
│   ├── SpawnManager.java           # 出生点 (spawn.yml)
│   └── BackManager.java            # 上一位置(内存中)
├── listeners/
│   └── TeleportListener.java       # PlayerMove, PlayerDeath, PlayerQuit
└── utils/
    ├── LocationUtils.java          # YAML 序列化、安全检查
    └── PermissionUtils.java        # 玩家/管理员权限检查

src/main/resources/
├── plugin.yml                      # 命令和权限声明
├── config.yml                      # 主要配置
└── messages.yml                    # 可自定义消息

? 内部工作机制

传送流程

  1. 命令(例如 /home spawn)调用 TeleportDelayManager.scheduleTeleport()
  2. 检查冷却时间 — 如果处于冷却中,发送消息并取消
  3. 启动防移动延迟(teleport-delay 秒)
  4. 如果玩家移动 → 取消传送(PlayerMoveEvent)
  5. 否则 → executeTeleport():保存用于 /back 的位置,异步调用 player.teleportAsync()
  6. 成功情况下 → 更新冷却时间,回调发送成功消息

传送点系统

  • 每个传送点记录创建者的 UUID(warps.yml)
  • 玩家只能删除或覆盖自己的传送点
  • 管理员(拥有 teleport.admin 权限或 OP)可以管理所有传送点
  • max-warps 限制是针对每个玩家的(非全局限制)

随机传送 (/rtp)

  • 在 rtp-min-radius 和 rtp-radius 之间的环形区域内生成坐标
  • 使用 world.getChunkAtAsync() 加载区块且不阻塞服务器
  • 检查位置安全性(2 格空气、坚实的地面、无岩浆/营火)
  • 如果位置不安全,最多重试 rtp-max-attempts 次

? 许可证

本项目采用 Fair Core License (FCL) 许可。

  • ✅ 免费用于个人用途和非商业服务器
  • ✅ 允许修改和重新分发源代码,但需署名
  • ❌ 禁止未经授权的商业用途(通过该项目获利)

如有任何商业授权需求,请在 GitHub 上联系 ZO3N。


由 ZO3N 用 ❤️ 制作
github.com/crafteria-dev/EasyTPA

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源