# :icon-rocket: PremiumAdvancements

![Version](https://img.shields.io/github/v/release/XPaladiumyX/PremiumAdvancements-Releases?label=Version&color=%239b59b6&style=for-the-badge) ![API](https://img.shields.io/badge/API-1.21-blue?style=for-the-badge) ![Author](https://img.shields.io/badge/Author-XPaladiumyX-orange?style=for-the-badge)

Welcome to the documentation of **PremiumAdvancements** for Sky X Network.

* * *

####

**Plugin Overview**

| Property | Value |
|----------|-------|
| Name | PremiumAdvancements |
| Version | Latest (v2.6+) |
| Main Class | `skyxnetwork.premiumAdvancements.PremiumAdvancements` |
| API Version | 1.21 |
| Author | XPaladiumyX |
| Website | [skyxnetwork.net](https://skyxnetwork.net) |
| Description | Create unlimited custom advancements with an in-game GUI editor, 48 triggers, progression tracking, rewards, and database support for Paper 1.21.4+ |

* * *

####

**Dependencies**

| Type | Plugin | Purpose |
|------|--------|---------|
| :icon-alert: Hard | [UltimateAdvancementAPI](https://www.spigotmc.org/resources/ultimateadvancementapi-1-15-26-1-2.95585/) (v2.7.1+) | Core advancement system |
| Soft | [Vault](https://www.spigotmc.org/resources/vault.34315/) | Economy rewards |
| Soft | [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) | Placeholder expansion |
| Soft | [PlayerPoints](https://www.spigotmc.org/resources/playerpoints.80745/) | Points rewards |
| Soft | [LuckPerms](https://luckperms.net/download) | Permission rewards |
| Soft | [Floodgate](https://geysermc.org/) | Bedrock player avatar support |

* * *

####

**Key Features**

- **47 trigger types** -- Block breaking, entity kills, crafting, smelting, fishing, dimension travel, nether roof, and many more
- **In-game GUI editor** -- Create, edit, and delete advancements directly from Minecraft
- **Web editor** -- Full browser-based editor with visual tree, icon picker, import/export
- **8 reward types** -- Commands, money, items, permissions, PlayerPoints, random pools, broadcasts, Discord webhooks
- **Multi-tab system** -- Organize advancements across multiple tabs and namespaces, with configurable tab order
- **Progression tracking** -- Real-time progress bar, action bar, database persistence
- **Database support** -- SQLite (default) and MySQL/MariaDB
- **PlaceholderAPI support** -- 14+ placeholders for global, per-advancement, and per-tab stats
- **Multi-language** -- English and French built-in, fully customizable language files
- **Auto-update & migration** -- Automatic config updates and v1.70 migration on startup

Use the sidebar to navigate through the documentation sections.