PremiumFly v2.0.0 Release Notes

This is a major update that transforms PremiumFly from a simple “flight ON/OFF plugin” for survival servers into a significantly more secure, customizable, and manageable flight system.

🚨 Important Changes

• Paper is now the only supported platform. PremiumFly uses Paper's new jump detection API and will not work on Spigot alone.
• Java 21 or newer is now required.
• The permission data storage method has been changed from scoreboard tags to PersistentDataContainer. Existing player data will be migrated automatically the next time each player logs in, with no administrator action required.

🐛 Bug Fixes

• Fixed an issue where players could not fly in Spectator Mode. Players without PremiumFly permissions who entered Spectator Mode were being forcibly prevented from flying by an internal task that ran every second, interfering with staff moderation and server monitoring.
• Fixed unreliable landing detection. The previous block hitbox-based detection could fail to correctly detect landings on slabs, stairs, and other blocks. It has been replaced with Paper's official jump detection event combined with isOnGround().
• Fixed an issue where players could be forcibly sent back into flight immediately when attempting to land. This was caused by using the same processing logic for both flight activation and landing without distinguishing between the two states.
• Fixed an issue where players without permission did not receive the custom /pfly permission message. Bukkit's default English message was being displayed first, making the custom Japanese message effectively unused.
• Fixed a potential false positive caused by partial player-name matching with /pfly <name> enable, etc. For example, entering "Tak" could potentially grant flight permissions to an unintended player.
• Fixed a minor memory leak where internal data for players who had left the server remained in memory.
• Fixed an issue where player flight states were not properly cleaned up when the plugin was reloaded with /reload or disabled, which could cause flying players to be incorrectly kicked for illegal flight.
• Fixed an issue where the version number was maintained separately in plugin.yml and build.gradle, potentially causing version mismatches during updates. The two are now automatically synchronized.

✨ New Features

• Automatic permission-based flight (premiumfly.fly). Simply grant the permission to a LuckPerms rank or other permission group, and flight will automatically be enabled for all members without requiring any commands.
• Added sound and particle effects when taking off and landing. These can be enabled or disabled and customized in config.yml.
• Added /pfly list to display players who currently have flight permission and /pfly info to display version and update information.
• Added tab completion to the /pfly command.
• Added per-world disabling with disabled-worlds. This can be used to prevent flight in minigames, parkour maps, and other specific worlds.
• Added an update checker. When a new version is published on Modrinth, the console and players with the premiumfly.notify permission will be notified.
• Added optional bStats metrics support. A bStats plugin ID obtained from bstats.org is required.
• Reworked the message system using Adventure / MiniMessage. config.yml now supports fully customizable formatting, including HEX colors and gradients.

⚙️ Configuration Changes

The structure of config.yml has been updated. After upgrading, review the new config.yml and adjust settings such as flight.speed and effects to your preferences.

flight:
  speed: 0.2
  jump-window-ticks: 40
  disabled-worlds: []

effects:
  sound: { enabled: true, activate: ..., deactivate: ... }
  particles: { enabled: true, activate: CLOUD }

update-checker:
  enabled: true
  modrinth-id: premiumfly

metrics:
  enabled: true
  plugin-id: 0

📦 Other Changes

• Added a LICENSE file specifying the MIT License.
• Added .gitignore to prevent build artifacts and IDE configuration files from cluttering the repository.