? RTPLuck
适用于 Minecraft 服务器的随机传送插件,支持可配置的冷却时间、传送延迟以及基于 LuckPerms 组的限制。
✨ 功能特性
- ? 随机传送:在世界中心周围的可配置半径内传送
- ⏱️ 传送延迟:带有屏幕倒计时(动态标题)的传送等待期
- ❄️ 冷却时间:两次使用之间的间隔
- ? 每日使用次数限制:按玩家统计
- ? LuckPerms 集成——根据玩家所属组别应用不同规则
- ? 移动检测——如果玩家在延迟期间移动,传送将被取消
- ?️ 管理员命令——重载配置、重置及查看玩家信息
- ? 100% 可自定义的消息——通过配置文件进行修改
? 前置要求
| 项目 |
版本 |
| 服务端 |
Paper / Spigot |
| Minecraft API |
1.21+ |
| Java |
21+ |
| LuckPerms |
5.4+ |
? 安装步骤
- 下载文件
RTPLucky-2.0.0.jar
- 将其放入你服务端的
plugins/ 文件夹中
- 确保已安装并启用 LuckPerms
- 启动(或重启)服务端
- 在
plugins/RTPLucky/config.yml 中配置插件
- 执行
/rtpadmin reload 进行重载
? 命令
玩家
| 命令 |
描述 |
权限 |
/rtp |
执行随机传送 |
rtp.use |
/randomtp |
/rtp 的别名 |
rtp.use |
管理员
| 指令 |
描述 |
权限 |
/rtpadmin reload |
重新加载配置 |
rtp.admin |
/rtpadmin reset <玩家> |
重置玩家的每日计数 |
rtp.admin |
/rtpadmin info <玩家> |
显示玩家的 RTP 信息 |
rtp.admin |
? 权限
| 权限 |
描述 |
默认值 |
rtp.use |
使用 /rtp |
所有玩家 |
rtp.admin |
访问管理命令 |
OP |
rtp.bypass.cooldown |
忽略冷却时间 |
OP |
rtp.bypass.delay |
瞬间传送(无延迟) |
OP |
⚙️ 配置
config.yml 文件会在首次启动时自动生成。
# 目标世界
world: world
# 距离世界中心的最小/最大半径
min-radius: 500
max-radius: 5000
# 寻找安全位置的最大尝试次数
max-attempts: 10
? LuckPerms 组
规则由 LuckPerms 组定义。应用第一个匹配的组(按照配置文件中的顺序)。
| 字段 |
描述 |
limit |
每天 /rtp 的最大使用次数(-1 = 无限制) |
cooldown |
两次 /rtp 之间的冷却时间,单位为秒(0 = 无冷却) |
delay |
执行命令后到传送开始前的延迟时间,单位为秒(0 = 立即传送) |
groups:
admin:
limit: -1
cooldown: 0
delay: 0
premium:
limit: 30
cooldown: 10
delay: 2
vip:
limit: 15
cooldown: 20
delay: 3
default:
limit: 5
cooldown: 60
delay: 5
⚠️ 组名必须与 LuckPerms 中的名称完全一致(包括大小写)。
?️ 倒计时标题
在传送延迟期间显示。占位符 {time} 将被替换为剩余秒数。
title:
title: "&6✈ Teleportation"
subtitle: "&7dans &e{time}s"
fade-in: 5
stay: 22
fade-out: 5
? 消息
所有消息均可自定义。支持 Minecraft 颜色代码(&6、&a 等)。
| 占位符 |
描述 |
{delay} |
传送延迟时间(秒) |
{time} |
剩余时间(冷却或延迟) |
{x}, {z} |
目标坐标 |
{used} |
今日使用次数 |
{limit} |
群组每日限制 |
{group} |
LuckPerms 组名 |
{player} |
玩家名称(管理员命令) |
{cooldown}, {remaining} |
总冷却时间和剩余时间(管理员信息) |
?️ 构建(适用于开发者)
git clone <repo>
cd RTPLucky
mvn clean package
最终的 .jar 文件位于 target/RTPLucky-2.0.0.jar。
技术栈:
- Java 21
- Paper API 1.21.1
- LuckPerms API 5.4
- Maven + maven-shade-plugin
? 项目结构
fr/rtpplugin/rtp/
├── RTPPlugin.java # 主类
├── commands/
│ ├── RTPCommand.java # /rtp 命令
│ └── RTPAdminCommand.java # /rtpadmin 命令
├── managers/
│ ├── CooldownManager.java # 冷却管理
│ ├── TeleportManager.java # 传送逻辑与延迟
│ └── UsageManager.java # 每日使用计数器
└── utils/
├── LuckPermsUtil.java # 获取 LuckPerms 组
├── MessageUtil.java # 消息格式化
└── TeleportUtil.java # 安全位置查找
? 许可证
本插件免费分发。你可以自由修改并根据你的服务器进行调整。
#? RTPLucky v2.0.0
随机传送插件,适用于 Minecraft 服务器,支持可配置的冷却时间、传送延迟以及基于 LuckPerms 的分组限制。
✨ 功能特性
- ? 随机传送:在世界中心周围的可配置半径内
- ⏱️ 传送延迟:带有屏幕倒计时动画标题
- ❄️ 冷却时间:两次使用之间的间隔
- ? 每日使用限制:每位玩家的每日使用次数上限
- ? LuckPerms 集成:根据玩家所属组别应用不同规则
- ? 移动检测:如果在延迟期间玩家发生移动,则取消传送
- ?️ 管理员命令:支持重新加载配置、重置以及查询玩家信息
- ? 100% 可自定义消息:通过配置文件进行设置
? 前置要求
| 项目 |
版本 |
| 服务器端 |
Paper / Spigot |
| Minecraft API |
1.21+ |
| Java |
21+ |
| LuckPerms |
5.4+ |
? 安装
- 下载文件
RTPLucky-2.0.0.jar
- 将其放入服务器的
plugins/ 文件夹中
- 确保已安装并启用 LuckPerms
- 启动(或重启)服务器
- 在
plugins/RTPLucky/config.yml 中配置插件
- 使用
/rtpadmin reload 命令重载
? 命令
玩家
| 命令 |
描述 |
权限 |
/rtp |
执行随机传送 |
rtp.use |
/randomtp |
/rtp 的别名 |
rtp.use |
管理员
| 命令 |
描述 |
权限 |
/rtpadmin reload |
重载配置 |
rtp.admin |
/rtpadmin reset <玩家> |
重置玩家的每日计数 |
rtp.admin |
/rtpadmin info <玩家> |
显示玩家的 RTP 信息 |
rtp.admin |
? 权限
| 权限 |
描述 |
默认值 |
rtp.use |
使用 /rtp |
所有玩家 |
rtp.admin |
管理命令访问权限 |
OP |
rtp.bypass.cooldown |
忽略冷却时间 |
OP |
rtp.bypass.delay |
即时传送(无延迟) |
OP |
⚙️ 配置
config.yml 文件会在首次启动时自动生成。
# 用于传送的目标世界
world: world
# 距离世界中心的最大/最小半径
min-radius: 500
max-radius: 5000
# 寻找安全位置的最大尝试次数
max-attempts: 10
? LuckPerms 组
规则按 LuckPerms 组定义。第一个匹配到的组(按照配置中的顺序)将生效。
| 字段 |
描述 |
limit |
每天 /rtp 的最大次数(-1 = 无限制) |
cooldown |
两次 /rtp 之间的冷却时间(秒)(0 = 无冷却) |
delay |
执行命令后到传送开始前的延迟时间(秒)(0 = 立即传送) |
groups:
admin:
limit: -1
cooldown: 0
delay: 0
premium:
limit: 30
cooldown: 10
delay: 2
vip:
limit: 15
cooldown: 20
delay: 3
default:
limit: 5
cooldown: 60
delay: 5
⚠️ 组名必须与 LuckPerms 中的名称完全一致(注意大小写)。
?️ 倒计时标题
在传送延迟期间显示。占位符 {time} 会被替换为剩余秒数。
title:
title: "&6✈ 传送"
subtitle: "&7将于 &e{time}秒后&7执行"
fade-in: 5
stay: 22
fade-out: 5
? 消息
所有消息均可自定义。支持 Minecraft 颜色代码(&6、&a 等)。
| 占位符 |
描述 |
{delay} |
传送延迟时间(秒) |
{time} |
剩余时间(冷却或延迟) |
{x}, {z} |
目的地坐标 |
{used} |
今日已使用次数 |
{limit} |
群组每日上限 |
{group} |
LuckPerms 群组名称 |
{player} |
玩家名称(管理员命令) |
{cooldown}, {remaining} |
总冷却时间和剩余时间(管理员信息) |
?️ 构建(面向开发者)
git clone <repo>
cd RTPLucky
mvn clean package
最终的 .jar 文件位于 target/RTPLucky-2.0.0.jar。
技术栈:
- Java 21
- Paper API 1.21.1
- LuckPerms API 5.4
- Maven + maven-shade-plugin
? 项目结构
fr/rtpplugin/rtp/
├── RTPPlugin.java # 主类
├── commands/
│ ├── RTPCommand.java # /rtp 命令
│ └── RTPAdminCommand.java # /rtpadmin 命令
├── managers/
│ ├── CooldownManager.java # 冷却时间管理
│ ├── TeleportManager.java # 传送逻辑与延迟处理
│ └── UsageManager.java # 每日使用次数统计
└── utils/
├── LuckPermsUtil.java # 获取 LuckPerms 用户组
├── MessageUtil.java # 消息格式化
└── TeleportUtil.java # 安全位置查找
? 许可证
本插件免费分发。你可以自由修改并根据你的服务器需求进行调整。
? RTPLuck
Plugin de téléportation aléatoire pour serveurs Minecraft, avec cooldown configurable, délai de téléportation et limites par groupe LuckPerms.
✨ Fonctionnalités
- ? Téléportation aléatoire dans un rayon configurable autour du centre du monde
- ⏱️ Délai de téléportation avec compte à rebours à l'écran (titre animé)
- ❄️ Cooldown entre deux utilisations
- ? Limite quotidienne d'utilisations par joueur
- ? Intégration LuckPerms — règles différentes selon le groupe du joueur
- ? Détection de mouvement — la téléportation est annulée si le joueur bouge pendant le délai
- ?️ Commandes admin — rechargement de la config, reset et consultation des infos d'un joueur
- ? Messages 100 % personnalisables depuis le fichier de configuration
? Prérequis
| Élément |
Version |
| Serveur |
Paper / Spigot |
| API Minecraft |
1.21+ |
| Java |
21+ |
| LuckPerms |
5.4+ |
? Installation
- Télécharge le fichier
RTPLucky-2.0.0.jar
- Dépose-le dans le dossier
plugins/ de ton serveur
- Assure-toi que LuckPerms est installé et actif
- Démarre (ou redémarre) le serveur
- Configure le plugin dans
plugins/RTPLucky/config.yml
- Recharge avec
/rtpadmin reload
? Commandes
Joueur
| Commande |
Description |
Permission |
/rtp |
Lance une téléportation aléatoire |
rtp.use |
/randomtp |
Alias de /rtp |
rtp.use |
Admin
| Commande |
Description |
Permission |
/rtpadmin reload |
Recharge la configuration |
rtp.admin |
/rtpadmin reset <joueur> |
Réinitialise le compteur quotidien d'un joueur |
rtp.admin |
/rtpadmin info <joueur> |
Affiche les infos RTP d'un joueur |
rtp.admin |
? Permissions
| Permission |
Description |
Défaut |
rtp.use |
Utiliser /rtp |
Tous les joueurs |
rtp.admin |
Accès aux commandes admin |
OP |
rtp.bypass.cooldown |
Ignorer le cooldown |
OP |
rtp.bypass.delay |
Téléportation instantanée (sans délai) |
OP |
⚙️ Configuration
Le fichier config.yml est généré automatiquement au premier démarrage.
# Monde cible pour la téléportation
world: world
# Rayon min/max depuis le centre du monde
min-radius: 500
max-radius: 5000
# Nombre max de tentatives pour trouver un endroit sûr
max-attempts: 10
? Groupes LuckPerms
Les règles sont définies par groupe LuckPerms. Le premier groupe correspondant (dans l'ordre de la config) est appliqué.
| Champ |
Description |
limit |
Nombre max de /rtp par jour (-1 = illimité) |
cooldown |
Secondes entre deux /rtp (0 = aucun) |
delay |
Secondes avant la téléportation après la commande (0 = instantané) |
groups:
admin:
limit: -1
cooldown: 0
delay: 0
premium:
limit: 30
cooldown: 10
delay: 2
vip:
limit: 15
cooldown: 20
delay: 3
default:
limit: 5
cooldown: 60
delay: 5
⚠️ Le nom du groupe doit correspondre exactement au nom dans LuckPerms (respect de la casse).
?️ Titre de compte à rebours
Affiché pendant le délai de téléportation. Le placeholder {time} est remplacé par les secondes restantes.
title:
title: "&6✈ Téléportation"
subtitle: "&7dans &e{time}s"
fade-in: 5
stay: 22
fade-out: 5
? Messages
Tous les messages sont personnalisables. Les codes couleur Minecraft (&6, &a, etc.) sont supportés.
| Placeholder |
Description |
{delay} |
Délai de téléportation en secondes |
{time} |
Temps restant (cooldown ou délai) |
{x}, {z} |
Coordonnées de destination |
{used} |
Nombre d'utilisations du jour |
{limit} |
Limite quotidienne du groupe |
{group} |
Nom du groupe LuckPerms |
{player} |
Nom du joueur (commandes admin) |
{cooldown}, {remaining} |
Cooldown total et temps restant (admin info) |
?️ Build (pour les développeurs)
git clone <repo>
cd RTPLucky
mvn clean package
Le .jar final se trouve dans target/RTPLucky-2.0.0.jar.
Stack technique :
- Java 21
- Paper API 1.21.1
- LuckPerms API 5.4
- Maven + maven-shade-plugin
? Structure du projet
fr/rtpplugin/rtp/
├── RTPPlugin.java # Classe principale
├── commands/
│ ├── RTPCommand.java # Commande /rtp
│ └── RTPAdminCommand.java # Commande /rtpadmin
├── managers/
│ ├── CooldownManager.java # Gestion des cooldowns
│ ├── TeleportManager.java # Logique de téléportation & délai
│ └── UsageManager.java # Compteur d'utilisations quotidiennes
└── utils/
├── LuckPermsUtil.java # Récupération du groupe LuckPerms
├── MessageUtil.java # Formatage des messages
└── TeleportUtil.java # Recherche de position sûre
? Licence
Ce plugin est distribué librement. Tu es libre de le modifier et de l'adapter à ton serveur.
#? RTPLucky v2.0.0
Plugin de téléportation aléatoire pour serveurs Minecraft, avec cooldown configurable, délai de téléportation et limites par groupe LuckPerms.
✨ Fonctionnalités
- ? Téléportation aléatoire dans un rayon configurable autour du centre du monde
- ⏱️ Délai de téléportation avec compte à rebours à l'écran (titre animé)
- ❄️ Cooldown entre deux utilisations
- ? Limite quotidienne d'utilisations par joueur
- ? Intégration LuckPerms — règles différentes selon le groupe du joueur
- ? Détection de mouvement — la téléportation est annulée si le joueur bouge pendant le délai
- ?️ Commandes admin — rechargement de la config, reset et consultation des infos d'un joueur
- ? Messages 100 % personnalisables depuis le fichier de configuration
? Prérequis
| Élément |
Version |
| Serveur |
Paper / Spigot |
| API Minecraft |
1.21+ |
| Java |
21+ |
| LuckPerms |
5.4+ |
? Installation
- Télécharge le fichier
RTPLucky-2.0.0.jar
- Dépose-le dans le dossier
plugins/ de ton serveur
- Assure-toi que LuckPerms est installé et actif
- Démarre (ou redémarre) le serveur
- Configure le plugin dans
plugins/RTPLucky/config.yml
- Recharge avec
/rtpadmin reload
? Commandes
Joueur
| Commande |
Description |
Permission |
/rtp |
Lance une téléportation aléatoire |
rtp.use |
/randomtp |
Alias de /rtp |
rtp.use |
Admin
| Commande |
Description |
Permission |
/rtpadmin reload |
Recharge la configuration |
rtp.admin |
/rtpadmin reset <joueur> |
Réinitialise le compteur quotidien d'un joueur |
rtp.admin |
/rtpadmin info <joueur> |
Affiche les infos RTP d'un joueur |
rtp.admin |
? Permissions
| Permission |
Description |
Défaut |
rtp.use |
Utiliser /rtp |
Tous les joueurs |
rtp.admin |
Accès aux commandes admin |
OP |
rtp.bypass.cooldown |
Ignorer le cooldown |
OP |
rtp.bypass.delay |
Téléportation instantanée (sans délai) |
OP |
⚙️ Configuration
Le fichier config.yml est généré automatiquement au premier démarrage.
# Monde cible pour la téléportation
world: world
# Rayon min/max depuis le centre du monde
min-radius: 500
max-radius: 5000
# Nombre max de tentatives pour trouver un endroit sûr
max-attempts: 10
? Groupes LuckPerms
Les règles sont définies par groupe LuckPerms. Le premier groupe correspondant (dans l'ordre de la config) est appliqué.
| Champ |
Description |
limit |
Nombre max de /rtp par jour (-1 = illimité) |
cooldown |
Secondes entre deux /rtp (0 = aucun) |
delay |
Secondes avant la téléportation après la commande (0 = instantané) |
groups:
admin:
limit: -1
cooldown: 0
delay: 0
premium:
limit: 30
cooldown: 10
delay: 2
vip:
limit: 15
cooldown: 20
delay: 3
default:
limit: 5
cooldown: 60
delay: 5
⚠️ Le nom du groupe doit correspondre exactement au nom dans LuckPerms (respect de la casse).
?️ Titre de compte à rebours
Affiché pendant le délai de téléportation. Le placeholder {time} est remplacé par les secondes restantes.
title:
title: "&6✈ Téléportation"
subtitle: "&7dans &e{time}s"
fade-in: 5
stay: 22
fade-out: 5
? Messages
Tous les messages sont personnalisables. Les codes couleur Minecraft (&6, &a, etc.) sont supportés.
| Placeholder |
Description |
{delay} |
Délai de téléportation en secondes |
{time} |
Temps restant (cooldown ou délai) |
{x}, {z} |
Coordonnées de destination |
{used} |
Nombre d'utilisations du jour |
{limit} |
Limite quotidienne du groupe |
{group} |
Nom du groupe LuckPerms |
{player} |
Nom du joueur (commandes admin) |
{cooldown}, {remaining} |
Cooldown total et temps restant (admin info) |
?️ Build (pour les développeurs)
git clone <repo>
cd RTPLucky
mvn clean package
Le .jar final se trouve dans target/RTPLucky-2.0.0.jar.
Stack technique :
- Java 21
- Paper API 1.21.1
- LuckPerms API 5.4
- Maven + maven-shade-plugin
? Structure du projet
fr/rtpplugin/rtp/
├── RTPPlugin.java # Classe principale
├── commands/
│ ├── RTPCommand.java # Commande /rtp
│ └── RTPAdminCommand.java # Commande /rtpadmin
├── managers/
│ ├── CooldownManager.java # Gestion des cooldowns
│ ├── TeleportManager.java # Logique de téléportation & délai
│ └── UsageManager.java # Compteur d'utilisations quotidiennes
└── utils/
├── LuckPermsUtil.java # Récupération du groupe LuckPerms
├── MessageUtil.java # Formatage des messages
└── TeleportUtil.java # Recherche de position sûre
? Licence
Ce plugin est distribué librement. Tu es libre de le modifier et de l'adapter à ton serveur.
评论 0
登录后参与评分
还没有评论,来抢沙发吧