Documentation (English)
Overview
[Elevador] is a lightweight, modern elevator plugin for Minecraft 1.21+ (Spigot/Paper/Folia).
This project started after testing elevator plugins that felt a bit slow or “heavy”, so I rebuilt the core logic to be as fast and smooth as possible, while keeping it survival-friendly and easy to configure.

Why this plugin

• Fast & smooth teleport
  
  
• Optional cooldowns (off by default)
  
  
• Rank-based cooldowns via LuckPerms permission nodes
  
  
• Instant language switching (auto-detects player client language)
  
  
• Clean feedback (optional ActionBar anti-spam)
  
  
• Works on Spigot / Paper / Folia

Installation

1. Drop the .jar into /plugins/
   
   
2. Start the server once to generate files
   
   
3. Edit config.yml and your lang files if needed
   
   
4. Use /elevador reload after changes

How to use

• Stand on an elevator block:
  • Jump → go up
    
    
  • Sneak → go down

Commands

• /elevador – Main command / help
  
  
• /elevador reload – Reload config + language files
  
  
• /elevador give – Give elevator item (admin)

Permissions

• elevador.use – Use elevators
  
  
• elevador.admin – Admin commands
  
  
• elevador.cooldown.bypass – Ignore cooldowns (optional)

Cooldown ranks (LuckPerms):

• elevador.cooldown.vip
  
  
• elevador.cooldown.member
  (You can create any rank node you want — the plugin reads them from config.)

Configuration (important notes)

• Cooldown is OFF by default (default_ticks: 0)
  
  
• Cooldowns are per-player and only apply when a teleport actually happens
  
  
• ActionBar anti-spam is optional (rate_limit_ticks: 0 disables it)
  
  
• Language sync can be enabled to detect client language changes quickly

LuckPerms example (cooldown by rank)
lp group vip permission set elevador.cooldown.vip true
lp group member permission set elevador.cooldown.member true

Multi-language

• Place your language files in the plugin lang/ folder (example: en_US.yml, es_MX.yml, etc.)
  
  
• The plugin can auto-detect the player’s Minecraft language and swap messages instantly (with locale sync enabled)

Support / Issues
Please report bugs and suggestions on the Spigot discussion page (include server version + plugin version + console logs).

Donations ❤️
If you want to support development:

https://www.paypal.com/paypalme/KinkinxD

Documentación (Español)
Resumen
[Elevador] es un plugin moderno y ligero de elevadores para Minecraft 1.21+ (Spigot/Paper/Folia).
Nació porque probé plugins de elevadores que se sentían algo lentos o pesados, y decidí rehacer el sistema para que fuera lo más rápido y fluido posible, sin romper el survival y con configuración simple.

Por qué este plugin

• Teleport rápido y suave
  
  
• Cooldowns opcionales (apagados por defecto)
  
  
• Cooldown por rangos usando permisos de LuckPerms
  
  
• Cambio de idioma instantáneo (detecta el idioma del Minecraft del jugador)
  
  
• Feedback limpio (anti-spam de ActionBar opcional)
  
  
• Compatible con Spigot / Paper / Folia

Instalación

1. Mete el .jar en /plugins/
   
   
2. Inicia el server para que genere archivos
   
   
3. Edita config.yml y los idiomas si quieres
   
   
4. Usa /elevador reload para aplicar cambios

Cómo se usa

• Párate sobre un elevador:
  • Salta → sube
    
    
  • Agáchate → baja

Comandos

• /elevador – Comando principal / ayuda
  
  
• /elevador reload – Recarga config + idiomas
  
  
• /elevador give – Da el item del elevador (admin)

Permisos

• elevador.use – Usar elevadores
  
  
• elevador.admin – Comandos de admin
  
  
• elevador.cooldown.bypass – Ignorar cooldown (opcional)

Rangos de cooldown (LuckPerms):

• elevador.cooldown.vip
  
  
• elevador.cooldown.member
  (Puedes inventar los que quieras — el plugin los toma desde el config.)

Configuración (notas importantes)

• Cooldown apagado por defecto (default_ticks: 0)
  
  
• El cooldown es por jugador y solo se aplica cuando sí teleporta
  
  
• Anti-spam de ActionBar es opcional (rate_limit_ticks: 0 lo desactiva)
  
  
• El sync de idioma puede detectar cambios de idioma del cliente

Ejemplo LuckPerms (cooldown por rangos)
lp group vip permission set elevador.cooldown.vip true
lp group member permission set elevador.cooldown.member true

Multi-idioma

• Pon tus archivos en la carpeta lang/ (ej: en_US.yml, es_MX.yml, etc.)
  
  
• El plugin puede detectar el idioma del cliente y cambiar mensajes al instante (con locale sync activado)

Soporte / Bugs
Reporta bugs en la discusión de Spigot (incluye versión del server + versión del plugin + logs).

Donaciones ❤️
Si quieres apoyar el desarrollo:

https://www.paypal.com/paypalme/KinkinxD