RtpLuck

🌍 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

1. Télécharge le fichier RTPLucky-2.0.0.jar
2. Dépose-le dans le dossier plugins/ de ton serveur
3. Assure-toi que LuckPerms est installé et actif
4. Démarre (ou redémarre) le serveur
5. Configure le plugin dans plugins/RTPLucky/config.yml
6. 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

1. Télécharge le fichier RTPLucky-2.0.0.jar
2. Dépose-le dans le dossier plugins/ de ton serveur
3. Assure-toi que LuckPerms est installé et actif
4. Démarre (ou redémarre) le serveur
5. Configure le plugin dans plugins/RTPLucky/config.yml
6. 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.