How do I install RtpLuck?

Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. Download the .jar. Put it in the .minecraft/mods folder and launch that loader profile. Opens on Modrinth — not every file is mirrored on our own servers.

What Minecraft version does RtpLuck work with?

The listing gives Minecraft 1.21, 1.21.1, 1.21.2, among others. This is the version stated by the author or source site, not something we verified ourselves.

Home›Java›Mods›RtpLuck

ModsJava

RtpLuck

by Xaturox_offi · on Modrinth

⬇ Download on Modrinth

Open in MC Java Mods Get it on Google Play →

🌍 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