The Smooth Elevator

# - Modern Elevator Plugin !(https://res.cloudinary.com/dhgdy73up/image/upload/v1772740870/Elevador_f2npvy.png) ## Documentation (English) ### 📋 Overview **** 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:** ```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 * **Bugs:** Report issues on the **Spigot Discussion page** (include version & logs). * **Support the dev:** (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*