Elevator
Last Update: 1.1 [1.21+ compatible] [1.21.11 tested]

A simple, high-performance, and fully customizable elevator solution for your server. Optimized for Paper 1.21.11 and latest Minecraft versions.



Main Features
│➜ Multi-Block Support: Configure any material (Iron, Gold, Diamond,
│➜ etc.) to act as an elevator.
│➜ Vertical Teleportation: Intuitive mechanics:
│➜ Jump to go up and Sneak to go down between floors.
│➜ Smart Floor Detection: Automatically scans for valid floors with
│➜ safe space (2 blocks of air) for players.
│➜ Creation Announcements: Notifies the entire server when
│➜ a new elevator with 2+ floors is built.
│➜ Discord Webhook Integration: Built-in async system to send
│➜ real-time creation alerts to your Discord channel.
│➜ Custom Sound Effects: Independent sounds for up and down
│➜ movements (Shulker/Piston default) with adjustable pitch.
│➜ Audible Range: High-volume 2.0 setting allows players within
│➜ 32 blocks (2 chunks) to hear the elevator.
│➜ Dimension Aware: Respects world height limits for Overworld
│➜ (-64 to 320), Nether, and The End.
│➜ ExternalTranslations: Dedicated messages_en.yml and
│➜ messages_pt.yml files for full control.
│➜ Optimized Performance: Runs heavy tasks (Discord/Teleport) asynchronously to ensure zero TPS spikes.

Commands
│➜ /elevator Shows plugin info, creator (comonier), version,
│➜ and help menu.
│➜ /elevator reload Instantly reloads configurations, sounds,
│➜ and all language files.

Permissions
│➜ elevator.use Basic permission to use the elevator blocks
│➜ (Default: Everyone).
│➜ elevator.admin Master permission to reload the plugin
│➜ and manage settings.

Configuration (config.yml)
│➜ block-types: Define a list of materials that will function as
│➜ elevators.
│➜ require-permission: Toggle whether elevator.use is
│➜ mandatory for players.
│➜ max-distance: Set the max teleport range between floors
│➜ (-1 for unlimited).
│➜ discord-webhook: Paste your Discord Webhook URL
│➜ for automated alerts.
│➜ sound-settings: Full control over sound types, pitch,
│➜ and global volume.

Important Notice
│➜ Java 21 Required: This plugin is built for the latest 1.21.1+
│➜ environments and requires Java 21.
│➜ Material Names: When adding blocks to config.yml,
│➜ always use official Bukkit Material names (e.g., IRON_BLOCK).
│➜ Webhook Setup: Make sure your Discord Webhook URL
│➜ is wrapped in quotes in the config file.
│➜ Fresh Install: Upon first run, the plugin generates both English
│➜ and Portuguese language files automatically.
│➜ Support: If you find any bugs or have suggestions, please
│➜ contact the developer or open an issue on GitHub or Discord

Developed with ❤️ by Comonier