Welcome!

By registering with us, you'll be able to discuss, share and private message with other members of our community.

SignUp Now!
BoosterPerks – Das mächtige Perks-Addon

BoosterPerks – Das mächtige Perks-Addon 1.0.0-SNAPSHOT

No permission to download
Overview Updates (1) History

📋 BoosterPerks — 1.0.0-SNAPSHOT

📋 BoosterPerks — Changelog
Format based on https://keepachangelog.com/en/1.0.0/]Keep a Changelog[/url] • Follows https://semver.org/spec/v2.0.0.html]Semantic Versioning (SemVer) 2.0.0[/url]
​





v1.0.0 — 2025-08-29
🎉 Initial Release — Complete Rebranding from NitroPerks


✨ Added

  • []Complete Plugin Rebranding

    • [
    • ]Renamed from NitroPerks ➝ BoosterPerks
      []New orange/yellow gradient color scheme
      [      ]Updated all branding, messages, and GUI elements


    []Advanced GUI System

    • [
    • ]Categorized perk menu (Combat, Utility, Movement, Survival, Mining)
      []Gradient titles with custom color codes
      [      ]Status indicators for owned and active perks
      []Formatted price display with affordability hints
      [      ]Intuitive navigation (back buttons & category selection)


    []Comprehensive Admin System

    • [
    • ]Full GUI-based admin panel: /boosterperks admin
      []Player management with online overview
      [      ]Perk configuration GUI (adjust prices)
      []Server statistics & usage analytics
      [      ]Per-player perk management with visual feedback


    []Enhanced Effects & Feedback

    • [
    • ]Particles on activation/deactivation
      []Configurable sounds
      [      ]Titles for key actions
      []Action Bar status updates
      [      ]Visual perk auras
    • Special effects for purchases & level-ups


    []Robust Database System

    • [
    • ]Async MySQL operations
      []Intelligent caching layer
      [      ]Auto table creation & migrations
      []Player statistics (owned perks, money spent, activity)
      [      ]Usage analytics & purchase history


    []Version Compatibility System

    • [
    • ]Supports Minecraft 1.20.x – 1.21.8
      []Automatic API detection & adaptation
      [      ]Graceful fallbacks across versions
      []Compatible sound/particle/material handling
      [      ]Reflection-based solutions for API differences


🔧 Technical Features
  • Commands & Aliases
    /boosterperks, /bperks, /bp — main
    [br]/boostershop, /bshop — shop
    [br]Legacy aliases: /perks, /perkshop


    []Permission System

    • [
    • ]Granular: boosterperks.[I]
      [[/I]]Individual perk nodes
      []Separate admin nodes
      [      ]Backward-compatible with old permission nodes


    []Configuration Files

    • [
    • ]config.yml — core, database, prices
      []messages.yml — messages, sounds, particles
      [      ]menus.yml — GUI layouts & templates


🎮 Available Perks

  • []Utility: Telekinesis (auto-pickup), Glow, Night Vision
    [    ]Movement: Speed, Jump, Fly
    []Survival: No Hunger, Lava Resistance, No Fall, Water Breath, Keep XP, Keep Inventory
    [    ]Mining: Haste, Instant Smelt


🔄 Changed

  • []Plugin Identity: complete rebrand, new color scheme, all texts updated
    [    ]Build System: fixed MySQL dependency issues; updated to mysql-connector-java:8.0.33; improved Maven for Jenkins CI/CD; proper shading/relocation
  • API Compatibility: improved compatibility layer, better fallbacks, stronger error handling


🛠️ Fixed

  • []Compilation / API: PotionEffectType.JUMP ➝ JUMP_BOOST; FAST_DIGGING ➝ HASTE; particle enums (ENCHANTMENT_TABLE, FIREWORKS_SPARK, …); ActionBar API across versions; reflection fallbacks for API calls
    [    ]Build: resolved MySQL connector conflicts; fixed Maven compilation; better Jenkins compatibility


🗄️ Database Schema
SQL: 
-- Player perk ownership and status
CREATE TABLE player_perks (
id INT AUTO_INCREMENT PRIMARY KEY,
player_uuid VARCHAR(36) NOT NULL,
perk_key VARCHAR(50) NOT NULL,
unlocked BOOLEAN DEFAULT TRUE,
active BOOLEAN DEFAULT FALSE,
unlock_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
level INT DEFAULT 1,
usage_count BIGINT DEFAULT 0,
UNIQUE KEY unique_player_perk (player_uuid, perk_key)
);


-- Player statistics and tracking
CREATE TABLE player_stats (
id INT AUTO_INCREMENT PRIMARY KEY,
player_uuid VARCHAR(36) NOT NULL,
total_perks_owned INT DEFAULT 0,
total_money_spent DECIMAL(15,2) DEFAULT 0.00,
join_date TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
last_seen TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
UNIQUE KEY unique_player (player_uuid)
);


📦 Dependencies

  • []Required: Java 17+ • Spigot/Paper 1.20+–1.21.8 • Vault • MySQL 8.0+ (recommended)
    [    ]Included (Shaded): mysql-connector-java:8.0.33 (properly relocated)


🚀 Performance
  • Async DB operations • Smart caching • Optimized GUI rendering • Memory cleanup • Lower server load via efficient data handling


🎯 Compatibility

  • []Minecraft: 1.20.x – 1.21.8
    [    ]Server Software: Spigot, Paper, Purpur
    []Java: 17, 18, 19, 20, 21
    [    ]Database: MySQL 8.0+, MariaDB 10.3+





Migration from NitroPerks


🔄 Automatic Migration

  • []Preserves & updates existing tables
    [    ]Migrates configuration to new format
    []Keeps player data & perk ownership
    [    ]Auto-updates old permission nodes


⚠️ Breaking Changes

  • []Plugin Name: NitroPerks ➝ BoosterPerks
    [    ]Commands: /nitroperks ➝ /boosterperks (old commands remain as aliases)
    []Permissions: nitroperks.[/I] ➝ boosterperks.[I]
    [    ]Config: new color schemes & branding keys


📋 Migration Steps

  1. []Backup database & configs
    [    ]Stop the server
    []Replace NitroPerks.jar with BoosterPerks.jar
    [    ]Start the server
    []Update permissions if desired (aliases still work)
    [    ]Enjoy the new features!





🔮 Planned Features



  • []Perk Levels — upgradeable tiers with stronger effects
    [    ]Custom Perks API — create your own perks
    []Advanced Statistics — detailed usage analytics
    [    ]Perk Combinations — synergy effects between perks



  • []Web Interface — online admin panel
    [    ]Economy Integration — enhanced rewards & sinks
    []Achievement System — unlock perks via achievements
    [    ]Seasonal Events — limited-time perks



  • []Multi-server Support — cross-server sync
    [    ]API Extensions — more hooks for other plugins
    []Performance Enhancements — further optimizations
    [    ]Additional Perk Categories — broader perk types





🐛 Known Issues

  • []Current: None reported
    [    ]Workarounds:

    • []If ActionBar fails, messages fall back to chat
      [      ]Particles may differ on older versions
    • Custom skull textures may not load on some setups


📞 Support
🆘 Getting Help

  • []Check console/logs for detailed errors
    [    ]Verify dependencies (Vault + economy plugin)
    []Test with minimal plugins to isolate conflicts
    [    ]Confirm correct permissions


🐛 Reporting Issues — Please Include

  • []Server software & version (Spigot/Paper)
    [    ]Plugin version
    []Java version
    [    ]Relevant logs/errors
  • Steps to reproduce


💡 Feature Requests — Please Share

  • []Clear description, use case/benefits
    [    ]Examples or mockups if possible





📄 License
This project is licensed under the MIT License — see LICENSE for details.


🙏 Acknowledgments

  • []Bukkit/Spigot Team — server software
    [    ]Vault Team — economy API
    []Community — feedback & ideas
    [    ]Contributors — code & testing


Made with ❤️ for the Minecraft community
[br]See also: README.md​
Back
Top