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 查看
? 安装
- 从 Releases 下载
easytpa-1.0.0.jar
- 将文件放入服务器的
plugins/ 文件夹
- 启动(或重启)服务器
- 根据你的需求编辑
plugins/EasyTPA/config.yml 和 messages.yml
- 使用
/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 # 可自定义的消息
? 内部工作原理
传送流程
- 指令(例如
/home spawn)调用 TeleportDelayManager.scheduleTeleport()
- 检查冷却时间——如果处于冷却中,则发送消息并取消请求
- 启动防移动延迟(持续
teleport-delay 秒)
- 如果玩家移动 → 取消传送(触发
PlayerMoveEvent)
- 否则 → 执行
executeTeleport():保存用于 /back 的位置,并异步调用 player.teleportAsync()
- 传送成功 → 更新冷却时间,回调函数发送成功消息
传送点系统
- 每个传送点存储创建者的 UUID(保存在
warps.yml 中)
- 玩家只能删除或覆盖自己的传送点
- 管理员(拥有
teleport.admin 权限或 OP)可以管理所有传送点
max-warps 限制是针对每个玩家的(而非全服全局限制)
随机传送 (/rtp)
- 在
rtp-min-radius 和 rtp-radius 之间的环形区域内生成坐标
- 使用
world.getChunkAtAsync() 异步加载区块,避免阻塞服务器
- 检查位置安全性(需有 2 个空气方块、坚实的地面、无岩浆/营火)
- 如果位置不安全,最多重试
rtp-max-attempts 次
? 许可证
本项目遵循 公平核心许可证 (FCL)。
- ✅ 免费用于个人用途和非商业服务器
- ✅ 允许修改和重新分发源代码,但必须署名
- ❌ 禁止在未获得授权的情况下进行商业使用(即通过该插件产生收入)
如有任何商业合作意向,请联系 GitHub 上的 ZO3N。
法语说明
? 商业用途: 本插件对个人用户免费。
如果您是企业实体,或通过此插件获取收益,
您必须联系我以获得授权。
✨ 功能特性
- 玩家间传送 —
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tptoggle
- 家园 —
/home, /sethome, /delhome,支持按玩家设置上限及权限等级
- 传送点 —
/warp, /setwarp, /delwarp, /warps,支持玩家所有权及可点击列表
- 出生点 —
/spawn, /setspawn
- 返回 —
/back(前往上一个位置或可配置的死前位置)
- 随机传送 —
/rtp(别名 /wild),采用异步区块加载
- 重载配置 —
/tpreload
- 全局冷却 — 两次传送之间可配置的冷却时间(可通过权限绕过)
- 防移动延迟 — 如果玩家在延迟期间移动,传送将被取消
- TPA 超时 — 可配置的 TPA 请求超时,请求会自动过期
- 可选权限系统 — 可在没有权限插件的服务器上禁用
- 100% 可自定义消息 — 支持 MiniMessage 格式、颜色、悬停提示、点击动作
- 聊天中可点击的传送点 — 通过
/warps 命令展示
? 安装
- 从 Releases 下载
easytpa-1.0.0.jar
- 将文件放入 Paper 服务器的
plugins/ 文件夹中
- 启动(或重启)服务器
- 根据需要修改
plugins/EasyTPA/config.yml 和 messages.yml
- 使用
/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 # 可自定义消息
? 内部工作机制
传送流程
- 命令(例如
/home spawn)调用 TeleportDelayManager.scheduleTeleport()
- 检查冷却时间 — 如果处于冷却中,发送消息并取消
- 启动防移动延迟(
teleport-delay 秒)
- 如果玩家移动 → 取消传送(
PlayerMoveEvent)
- 否则 →
executeTeleport():保存用于 /back 的位置,异步调用 player.teleportAsync()
- 成功情况下 → 更新冷却时间,回调发送成功消息
传送点系统
- 每个传送点记录创建者的 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。
EasyTPA
The EasyTPA for your mc server
English Description
? Commercial Use: This plugin is free for individuals.
If you are a business or generate revenue with this plugin,
you must contact me to obtain authorization.
✨ Features
- Player teleportation —
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tptoggle
- Homes —
/home, /sethome, /delhome with per-player limit and permission tiers
- Warps —
/warp, /setwarp, /delwarp, /warps with per-player ownership and clickable list
- Spawn —
/spawn, /setspawn
- Back —
/back (previous position or configurable death location)
- Random teleport —
/rtp (alias /wild) with async chunk loading
- Reload —
/tpreload
- Global cooldown configurable between two teleportations (bypassable via permission)
- Anti-movement delay — teleportation is cancelled if the player moves
- Configurable TPA timeout — requests expire automatically
- Optional permission system — can be disabled for servers without a permissions plugin
- 100% customizable messages — MiniMessage format, colors, hover, click
- Clickable warps in chat with
/warps
? Installation
- Download
easytpa-1.0.0.jar from the Releases
- Place the file in your server's
plugins/ folder
- Start (or restart) the server
- Edit
plugins/EasyTPA/config.yml and messages.yml to your needs
- Reload with
/tpreload (no restart needed)
Required: Paper 1.21.4+ — Java 21+
⚙️ Configuration — config.yml
# false → everyone can use player commands without permission
# true → checks permissions (compatible with LuckPerms and any Bukkit plugin)
permissions: false
# Delay before teleportation (seconds). 0 to disable.
# The player must not move, otherwise the teleportation is cancelled.
teleport-delay: 3
# Duration (seconds) before a TPA request expires
tpa-timeout: 60
# Global cooldown between two teleportations (seconds). 0 to disable.
# Bypass with: teleport.cooldown.bypass
teleport-cooldown: 30
# /back can bring back to death location if true
back-on-death: true
# Maximum number of homes per player
# If permissions: true, extendable via teleport.home.multiple.<number>
max-homes: 1
# Maximum number of warps per player
max-warps: 5
# Maximum radius (blocks) for /rtp
rtp-radius: 5000
# Minimum radius (blocks) for /rtp (avoids spawn)
rtp-min-radius: 100
# Maximum attempts to find a safe position for /rtp
rtp-max-attempts: 20
# Message prefix (MiniMessage format)
messages-prefix: "<dark_gray>[<aqua>EasyTPA<dark_gray>]<reset> "
? Commands
| Command |
Description |
Required Permission |
/tpa <player> |
Request to teleport to a player |
teleport.tpa |
/tpahere <player> |
Request a player to come to you |
teleport.tpahere |
/tpaccept |
Accept a TPA request |
teleport.tpaccept |
/tpdeny |
Deny a TPA request |
teleport.tpdeny |
/tpcancel |
Cancel your pending request |
teleport.tpcancel |
/tptoggle |
Enable/disable receiving requests |
teleport.tptoggle |
/home [name] |
Teleport to a home |
teleport.home |
/sethome [name] |
Set a home at your position |
teleport.sethome |
/delhome [name] |
Delete a home |
teleport.delhome |
/warp <name> |
Teleport to a warp |
teleport.warp |
/setwarp <name> |
Create/edit a warp |
teleport.setwarp |
/delwarp <name> |
Delete a warp |
Warp owner or admin |
/warps |
List warps (clickable) |
teleport.warps |
/spawn |
Teleport to spawn |
teleport.spawn |
/setspawn |
Set the spawn |
teleport.admin |
/back |
Return to previous position |
teleport.back |
/rtp or /wild |
Safe random teleportation |
teleport.rtp |
/tpreload |
Reload the configuration |
teleport.admin |
If permissions: false in config.yml, all player commands are accessible without permission. Admin commands always require OP or teleport.admin.
? Permissions
| Permission |
Description |
Default |
teleport.tpa |
Use /tpa |
true |
teleport.tpahere |
Use /tpahere |
true |
teleport.tpaccept |
Use /tpaccept |
true |
teleport.tpdeny |
Use /tpdeny |
true |
teleport.tpcancel |
Use /tpcancel |
true |
teleport.tptoggle |
Use /tptoggle |
true |
teleport.home |
Use /home |
true |
teleport.sethome |
Use /sethome |
true |
teleport.delhome |
Use /delhome |
true |
teleport.warp |
Use /warp |
true |
teleport.warps |
Use /warps |
true |
teleport.setwarp |
Create/edit a warp |
op |
teleport.delwarp |
Delete any warp |
op |
teleport.spawn |
Use /spawn |
true |
teleport.back |
Use /back |
true |
teleport.rtp |
Use /rtp |
true |
teleport.cooldown.bypass |
Ignore teleportation cooldown |
op |
teleport.home.multiple.<n> |
Have up to n homes (e.g. .5, .10) |
— |
teleport.admin |
All admin permissions |
op |
? Messages — messages.yml
All messages use Adventure's MiniMessage format. You can use colors, effects, clickable links, and more.
Available placeholders:
| Placeholder |
Description |
<player> |
A player's name |
<home> |
A home name |
<warp> |
A warp name |
<delay> |
Delay in seconds |
<max> |
Maximum limit |
<remaining> |
Remaining seconds (cooldown) |
<usage> |
Command syntax |
MiniMessage customization examples:
# Colors
teleport-success: "<green>Teleportation successful!"
# Gradient color
tpa-sent: "<gradient:#55ff55:#00aa00>Request sent to <player></gradient>"
# Bold text with emoji
teleport-pending: "<gold><bold>⏳ Teleporting in <delay>s... Don't move!</bold>"
# Clickable link (already used for TPA buttons)
tpa-received-buttons: "<green><click:run_command:/tpaccept>[Accept]</click>"
?️ Building from source
Requirements: Java 21, Maven 3.8+
git clone https://github.com/crafteria-dev/EasyTPA.git
cd EasyTPA
mvn package
The compiled JAR is located at target/easytpa-1.0.0.jar.
? Project structure
src/main/java/fr/easytpa/
├── EasyTPA.java # Main class, initialization
├── commands/ # One file per command (17 commands)
│ ├── 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/ # Business logic and persistence
│ ├── ConfigManager.java # config.yml reader
│ ├── MessageManager.java # MiniMessage + prefix
│ ├── TpaManager.java # TPA requests, timeout, toggle
│ ├── TeleportDelayManager.java # Delay, anti-movement, cooldown
│ ├── CooldownManager.java # Global per-player cooldown
│ ├── HomeManager.java # Homes (homes.yml)
│ ├── WarpManager.java # Warps (warps.yml)
│ ├── SpawnManager.java # Spawn (spawn.yml)
│ └── BackManager.java # Previous position (in-memory)
├── listeners/
│ └── TeleportListener.java # PlayerMove, PlayerDeath, PlayerQuit
└── utils/
├── LocationUtils.java # YAML serialization, safety checks
└── PermissionUtils.java # Player/admin permission checks
src/main/resources/
├── plugin.yml # Command and permission declarations
├── config.yml # Main configuration
└── messages.yml # Customizable messages
? Internal workings
Teleportation flow
- The command (e.g.
/home spawn) calls TeleportDelayManager.scheduleTeleport()
- The cooldown is checked — if active, a message is sent and the request is dropped
- The anti-movement delay starts (
teleport-delay seconds)
- If the player moves → cancellation (
PlayerMoveEvent)
- Otherwise →
executeTeleport(): saves the position for /back, calls player.teleportAsync() asynchronously
- On success → the cooldown is updated, the callback sends the success message
Warp system
- Each warp stores the creator's UUID (
warps.yml)
- A player can only delete or overwrite their own warps
- Admins (
teleport.admin or OP) can manage all warps
- The
max-warps limit is per player (not global)
Random teleportation (/rtp)
- Generates coordinates within a ring between
rtp-min-radius and rtp-radius
- Uses
world.getChunkAtAsync() to load chunks without blocking the server
- Checks position safety (2 air blocks, solid ground, no magma/campfire)
- Retries up to
rtp-max-attempts times if the position is not safe
? License
This project is licensed under the Fair Core License (FCL).
- ✅ Free for personal use and non-commercial servers
- ✅ Modification and redistribution of source code with attribution
- ❌ Commercial use (revenue generation) without authorization is prohibited
For any commercial inquiry, contact ZO3N on GitHub.
French Description
? Usage Commercial : Ce plugin est gratuit pour les particuliers.
Si vous êtes une entreprise ou que vous générez des revenus avec ce plugin,
vous devez me contacter pour obtenir une autorisation.
✨ Fonctionnalités
- Téléportation entre joueurs —
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tptoggle
- Homes —
/home, /sethome, /delhome avec limite par joueur et tiers de permissions
- Warps —
/warp, /setwarp, /delwarp, /warps avec propriété par joueur et liste cliquable
- Spawn —
/spawn, /setspawn
- Retour —
/back (position précédente ou lieu de mort configurable)
- Téléportation aléatoire —
/rtp (alias /wild) avec chargement async des chunks
- Rechargement —
/tpreload
- Cooldown global configurable entre deux téléportations (bypass par permission)
- Délai anti-mouvement — la téléportation est annulée si le joueur bouge
- Timeout TPA configurable — les demandes expirent automatiquement
- Système de permissions optionnel — désactivable pour les serveurs sans plugin de perms
- Messages 100 % personnalisables — format MiniMessage, couleurs, hover, click
- Warps cliquables dans le chat avec
/warps
? Installation
- Télécharger
easytpa-1.0.0.jar depuis les Releases
- Placer le fichier dans le dossier
plugins/ de votre serveur Paper
- Démarrer (ou redémarrer) le serveur
- Modifier
plugins/EasyTPA/config.yml et messages.yml selon vos besoins
- Recharger avec
/tpreload (inutile de redémarrer)
Requis : Paper 26.1.2+ — Java 25+
⚙️ Configuration — config.yml
# false → tout le monde peut utiliser les commandes joueur sans permission
# true → vérifie les permissions (compatible LuckPerms et tout plugin Bukkit)
permissions: false
# Délai avant téléportation (secondes). 0 pour désactiver.
# Le joueur ne doit pas bouger, sinon la téléportation est annulée.
teleport-delay: 3
# Durée (secondes) avant expiration d'une demande TPA
tpa-timeout: 60
# Cooldown global entre deux téléportations (secondes). 0 pour désactiver.
# Contourne avec : teleport.cooldown.bypass
teleport-cooldown: 30
# /back peut ramener au lieu de mort si true
back-on-death: true
# Nombre maximum de homes par joueur
# Si permissions: true, extensible via teleport.home.multiple.<nombre>
max-homes: 1
# Nombre maximum de warps par joueur
max-warps: 5
# Rayon maximum (blocs) pour /rtp
rtp-radius: 5000
# Rayon minimum (blocs) pour /rtp (évite le spawn)
rtp-min-radius: 100
# Tentatives maximum pour trouver une position sûre pour /rtp
rtp-max-attempts: 20
# Préfixe des messages (format MiniMessage)
messages-prefix: "<dark_gray>[<aqua>EasyTPA<dark_gray>]<reset> "
? Commandes
| Commande |
Description |
Permission requise |
/tpa <joueur> |
Demander à se téléporter à un joueur |
teleport.tpa |
/tpahere <joueur> |
Demander à un joueur de venir à vous |
teleport.tpahere |
/tpaccept |
Accepter une demande TPA |
teleport.tpaccept |
/tpdeny |
Refuser une demande TPA |
teleport.tpdeny |
/tpcancel |
Annuler votre demande en attente |
teleport.tpcancel |
/tptoggle |
Activer/désactiver la réception de demandes |
teleport.tptoggle |
/home [nom] |
Se téléporter à un home |
teleport.home |
/sethome [nom] |
Définir un home à votre position |
teleport.sethome |
/delhome [nom] |
Supprimer un home |
teleport.delhome |
/warp <nom> |
Se téléporter à un warp |
teleport.warp |
/setwarp <nom> |
Créer/modifier un warp |
teleport.setwarp |
/delwarp <nom> |
Supprimer un warp |
Créateur du warp ou admin |
/warps |
Lister les warps (cliquables) |
teleport.warps |
/spawn |
Se téléporter au spawn |
teleport.spawn |
/setspawn |
Définir le spawn |
teleport.admin |
/back |
Retourner à la position précédente |
teleport.back |
/rtp ou /wild |
Téléportation aléatoire sûre |
teleport.rtp |
/tpreload |
Recharger la configuration |
teleport.admin |
Si permissions: false dans config.yml, toutes les commandes joueur sont accessibles sans permission. Les commandes admin nécessitent toujours OP ou teleport.admin.
? Permissions
| Permission |
Description |
Défaut |
teleport.tpa |
Utiliser /tpa |
true |
teleport.tpahere |
Utiliser /tpahere |
true |
teleport.tpaccept |
Utiliser /tpaccept |
true |
teleport.tpdeny |
Utiliser /tpdeny |
true |
teleport.tpcancel |
Utiliser /tpcancel |
true |
teleport.tptoggle |
Utiliser /tptoggle |
true |
teleport.home |
Utiliser /home |
true |
teleport.sethome |
Utiliser /sethome |
true |
teleport.delhome |
Utiliser /delhome |
true |
teleport.warp |
Utiliser /warp |
true |
teleport.warps |
Utiliser /warps |
true |
teleport.setwarp |
Créer/modifier un warp |
op |
teleport.delwarp |
Supprimer n'importe quel warp |
op |
teleport.spawn |
Utiliser /spawn |
true |
teleport.back |
Utiliser /back |
true |
teleport.rtp |
Utiliser /rtp |
true |
teleport.cooldown.bypass |
Ignorer le cooldown de téléportation |
op |
teleport.home.multiple.<n> |
Avoir jusqu'à n homes (ex: .5, .10) |
— |
teleport.admin |
Toutes les permissions admin |
op |
? Messages — messages.yml
Tous les messages utilisent le format MiniMessage d'Adventure. Vous pouvez utiliser des couleurs, effets, liens cliquables, etc.
Placeholders disponibles :
| Placeholder |
Description |
<player> |
Nom d'un joueur |
<home> |
Nom d'un home |
<warp> |
Nom d'un warp |
<delay> |
Délai en secondes |
<max> |
Limite maximale |
<remaining> |
Secondes restantes (cooldown) |
<usage> |
Syntaxe de la commande |
Exemples de personnalisation MiniMessage :
# Couleurs
teleport-success: "<green>Téléportation effectuée !"
# Couleur dégradée
tpa-sent: "<gradient:#55ff55:#00aa00>Demande envoyée à <player></gradient>"
# Texte en gras avec emoji
teleport-pending: "<gold><bold>⏳ Téléportation dans <delay>s... Ne bougez pas !</bold>"
# Lien cliquable (déjà utilisé pour les boutons TPA)
tpa-received-buttons: "<green><click:run_command:/tpaccept>[Accepter]</click>"
?️ Compilation depuis les sources
Prérequis : Java 25, Maven 3.8+
git clone https://github.com/crafteria-dev/EasyTPA.git
cd EasyTPA
mvn package
Le JAR compilé se trouve dans target/easytpa-1.0.0.jar.
? Structure du projet
src/main/java/fr/easytpa/
├── EasyTPA.java # Classe principale, initialisation
├── commands/ # Un fichier par commande (17 commandes)
│ ├── 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/ # Logique métier et persistance
│ ├── ConfigManager.java # Lecture de config.yml
│ ├── MessageManager.java # MiniMessage + préfixe
│ ├── TpaManager.java # Demandes TPA, timeout, toggle
│ ├── TeleportDelayManager.java # Délai, anti-mouvement, cooldown
│ ├── CooldownManager.java # Cooldown global par joueur
│ ├── HomeManager.java # Homes (homes.yml)
│ ├── WarpManager.java # Warps (warps.yml)
│ ├── SpawnManager.java # Spawn (spawn.yml)
│ └── BackManager.java # Position précédente (mémoire)
├── listeners/
│ └── TeleportListener.java # PlayerMove, PlayerDeath, PlayerQuit
└── utils/
├── LocationUtils.java # Sérialisation YAML, vérification sécurité
└── PermissionUtils.java # Vérification permissions joueur/admin
src/main/resources/
├── plugin.yml # Déclaration commandes et permissions
├── config.yml # Configuration principale
└── messages.yml # Messages personnalisables
? Fonctionnement interne
Flux d'une téléportation
- La commande (ex:
/home spawn) appelle TeleportDelayManager.scheduleTeleport()
- Le cooldown est vérifié — si actif, message et abandon
- Le délai anti-mouvement démarre (
teleport-delay secondes)
- Si le joueur bouge → annulation (
PlayerMoveEvent)
- Sinon →
executeTeleport() : sauvegarde la position pour /back, appel async player.teleportAsync()
- En cas de succès → le cooldown est mis à jour, le callback envoie le message de succès
Système de warps
- Chaque warp enregistre l'UUID du créateur (
warps.yml)
- Un joueur ne peut supprimer ou écraser que ses propres warps
- Les admins (
teleport.admin ou OP) peuvent gérer tous les warps
- La limite
max-warps est par joueur (pas globale)
Téléportation aléatoire (/rtp)
- Génère des coordonnées dans un anneau entre
rtp-min-radius et rtp-radius
- Utilise
world.getChunkAtAsync() pour charger les chunks sans bloquer le serveur
- Vérifie la sécurité de la position (2 blocs d'air, sol solide, pas de magma/feu de camp)
- Réessaie jusqu'à
rtp-max-attempts fois si la position n'est pas sûre
? Licence
Ce projet est sous licence Fair Core License (FCL).
- ✅ Utilisation gratuite pour usage personnel et serveurs non commerciaux
- ✅ Modification et redistribution du code source avec attribution
- ❌ Utilisation commerciale (génération de revenus) sans autorisation interdite
Pour toute demande commerciale, contactez ZO3N sur GitHub.
评论 0
登录后参与评分
还没有评论,来抢沙发吧