PremiumAdvancements

Premium Advancements - Professional Custom Advancement System

Transform your server with a powerful, feature-rich custom advancement system featuring an intuitive GUI editor, real-time progression tracking, and comprehensive reward management!

Overview

Premium Advancements is a comprehensive Minecraft plugin that allows server administrators to create unlimited custom advancements with full control over appearance, triggers, progression, and rewards. Built on top of UltimateAdvancementAPI, it provides a user-friendly in-game GUI for managing advancements without touching configuration files.

Perfect for survival servers, RPG servers, minigame networks, and any server looking to enhance player engagement with custom achievements!

Screenshots

✨ Key Features

Core Functionality

• ✅ Unlimited Custom Advancements - Create as many advancements as you need
• ️ Visual GUI Editor - Manage everything through an intuitive in-game interface
• Real-Time Progress Tracking - Counter-based advancements with persistent progression
• Flexible Reward System - Execute commands and give money rewards upon completion
• Custom Sound Effects - Play any Minecraft sound when players unlock advancements
• Dynamic Notifications - Toast popups, chat announcements, and action bar progress
• ️ Dual Database Support - Choose between SQLite (easy) or MySQL/MariaDB (production)

Advanced Customization

• Position Control - Place advancements anywhere in the GUI using X/Y coordinates
• Frame Types - Choose between TASK, GOAL, or CHALLENGE visual styles
• Custom Icons - Use any Minecraft material as the advancement icon
• Background Themes - Customize the advancement tab background texture
• Toggle Options - Enable/disable toast notifications, chat announcements, and action bar per advancement

Multiple Trigger Types

• JOIN - Triggered when a player joins the server
• BREAK_BLOCK - Triggered when breaking specific blocks (or any block)
• PLACE_BLOCK - Triggered when placing specific blocks (or any block)
• KILL - Triggered when killing entities
• OBTAIN_ITEM - Triggered when obtaining items (including Custom Model Data support for ItemsAdder/Oraxen)

Reward System

• Command Execution - Run multiple console commands with %player% placeholder support
• Money Rewards - Integrate with Vault to give economy rewards
• Flexible Configuration - Enable/disable rewards per advancement

‍ Admin Tools

• Player Management - Reset individual or all advancements for any player
• Real-Time Reload - Reload configuration without restarting the server
• Progress Monitoring - Track player progression through action bar messages
• Database Migration - Easy migration from SQLite to MySQL when scaling up

Requirements

Essential

• Minecraft Server: Paper 1.21.4+ or any Paper fork (Purpur, Pufferfish, etc.)
• Java: 21 or higher
• Required Plugin: UltimateAdvancementAPI v2.7.1+

Optional

• Vault - For economy/money rewards (highly recommended)
• MySQL/MariaDB - For better performance on larger servers (50+ players)
• ItemsAdder/Oraxen - For custom item detection using Custom Model Data

Quick Start

1. Download Premium Advancements, UltimateAdvancementAPI, and optionally Vault
2. Install all JAR files into your plugins/ folder
3. Start your server - configuration files will be generated automatically
4. Open GUI with /padv gui to start creating advancements
5. Press L in-game to view your custom advancement tab!

For detailed installation instructions, configuration guides, and examples, visit our GitHub Documentation.

Usage Examples

Creating a Simple Welcome Advancement

1. Run /padv gui to open the management interface
2. Click "Create Advancement"
3. Set title: "Welcome to the Server!"
4. Set trigger: JOIN
5. Add reward command: give %player% diamond 5
6. Enable money reward: 100
7. Click "Save" - done!

Creating a Mining Milestone

1. Open the GUI with /padv gui
2. Click "Create Advancement"
3. Set title: "Master Miner"
4. Set trigger: BREAK_BLOCK
5. Set block: STONE
6. Set amount: 1000
7. Enable action bar progress
8. Add rewards and save!

Creating a Custom Item Collection

1. Open the GUI with /padv gui
2. Click "Create Advancement"
3. Set title: "Rare Collector"
4. Set trigger: OBTAIN_ITEM
5. Set item: DIAMOND
6. Optional: Set Custom Model Data for ItemsAdder items
7. Set amount: 64
8. Configure rewards and save!

Commands & Permissions

Commands

Command Description Permission

/padv Show help menu None

/padv gui Open management GUI premiumadvancements.admin

/padv reset <adv|all> Reset player progress premiumadvancements.reset

/padv reload Reload configuration premiumadvancements.admin

Aliases: /premiumadvancements, /padv

Permissions

Permission Description Default

premiumadvancements.admin Access to GUI and admin commands OP

premiumadvancements.reset Reset player advancements OP

️ Database Support

SQLite (Default)

• ✅ No setup required
• ✅ Automatic file creation
• ✅ Easy backups
• ⚠️ Best for small servers (<50 players)

MySQL/MariaDB (Recommended for Production)

• ✅ Superior performance with multiple concurrent players
• ✅ Network support (BungeeCord/Velocity compatible)
• ✅ Professional-grade reliability
• ✅ Concurrent access handling
• ⚠️ Requires external database server

Simply update config.yml to switch between database types!

Use Cases

• Survival Servers - Create mining, farming, and exploration milestones
• RPG Servers - Quest-like achievements with story progression
• Minigame Networks - Track player stats and award custom achievements
• Prison Servers - Rankup milestones and mining achievements
• Skyblock Servers - Island progression and collection achievements
• Towny Servers - Town building and economy milestones
• Practice Servers - Combat and skill-based achievements

Credits

Dependencies

• UltimateAdvancementAPI by frengor - Core advancement framework
• PaperMC - Minecraft server software
• Vault by MilkBowl - Economy API integration
• HikariCP - High-performance connection pooling
• bStats - Anonymous plugin metrics

Development

• Lead Developer: XPaladiumyX
• Development Team: Sky X Network

Support

Need Help?

• Website: skyxnetwork.net
• Discord: Join our Discord
• Documentation: GitHub Wiki
• Bug Reports: GitHub Issu

Why Choose Premium Advancements?

✅ User-Friendly - No configuration file editing required

✅ Powerful - All features of premium advancement plugins, completely free

✅ Reliable - Built on UltimateAdvancementAPI's proven framework

✅ Scalable - Supports both small servers and large networks

✅ Well-Documented - Comprehensive guides and examples

✅ Active Support - Responsive developer and community

✅ Regular Updates - Continuously improved and updated

Made with ❤️ by Sky X Network

⭐ If you enjoy this plugin, please like it! ⭐