Easter Holidays

[1.2.8] - 2026-04-05

✨ New Features

Configurable Permission System

• Flexible Feature Permissions: Server admins can now control which features require permissions
• Per-Feature Configuration: Each feature (hoppad, launcher, trail, etc.) can be made public or restricted
• Added new permissions section in config.yml:

  permissions:
    requirePermissionFor:
      hoppad: false    # Everyone can use hop pads!
      launcher: true   # Requires permission
  

• Live Reload: Permission changes take effect with /easter reload - no restart needed
• Backwards Compatible: All existing permissions continue to work as before
• Added comprehensive permission documentation in PERMISSIONS_GUIDE.md

Automatic Configuration Migration

• No More Config Deletion! Updates automatically add new config options without losing existing settings
• Smart Migration: Only missing options are added, existing values are preserved
• Automatic Backups: Creates backup before any migration (config.yml.backup)
• Backup Rotation: Maintains only 2 backups to keep plugin folder clean:
  • config.yml.backup - Latest backup
  • config.yml.backup.old - Previous backup
• Version Tracking: Config version tracked at file end with prominent warning
• Detailed Logging: Shows exactly which options were added during migration
• Old timestamped backups are automatically cleaned up

🔧 Improvements

Configuration

• Config Version Location: Moved to end of file with clear warning message:

  # ============================================================================
  # WARNING: DO NOT MODIFY THE CONFIG VERSION!
  # This is used for automatic configuration updates.
  # ============================================================================
  config-version: "1.2.8"
  

• Better Organization: Permission settings grouped logically in config
• Cleaner Updates: Future plugin updates won't require config deletion

📚 Documentation

• Added PERMISSIONS_GUIDE.md - Complete guide for the new permission system
• Added CONFIG_MIGRATION.md - Technical details about automatic config updates
• Updated examples showing how to configure permissions for different server types

🛠️ Technical

• Added PermissionManager class for centralized permission handling
• Added ConfigMigrator class for automatic configuration updates
• Improved config file I/O operations for reliable migration
• Migration runs automatically on plugin startup when needed