The Smooth Elevator

Fast, smooth, and survival-friendly elevators. Automatically detects player language and features per-rank cooldowns with LuckPerms.

108

The Smooth Elevator

[The Smooth Elevator] - Modern Elevator Plugin

Logo

Documentation (English)

📋 Overview

Minecraft 1.21+ is a lightweight, modern elevator plugin for Minecraft 1.21+ (Spigot/Paper/Folia).

This project was born to solve the "heavy" or slow feeling of older plugins, focusing on speed, smoothness, and survival-friendliness.

✨ Key Features

* 🚀 Multi-Platform: Optimized teleportation logic. * ⏳ Multi-Platform: Disabled by default for maximum freedom. * 🎖️ Multi-Platform: Integration with Multi-Platform: permission nodes. * 🌍 Multi-Platform: Automatically detects the player's client language. * 💬 Multi-Platform: Optional ActionBar anti-spam system. * 🏗️ Multi-Platform: Native support for Spigot, Paper, and Folia.

🛠️ Installation

1. Drop the `.jar` file into your `/plugins/` folder. 2. Start the server to generate configuration files. 3. Edit `config.yml` and your language files in the `/lang/` folder. 4. Run `/elevador reload` to apply changes.

🎮 How to Use

Stand on an elevator block and:

* Sneak → Teleport Up. * Sneak → Teleport Down.

💻 Commands & Permissions

| Command | Description | Permission | | --- | --- | --- | | `/elevador` | Main command & help menu | `elevador.use` | | `/elevador reload` | Reload config and lang files | `elevador.admin` | | `/elevador give` | Give elevator item (Admin) | `elevador.admin` |

> Note: Use `elevador.cooldown.bypass` to ignore all teleport delays.

⚙️ Configuration Notes

* LuckPerms Example: Controlled via `default_ticks: 0`. They only apply after a successful teleport. * LuckPerms Example: ActionBar messages can be limited with `rate_limit_ticks`. * LuckPerms Example: ```bash /lp group vip permission set elevador.cooldown.vip true /lp group member permission set elevador.cooldown.member true

```

Config.yml

``` cooldowns: by_permission: elevador.cooldown.vip: 15 elevador.cooldown.vipplus: 10 ```

🆘 Support & Donations

* Support the dev: Report issues on the Support the dev: (include version & logs). * Support the dev: Support the dev:

⚙️ Elevator Essentials — Advanced Crafting Guide

Spoiler

---

Crafting Guide

Elevator Essentials now includes a much more powerful and user-friendly Recipe GUI, allowing administrators to create custom elevator recipes directly in-game without having to manually build complex config sections.

This system supports simple recipes, multi-step crafting chains, custom parts, final elevators, shaped and shapeless recipes, exact material cost recipes, result item editing, result amount editing, and colored final elevators.

You can now create progression systems like:

* A + B = Part C * D + E = Part F * C + F = Elevator

Or much larger crafting trees such as:

* A + B = C * D + E = F * C + F = G * G + A = H * H + F = Elevator

This makes Elevator Essentials much more flexible for survival servers, RPG progression, technology trees, or modpack-style crafting systems.

---

Creating Recipes with the GUI

To open the recipe editor, use:

`/elevador recipe`

This opens the new Recipe Browser GUI, where administrators can create, edit, and delete recipes in a much more intuitive way.

From the Recipe Browser you can:

* Create a new recipe * Open existing recipes * Delete recipes with shift-click * Manage both intermediate parts and final elevator recipes

---

Recipe Editor Features

Inside the editor, administrators can fully configure the recipe through the GUI.

Supported features:

* Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs * Custom names for recipe parts and outputs

---

Shaped and Shapeless Recipes

Each recipe can be configured as either:

Shaped

The item layout in the crafting grid matters.

Example:

* Redstone in the center only is different from * Redstone in the top-left

Shapeless

The layout does not matter. Only the required ingredients matter.

This is useful for simpler recipes where position should not affect the result.

---

Vanilla Amount Mode vs Exact Cost Mode

Recipes can also use two different ingredient cost systems:

Vanilla Amount Mode

This behaves like normal Minecraft crafting.

If a slot requires an item, Minecraft only checks that the correct ingredient is present. The amount in that slot does not matter beyond normal vanilla crafting behavior.

Exact Cost Mode

This mode allows a recipe to consume the exact saved amount for each slot.

Example:

* If a recipe slot is saved with 60 * and the player places 60 * crafting will consume 60, leaving 60

This allows administrators to create much more expensive and controlled recipes without needing awkward workarounds.

---

Result Types

Each recipe can produce one of two result types:

Part

Creates a custom elevator part that can be used in later recipes.

This is ideal for multi-step progression systems where players must craft components before reaching the final elevator.

Elevator

Creates the final elevator item itself.

When the result type is set to Elevator, administrators can also choose the elevator color directly from the GUI.

---

Result Item and Result Amount

The editor also allows administrators to:

* Choose the result amount used as the recipe result * Set the result amount * Rename the output item * Create custom intermediate parts with different materials and names

This means you are not limited to a single generic part style. You can create multiple unique crafting components for more advanced progression.

---

Multi-Step Crafting Chains

The system fully supports chained crafting progression.

Example:

* Iron Block + Redstone Block → Part A * Redstone Torch + Piston → Part B * Part A + Part B → Elevator

You can keep expanding this as much as you want:

* A + B → C * C + D → E * E + F → G * G + H → Elevator

This makes it possible to build very simple or very advanced crafting trees depending on your server design.

---

Custom Items Support

Because recipes are now built directly from item stacks in the GUI, this system works naturally with:

* Vanilla items * Custom items from supported plugins * Intermediate parts created by Elevator Essentials

This gives administrators far more flexibility when designing unique progression systems.

---

Recipe Management

Recipes are now much easier to manage.

Admins can:

* Open the recipe browser in-game * Edit recipes visually * Delete old recipes * Create new crafting chains without manually writing recipe sections by hand

This makes the system much more practical for servers that want to expand elevator progression over time.

---

Reloading Changes

After making recipe changes, use:

`/elevador reload`

This reloads the plugin configuration and registered recipes.

---

Compatibility

Minecraft 1.21+

Fully compatible with:

* Folia * Folia * Folia

The recipe system and elevator logic are designed to remain lightweight, practical, and survival-friendly.

---

Summary

Elevator Essentials now provides a much more advanced and administrator-friendly crafting system through its new Recipe GUI.

You can now:

* Create recipes in-game * Build multi-step crafting chains * Use shaped or shapeless recipes * Use vanilla or exact per-slot costs * Create custom parts * Set custom result items and amounts * Create final elevators with selectable colors * Manage everything in a cleaner and faster way

This makes Elevator Essentials far more flexible for survival progression, RPG systems, and custom server economies. ---

---

Documentación (Español)

📋 Resumen

Minecraft 1.21+ es un plugin moderno y ligero para Minecraft 1.21+ (Spigot/Paper/Folia).

Diseñado para ser lo más rápido y fluido posible, manteniendo una experiencia puramente *survival* y una configuración sencilla.

✨ Características Principales

* 🚀 Compatibilidad: Lógica optimizada para evitar tirones. * ⏳ Compatibilidad: Apagados por defecto. * 🎖️ Compatibilidad: Define tiempos diferentes usando permisos de Compatibilidad:. * 🌍 Compatibilidad: Detecta automáticamente el idioma del Minecraft del jugador. * 💬 Compatibilidad: Sistema de ActionBar opcional para evitar el spam en el chat. * 🏗️ Compatibilidad: Funciona perfectamente en Spigot, Paper y Folia.

🛠️ Instalación

1. Copia el archivo `.jar` en la carpeta `/plugins/`. 2. Inicia el servidor para generar los archivos base. 3. Edita el `config.yml` y los archivos en la carpeta `/lang/` a tu gusto. 4. Usa `/elevador reload` para aplicar los cambios sin reiniciar.

🎮 Modo de Uso

Párate sobre un bloque de elevador y:

* Agáchate → Subir. * Agáchate → Bajar.

💻 Comandos y Permisos

| Comando | Descripción | Permiso | | --- | --- | --- | | `/elevador` | Comando principal y ayuda | `elevador.use` | | `/elevador reload` | Recarga la configuración | `elevador.admin` | | `/elevador give` | Entrega el ítem del elevador | `elevador.admin` |

⚙️ Notas de Configuración

* Ejemplo LuckPerms: Se define en *ticks* (`default_ticks: 0`). Solo se activa tras un teleport exitoso. * Ejemplo LuckPerms: Si está activo, el plugin traduce los mensajes según el cliente del jugador (ej: `es_MX.yml`, `en_US.yml`). * Ejemplo LuckPerms: ```bash /lp group vip permission set elevador.cooldown.vip true /lp group member permission set elevador.cooldown.member true

```

Config.yml

``` cooldowns: by_permission: elevador.cooldown.vip: 15 elevador.cooldown.vipplus: 10 ```

⚙️ Elevator Essentials — Guía de creación avanzada

Spoiler

Guía de Crafteo

Elevator Essentials ahora incluye una nueva GUI de recetas mucho más potente y amigable, permitiendo a los administradores crear recetas personalizadas directamente dentro del juego sin tener que construir configuraciones complejas a mano.

Este sistema soporta recetas simples, cadenas de crafteo de varios pasos, partes personalizadas, elevadores finales, recetas shapeless y shapeless, recetas con costo exacto por slot, cambio del ítem resultado, cambio de cantidad del resultado y selección del color del elevador final.

Ahora puedes crear progresiones como:

* A + B = Parte C * D + E = Parte F * C + F = Elevador

O árboles de crafteo más grandes como:

* A + B = C * D + E = F * C + F = G * G + A = H * H + F = Elevador

Esto hace que Elevator Essentials sea mucho más flexible para servidores survival, progresión RPG, árboles tecnológicos o sistemas de crafteo estilo modpack.

---

Crear recetas con la GUI

Para abrir el editor de recetas usa:

`/elevador recipe`

Esto abrirá la nueva GUI de recetas, donde los administradores pueden crear, editar y borrar recetas de una forma mucho más intuitiva.

Desde el navegador de recetas puedes:

* Crear una nueva receta * Abrir recetas existentes * Borrar recetas con shift-click * Administrar tanto partes intermedias como recetas del elevador final

---

Funciones del editor de recetas

Dentro del editor, los administradores pueden configurar completamente la receta desde la GUI.

Funciones soportadas:

* Recetas Elevador final * Recetas Elevador final * Modo de cantidades Elevador final * Modo de costo exacto por slot * Selección personalizada del ítem resultado * Cantidad personalizada del resultado * Resultado tipo Elevador final * Resultado tipo Elevador final * Selección del color del elevador final * Nombres personalizados para partes y resultados

---

Recetas Shaped y Shapeless

Cada receta puede configurarse como:

Shaped

La posición de los ítems en la mesa de crafteo importa.

Ejemplo:

* Redstone en el centro no es lo mismo que * Redstone en la esquina superior izquierda

Shapeless

La posición no importa. Solo importan los ingredientes requeridos.

Esto es útil para recetas más simples donde la forma no debe afectar el resultado.

---

Modo Vanilla vs Modo de costo exacto

Las recetas también pueden usar dos sistemas distintos de costo de ingredientes.

Modo Vanilla

Se comporta como el crafteo normal de Minecraft.

Si un slot requiere un ítem, Minecraft solo verifica que el ingrediente correcto esté presente. La cantidad en ese slot no importa más allá del comportamiento vanilla normal.

Modo de costo exacto por slot

Este modo permite que la receta consuma exactamente la cantidad guardada en cada slot.

Ejemplo:

* Si una receta guarda 60 en un slot * y el jugador coloca 60 * al craftear se consumirán 60, dejando 60

Esto permite crear recetas mucho más caras y controladas sin tener que usar soluciones raras.

---

Tipos de resultado

Cada receta puede producir uno de dos tipos de resultado:

Parte

Crea una parte personalizada del elevador que puede usarse en recetas posteriores.

Esto es ideal para sistemas de progresión por pasos, donde los jugadores deben fabricar componentes antes de llegar al elevador final.

Elevador

Crea directamente el ítem final del elevador.

Cuando el resultado está configurado como Elevador, los administradores también pueden elegir su color directamente desde la GUI.

---

Ítem resultado y cantidad resultado

El editor también permite:

* Elegir el cantidad del resultado que será el resultado * Configurar la cantidad del resultado * Renombrar el resultado * Crear partes intermedias personalizadas con distintos materiales y nombres

Esto significa que no estás limitado a una sola parte genérica. Puedes crear múltiples componentes únicos para una progresión mucho más avanzada.

---

Cadenas de crafteo de varios pasos

El sistema soporta completamente progresión por cadenas de crafteo.

Ejemplo:

* Bloque de hierro + bloque de redstone → Parte A * Antorcha de redstone + pistón → Parte B * Parte A + Parte B → Elevador

Y puedes seguir expandiéndolo tanto como quieras:

* A + B → C * C + D → E * E + F → G * G + H → Elevador

Esto permite construir árboles de crafteo simples o muy avanzados dependiendo del diseño de tu servidor.

---

Soporte para ítems personalizados

Como las recetas ahora se construyen directamente desde ítems colocados en la GUI, este sistema funciona de forma natural con:

* Ítems vanilla * Ítems personalizados de plugins compatibles * Partes intermedias creadas por Elevator Essentials

Esto da mucha más libertad al administrador para diseñar sistemas de progresión únicos.

---

Administración de recetas

Las recetas ahora son mucho más fáciles de administrar.

Los administradores pueden:

* Abrir el navegador de recetas dentro del juego * Editar recetas visualmente * Borrar recetas antiguas * Crear nuevas cadenas de crafteo sin escribir configuraciones complejas a mano

Esto hace que el sistema sea mucho más práctico para servidores que quieran expandir la progresión de elevadores con el tiempo.

---

Recargar cambios

Después de hacer cambios en las recetas, usa:

`/elevador reload`

Esto recarga la configuración del plugin y las recetas registradas.

---

Compatibilidad

Minecraft 1.21+

Compatible completamente con:

* Folia * Folia * Folia

El sistema de recetas y el funcionamiento de los elevadores están diseñados para seguir siendo ligeros, prácticos y amigables con survival.

---

Resumen

Elevator Essentials ahora ofrece un sistema de recetas mucho más avanzado y amigable para administradores gracias a su nueva GUI.

Ahora puedes:

* Crear recetas dentro del juego * Construir cadenas de crafteo de varios pasos * Usar recetas shaped o shapeless * Usar costos vanilla o costos exactos por slot * Crear partes personalizadas * Elegir ítems resultado y cantidades * Crear elevadores finales con color seleccionable * Administrar todo de una forma mucho más rápida, limpia y cómoda

Esto hace que Elevator Essentials sea mucho más flexible para progresión survival, sistemas RPG y economías personalizadas de servidor.

---

ADS