The Smooth Elevator

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： folia paper purpur spigot

标签： decoration game-mechanics utility

[The Smooth Elevator] - Modern Elevator Plugin

Documentation (English)

? Overview

[The Smooth Elevator] 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

• ? Fast & Smooth: Optimized teleportation logic.
• ⏳ Optional Cooldowns: Disabled by default for maximum freedom.
• ?️ Rank-based Cooldowns: Integration with LuckPerms permission nodes.
• ? Instant Language Switching: Automatically detects the player's client language.
• ? Clean Feedback: 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:

• Jump → 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

• Cooldowns: Controlled via default_ticks: 0. They only apply after a successful teleport.
• Anti-Spam: ActionBar messages can be limited with rate_limit_ticks.
• LuckPerms Example:

  
  /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

* **Bugs:** Report issues on the **Spigot Discussion page** (include version & logs).
* **Support the dev:** [Donate via PayPal ❤️](https://www.paypal.com/paypalme/KinkinxD)

### ⚙️ Elevator Essentials — Advanced Crafting Guide


<details>
<summary>Spoiler</summary>

---
## 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:

* **Shaped recipes**
* **Shapeless recipes**
* **Vanilla amount mode**
* **Per-slot exact cost mode**
* **Custom result item selection**
* **Custom result amount**
* **Part result type**
* **Final elevator result type**
* **Final elevator color selection**
* **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 **4 Redstone Blocks**
* and the player places **64 Redstone Blocks**
* crafting will consume **4**, 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 **exact item** 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:

* **Spigot**
* **Paper**
* **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.
---

</details>



---

## Documentación (Español)

### ? Resumen

**[The Smooth Elevator]** 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

* ? **Teleport Suave:** Lógica optimizada para evitar tirones.
* ⏳ **Cooldowns Opcionales:** Apagados por defecto.
* ?️ **Rangos de Cooldown:** Define tiempos diferentes usando permisos de **LuckPerms**.
* ? **Multi-idioma Instantáneo:** Detecta automáticamente el idioma del Minecraft del jugador.
* ? **Feedback Limpio:** 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:

* **Salta** → 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

* **Cooldown:** Se define en *ticks* (`default_ticks: 0`). Solo se activa tras un teleport exitoso.
* **Sincronización de Idioma:** 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 **shaped** 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 **Shaped** * Recetas **Shapeless** * Modo de cantidades **Vanilla** * Modo de costo exacto por slot * Selección personalizada del ítem resultado * Cantidad personalizada del resultado * Resultado tipo **Parte** * 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 **4 bloques de redstone** en un slot * y el jugador coloca **64 bloques de redstone** * al craftear se consumirán **4**, 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 **ítem exacto** 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: * **Spigot** * **Paper** * **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.

---