RtpLuck - CraftHub

🌍 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