🌍 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.
Сервер для плагина RtpLuck - как у профи
Плагин RtpLuck создан для серверов: на своём сервере вы настраиваете его под себя и решаете, кому играть. Создать сервер с плагином RtpLuck для друзей можно за пару минут - BungeeHost всё уже подготовил.