Paper 1.21.11 Fix + Bedrock Hotbar Protection



✨ What's New in v2.5.2?

Sorry for the issues introduced in v2.5.1! This release fixes a Paper 1.21.11 startup crash and two gaps in the Bedrock virtual elytra protection.
Fully compatible with v2.5.1 and v2.5.0 – no configuration changes required.

Paper 1.21.11 Startup Fix

- Fixed NullPointerException on startup when running Paper 1.21.11

- Paper 1.21.11 changed getConfig() to trigger the overridden reloadConfig() before DataManager was initialized — now guarded correctly

- Plugin enables cleanly on Paper 1.21.11 without crashing

️ Bedrock Elytra Item Protection

- Elytra items can no longer displace the virtual elytra mid-flight via inventory interactions

- Previously only *_CHESTPLATE items were blocked; elytra items are now included in all three guards:
- Direct clicks on the armor slot
- Auto-equip ( MOVE_TO_OTHER_INVENTORY) actions
- Cursor placement onto the armor slot

️ Bedrock Hotbar Right-click Protection

- Right-clicking a chestplate or elytra in the hotbar (inventory closed) while flying no longer auto-equips it

- This path was previously unhandled and is now blocked via PlayerInteractEvent

Requirements

- ✅ Java 21+ – Required for all versions

Installation

Upgrading from v2.5.1 / v2.5.0

1. Download SpawnElytra-2.5.2.jar from the files section

2. Stop your server

3. Replace the old plugin file in your plugins/ folder

4. Start your server

5. ✅ No configuration changes required

https://github.com/Knabbiii/SpawnElytra

Bedrock Elytra Fix + Update Checker + Debug Mode



✨ What's New in v2.5.1?

A Bedrock inventory fix, a built-in update checker, and a new debug mode config option.
Fully compatible with v2.5.0 – no configuration changes required.

✨ v2.5.1 Updates

️ Bedrock Elytra Inventory Fix

- Chestplate displacement fixed – Bedrock players can no longer right-click or shift-click a chestplate to displace the virtual elytra mid-flight

- Three inventory paths are now blocked for flying Bedrock players:
- Direct clicks on the chestplate armor slot
- Auto-equip ( MOVE_TO_OTHER_INVENTORY) of any chestplate-type item
- Cursor placement of a chestplate onto the armor slot

Built-in Update Checker

- Plugin now checks Modrinth for updates asynchronously on every startup

- If an update is available: logged to console + sent to the first op to join after each restart

- checkForUpdates: true (default) – Enable update checks

- checkForUpdates: false – Disable update checks entirely

Debug Mode

- debugMode: false (default) – Clean console, only important messages logged

- debugMode: true – Verbose save/load logging restored for troubleshooting

Requirements

- ✅ Java 21+ – Required for all versions

Installation

Upgrading from v2.5.0

1. Download SpawnElytra-2.5.1.jar from the files section

2. Stop your server

3. Replace the old plugin file in your plugins/ folder

4. Start your server

5. ✅ No configuration changes required

Config Note
The new keys checkForUpdates and debugMode are optional — the plugin defaults to safe values if they are missing. To use them, either:

- Add them manually to your config.yml

- Or delete config.yml and let the plugin regenerate it with all options included

Why Update to v2.5.1?

- Bedrock Fix – Virtual elytra can no longer be displaced via inventory clicks

- Update Checker – Always know when a new version is available

- Cleaner Console – No more save/load log spam by default

- ✅ Easy Upgrade – Drop-in replacement, no config changes needed

https://github.com/Knabbiii/SpawnElytra

Compatibility & Config Update – 1.20.1+ Support Restored



✨ What's New in v2.5.0?

A compatibility and config update that restores support for older Minecraft versions and adds a new spawn radius option.
Fully compatible with v2.4.2 – no configuration changes required.

✨ v2.5.0 Updates

Broader Version Support

- Restored 1.20.1+ Compatibility – Plugin now works on 1.20.1 and all newer versions including 26.1.x, 26.2.x and beyond

- Previously locked to 26.1.x only – This is now fixed

New Config Option: ignoreYInSpawnRadius

- ignoreYInSpawnRadius: false (default) – Full 3D distance from spawn is used (X/Y/Z)

- ignoreYInSpawnRadius: true – Only horizontal distance (X/Z) is checked, players can fly at any height within the radius

Requirements

- ✅ Java 21+ – Required for all versions

Installation

Upgrading from v2.4.2

1. Download SpawnElytra-2.5.0.jar from the files section

2. Stop your server

3. Replace the old plugin file in your plugins/ folder

4. Start your server

5. ✅ No configuration changes required

Config Note
If ignoreYInSpawnRadius is missing from your existing config, the plugin defaults to false (old behavior). To use it, either:

- Add ignoreYInSpawnRadius: false manually to your config.yml

- Or delete config.yml and let the plugin regenerate it with all options included

Why Update to v2.5.0?

- All Versions Supported – Works on 1.20.1 through 26.2.x and beyond

- New Config Option – Fine-tune the spawn radius height behaviour

- ✅ Easy Upgrade – Drop-in replacement, no config changes needed

- No Breaking Changes – All existing settings carry over

https://github.com/Knabbiii/SpawnElytra

What's New in v2.4.2?

A compatibility update focused on Paper 26.1.x support under the new Minecraft versioning scheme.
Fully compatible with v2.4.1 – no configuration changes required.

✨ v2.4.2 Updates – Compatibility Improvements

️ Paper 26.1.x Support

• Updated API Version – Now supports Paper 26.1, 26.1.1 and 26.1.2+
• New Versioning Scheme – Compatible with Paper's updated version format

Requirements

• ✅ Java 25+ – Required when running on Paper 26.1.x
• ✅ Java 21+ – Still supported for older Spigot/Paper versions

Installation

Upgrading from v2.4.1

1. Download SpawnElytra-2.4.2.jar from the files section
2. Stop your server
3. Replace the old plugin file in your plugins/ folder
4. Start your server
5. ✅ No configuration changes required

Important Notice
This update is required for servers that:

• Run Paper 26.1.x or newer
• Use Java 25
• Received plugin errors after updating Paper to 26.1+

Why Update to v2.4.2?

• ️ Paper 26.1.x Ready – Full support for the new versioning scheme
• Java 25 Compatible – Runs smoothly on the latest Java runtime
• ✅ Easy Upgrade – Drop-in replacement, no config changes
• No Breaking Changes – All existing settings carry over

What's New in v2.4.1?

A hotfix update focused on reliable data persistence, performance optimizations, and safer plugin lifecycle handling.
Fully compatible with v2.4.0 – no configuration changes required.

✨ v2.4.1 Updates – Hotfix Improvements

Data Persistence & Saving

• New DataManager System – Centralized saving & loading of plugin data
• Encode / Decode Handling – Ensures stored data remains consistent and safe

Flight State Handling

• ✅ SpawnBoostListener Save/Load – Properly restores flying state after restarts
• ✅ Desync Prevention – Improves stability after crashes or reloads

Performance Improvements

• ✅ Lists → Sets Optimization – Faster lookups and better performance
• ✅ UUID-Based Player Tracking – No more Player object storage

⚙️ Stability & Safety

• ✅ onEnable Validation – Prevents duplicate listener registration
• ✅ Reload Safety – Avoids double event handling on reloads

Logging & Debugging

• ✅ Extended Logging – More detailed logs for debugging and server monitoring

Bug Fixes

• ✅ Fixed potential flight state desync after restart
• ✅ Prevented side effects caused by duplicate listeners
• ✅ Improved internal state validation and cleanup

Installation

Upgrading from v2.4.0

1. Download SpawnElytra-2.4.1.jar from the files section
2. Stop your server
3. Replace the old plugin file in your plugins/ folder
4. Start your server
5. ✅ No configuration changes required

Important Notice
This hotfix is **strongly recommended** for servers that:

• Restart or reload frequently
• Run multiple flight-related plugins
• Require reliable persistence and better debugging

Why Update to v2.4.1?

• Reliable Data Saving – Prevents state loss after restarts
• Better Performance – Optimized collections and memory usage
• Safer Reloads – No duplicate listeners or double events
• Improved Debugging – More useful logs for server owners
• ✅ Easy Upgrade – Drop-in hotfix, no config changes

What's New in v2.4.0?

A critical bug fix update addressing plugin conflicts, exploit prevention, and enhanced Bedrock protection!

✨ v2.4.0 Updates - Breaking Fixes & Compatibility

Breaking Fixes

• FlyCraft/Multi-Plugin Compatibility - Prevents flight permission conflicts with other plugins
• Double-Jump Spam Exploit Fix - Players can no longer spam jump to gain altitude while flying
• Managed Players Tracking - Plugin now tracks which players it gave flight to, preventing interference
• Gliding State Detection - Checks isGliding() to prevent re-enabling flight during active glide

Enhanced Bedrock Protection

• ✅ Death Drop Prevention - Virtual elytra no longer drops on death, chestplate properly restored
• ✅ Inventory Click Protection - Players cannot remove virtual elytra while flying
• ✅ Join Cleanup System - Automatically removes leftover elytra from crashes/reconnects
• ✅ Chestplate Restoration - Original armor restored in all exit scenarios

Bug Fixes

• ✅ Nether Portal Exploit Fixed - Flight immediately stops when changing worlds
• ✅ World Change Cleanup - managedPlayers properly cleared on world transitions
• ✅ Ground Detection Improved - Better detection for various block types
• ✅ State Management Enhanced - Consistent player state across all scenarios

⚙️ Technical Improvements

• ✅ managedPlayers List - Tracks plugin-controlled players for multi-plugin compatibility
• ✅ Event-Driven Protection - InventoryClickEvent, PlayerDeathEvent handlers
• ✅ Automated Dev Environment - Gradle tasks for Paper 1.21.11 testing
• ✅ Java 21 Compatibility - Gradle configuration optimized for Java 21 LTS
• ✅ Enhanced State Checks - flying.contains() and isGliding() validation

Installation

Upgrading from v2.3.x

1. Download SpawnElytra-2.4.0.jar from the files section
2. Stop your server
3. Replace the old plugin file in your plugins/ folder
4. Start your server
5. ✅ Existing configs work perfectly! - No configuration changes required

Important for Multi-Plugin Servers
If you run flight plugins like FlyCraft alongside SpawnElytra, this update is critical for proper functionality.

Why Update to v2.4.0?

• Multi-Plugin Compatibility - No more conflicts with other flight plugins
• ️ Exploit Prevention - Double-jump spam and nether portal exploits fixed
• Better Bedrock UX - Enhanced protection and cleanup for Bedrock players
• Production Stability - Critical bugs resolved, tested on live servers
• ✅ Easy Upgrade - Drop-in replacement with no config changes

What's New in v2.3.0?

A major feature update bringing full Bedrock Edition support and privacy-focused metrics to SpawnElytra!

✨ v2.3.0 Updates - Bedrock Compatibility & Metrics

Bedrock Edition Support

• ✅ Virtual Elytra System - Bedrock players can fly without physical elytra items
• ✅ Automatic Detection - Detects Bedrock players via Floodgate API with UUID fallback
• ✅ Sneak-to-Boost - Natural boost mechanic for Bedrock controls (no F-key available)
• ✅ Chestplate Protection - Automatically saves and restores chestplates during flight
• ✅ Flight Protection - Prevents elytra removal while flying
• ✅ Cross-Platform UX - Platform-appropriate controls for Java and Bedrock players

Metrics & Privacy

• ✅ bStats Integration - Optional anonymous usage statistics for plugin improvement
• ✅ Privacy Control - Configure enableMetrics: false to disable completely
• ✅ Transparency - Full control over data sharing in config.yml
• ✅ Shadow JAR - Dependencies properly shaded and isolated

Configuration Updates

• ✅ New enableMetrics Option - Control bStats in config.yml (default: true)
• ✅ Cleaned Comments - Minimized configuration file comments for clarity
• ✅ Enhanced Documentation - Updated README with Bedrock support details
• ✅ Floodgate Support - Added as soft dependency for enhanced Bedrock detection

⚙️ Technical Improvements

• ✅ Reflection-Based Detection - Floodgate API detection without hard dependency
• ✅ Event-Driven Architecture - PlayerToggleSneakEvent for Bedrock boost
• ✅ Inventory Protection - InventoryClickEvent handler prevents elytra removal
• ✅ HashMap Storage - Chestplate preservation system
• ✅ Gradle Shadow Plugin - Proper dependency management and shading

Installation

Upgrading from v2.2.x

1. Download SpawnElytra-2.3.0.jar from the files section
2. Stop your server
3. Replace the old plugin file in your plugins/ folder
4. Start your server
5. ✅ Existing configs work perfectly! - Optionally add enableMetrics: false to disable metrics

Geyser/Floodgate Setup (Optional)
For enhanced Bedrock detection, install Floodgate on your server. SpawnElytra works without it but will use UUID-based fallback detection.

Why Update to v2.3.0?

• Welcome Bedrock Players - Full cross-platform support for Java & Bedrock
• Better UX - Platform-appropriate controls for all players
• Privacy First - Complete control over metrics collection
• Production Ready - Tested on live servers with mixed player base
• ✅ Easy Upgrade - Drop-in replacement with backward compatibility

What's New in v2.2.1?

A focused update bringing performance improvements and critical bug fixes to make your elytra flight experience smoother and more reliable!

✨ v2.2.1 Updates - Performance & Stability

Bug Fixes

• ✅ Grace Period System - Added 5-tick grace period to prevent false landing detection when starting flight
• ✅ Ground Detection Fix - Fixed edge cases where players would get stuck or have flight interrupted prematurely
• ✅ Event Handling - Improved player type checking in glide toggle events

⚡ Performance Optimizations

• ✅ Scheduler Optimization - Reduced frequency from every 3 ticks to every 5 ticks (16.7% performance improvement)
• ✅ Event-Driven Detection - Moved ground detection from continuous polling to event-based system
• ✅ Reduced Server Load - Less frequent checks mean lower overhead

Technical Improvements

• ✅ Dynamic JAR Versioning - Build system now uses project version automatically
• ✅ Code Cleanup - Removed unused imports and improved formatting
• ✅ Version Logging - Plugin messages now display actual version dynamically

Installation

� Upgrading from v2.2

1. Download SpawnElytra-2.2.1.jar from the files section
2. Stop your server
3. Replace the old plugin file in your plugins/ folder
4. Start your server
5. ✅ No configuration changes required! - Existing configs work perfectly

Contributors
TheMaxik: Core performance optimizations and bug fixes
Knabbiii: Additional improvements and integration

Why Update to v2.2.1?

• Better Performance - 16.7% reduction in scheduler overhead
• More Reliable - Grace period prevents flight interruption bugs
• Drop-in Upgrade - No configuration changes needed
• Community Driven - Bug fixes from community feedback

What is SpawnElytra?

A lightweight Minecraft plugin that brings CraftAttack-style elytra flight mechanics to your spawn area! Players can double-jump to activate elytra gliding and boost themselves with the F key - no actual elytra wings required!

✨ What's New in v2.2 - Major Modernization

Enterprise-Level Technology Stack

• ✅ Java 21 LTS Upgrade - Migrated from Java 17 to Java 21 LTS for optimal performance and security
• ✅ Modern Gradle 8.10.2 - Updated from ancient Gradle 7.0.2 to latest build tooling
• ✅ Professional Architecture - Implemented Singleton Design Pattern for better resource management

Modern Java Features

• ✅ Text Blocks ("""") - Clean multi-line string handling for better code readability
• ✅ String.formatted() - Modern string formatting replacing legacy methods
• ✅ Enhanced Exception Handling - Specific exception types for better cross-version compatibility

Code Quality & Professional Standards

• ✅ Production-Ready Code - Removed all unnecessary comments and AI-generated documentation
• ✅ Proper Code Formatting - Added curly braces to all single-line if statements
• ✅ Enterprise Standards - Code now meets professional development standards

Enhanced Configuration

• ✅ Advanced Boost Options - Configurable boost direction (forward/upward)
• ✅ Sound Customization - Configurable boost sound effects
• ✅ Message Control - Toggle activation and boost messages independently
• ✅ Cross-Version Chat - BungeeCord chat component support with fallback

Core Features (Maintained)

• ✅ Double-jump Flight - Activate elytra gliding anywhere within spawn radius
• ✅ F-Key Boost - Speed boost while flying (configurable multiplier and direction)
• ✅ No Fall Damage - Safe landing every time
• ✅ World-Specific - Configure which world the feature works in
• ✅ Permission System - Fine-grained control over who can use what
• ✅ Admin Commands - /spawnelytra reload and /spawnelytra info

Technical Details

Requirement	Version
Minecraft	1.20.1+ (supports 1.20.x and 1.21.x)
Server	Spigot, Paper, or compatible
Java	21 LTS (recommended for optimal performance)
Build System	Gradle 8.10.2

Installation

1. Download the .jar file
2. Place in your server's plugins folder
3. Restart server
4. ⚙️ Configure in plugins/SpawnElytra/config.yml

⚙️ Enhanced Configuration

Permissions

Commands

Command	Permission	Description
/spawnelytra info	spawnelytra.use	Show plugin information
/spawnelytra reload	spawnelytra.admin	Reload configuration

Why Upgrade to v2.2?

• Better Performance - Java 21 LTS provides significant performance improvements
• Enhanced Security - Latest LTS version with security patches
• Modern Tooling - Latest Gradle build system for better development
• Cleaner Code - Professional-grade codebase ready for production
• More Features - Enhanced configuration options for better customization

Credits & Inspiration

Enhanced with features inspired by blax-k's implementation. Built with ❤️ for the Minecraft community.

Overview

Bring CraftAttack-style elytra flight mechanics to your spawn area! Players can double-jump to activate elytra gliding and boost themselves with the F key - no actual elytra wings required!

✨ What's New in v2.1

Compatibility Improvements

• Broader Minecraft Support - Compatible with 1.20.1+ through all 1.21.x versions
• Better Server Compatibility - Optimized for Spigot, Paper, and compatible servers
• Enhanced Documentation - Clear setup and configuration instructions
• Professional Configuration - Detailed comments explaining all settings

Core Features

• Double-jump Flight - Activate elytra gliding anywhere within spawn radius
• F-Key Boost - Speed boost while flying (configurable multiplier)
• No Fall Damage - Safe landing every time
• World-Specific - Configure which world the feature works in
• Permission System - Fine-grained control over who can use what features
• Admin Commands - /spawnelytra reload and /spawnelytra info

Requirements

Minecraft: 1.20.1+
️ Server: Spigot, Paper, or compatible
☕ Java: 17+
Dependencies: None

✅ Tested Server Versions

• Spigot 1.20.1 - 1.21.3
• Paper 1.20.1 - 1.21.3
• Purpur 1.20.1 - 1.21.3

⚙️ Setup

1. Download the plugin JAR file
2. Place in your server's plugins folder
3. Restart your server
4. Configure spawn radius in plugins/SpawnElytra/config.yml
5. Set world spawn with /setworldspawn
6. Players can now double-jump to fly at spawn!

Basic Configuration
Usage

Commands
/spawnelytra info - Show plugin information (No permission required)
/spawnelytra reload - Reload configuration (Requires: spawnelytra.admin)

Aliases: /se, /selytra

Permissions
spawnelytra.use - Allows elytra flight (Default: true)
spawnelytra.useboost - Allows boost functionality (Default: true)
spawnelytra.admin - Admin commands access (Default: op)
spawnelytra.* - Grants all permissions (Default: op)

Why Choose SpawnElytra?

• ✅ No dependencies required
• ✅ Lightweight with minimal performance impact
• ✅ Event-driven architecture for efficiency
• ✅ Highly configurable with detailed options
• ✅ Professional documentation and support
• ✅ Regular updates and community feedback

How to Use

1. Enter the spawn area (within the configured radius)
2. Double-jump (press space twice quickly) to start flying
3. Use elytra controls to glide around
4. Press F (swap hands) to boost forward while flying
5. Land to stop flying

Enhanced version combining the best features from multiple implementations with modern compatibility and bug fixes.