Premium Advancements
Create unlimited custom advancements with an in game & web GUI editor. No config files needed.

--- ## Why Premium Advancements? The easiest way to add achievements, quests, and progression to your Minecraft server. **53 triggers**, real-time tracking, **8 reward types**, **multi-tab system**, **Discord webhooks**, and both an in-game and **browser-based web editor** with live tree view - all without editing a single configuration file. --- ## Features - **MiniMessage & Hex Colors** - `&#RRGGBB`, gradients, rainbows, bold/italic/underline, named colors (``) supported everywhere - in-game L menu, GUIs, broadcasts, and the web editor live preview - **Multi-Tab System** - Organize advancements across multiple tabs, each with its own icon, background, and namespace - **Vanilla Advancement Viewer** - Minecraft's built-in advancements (Story, Adventure, Nether, End, Husbandry) loaded read-only with correct icons, positions, and tree connections - **In-Game GUI Editor** - 6 screens: main list, tab selector, create wizard, edit, confirm delete, stats viewer - **Web Editor (Browser-Based)** - Full visual editor with live tree view, drag & drop, undo/redo, import/export JSON, icon browser, tab management - **53 Trigger Types** - Block break/place, entity kill/breed/tame, items, enchanting, dimensions, biome entry, WorldGuard regions, vanilla advancement chaining, travel distance, playtime, login streaks, placeholders, and more. See the [full list on the wiki](https://wiki.skyxnetwork.net/advancements/triggers/). - **Progression Tracking** - Counter-based progress saved across sessions; cumulative distance (glide/swim/climb/travel) - **8 Reward Types** - Console commands, Vault money, items (with enchants/name/lore/CMD), LuckPerms permissions, PlayerPoints, weighted random reward pools, global broadcast, Discord webhooks - **Discord Webhook Integration** - Send customizable embeds on advancement completion, per-advancement toggle, custom embed with `%player%` and `%advancement%` placeholders - **Notifications** - Toast popups, chat announcements, action bar progress - **Dependencies** - Chain advancements with prerequisites for progression systems - **Filters** - Block/item/entity type filters, world restrictions, permission gates, Custom Model Data ( ItemsAdder/Oraxen), enchantment type/level, potion effect/amplifier, death cause, villager profession, bed color, sheep color, dimension, travel mode - **Hidden Advancements** - Invisible until all prerequisites are met - **Visual Tree** - Customizable x/y positions and connection targets for a clean advancement display - **Database** - SQLite (file-based, easy) or MySQL/MariaDB with HikariCP connection pool - **Multi-Language** - Built-in English and French; custom language file support - **PlaceholderAPI** - 14+ placeholders for scores, progress, ranking, and per-tab stats - **Auto-Migration** - Seamless upgrade from v1.70 with automatic backup - **bStats** - Anonymous usage statistics (toggleable) --- ## Quick Start 1. Install [UltimateAdvancementAPI](https://www.spigotmc.org/resources/95585/) v3.0.0-beta-3+ 2. Drop the plugin in `plugins/` and restart 3. Run `/padv gui` to create advancements OR `/padv editor` for the web editor 4. Press **L** in-game to view them --- ## Screenshots ### Community Showcase 💙 Check out [**KasaiSora**](https://www.youtube.com/@KasaiSora)'s video showcase of Premium Advancements: ### Two ways to create advancements fast | **Via `/padv gui`** - In-game GUI | **Via `/padv editor`** - Web Editor | |----------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------| |

|

| ![GUI](https://i.imgur.com/IQKb13E.png) ![Create](https://i.imgur.com/14Vvobg.png) ![Showcase-3](https://i.imgur.com/GSNHBLs.png) ![In-Game](https://i.imgur.com/C43RdS9.png) ![Showcase-5](https://i.imgur.com/K5ly78M.png) > **📸 Discord Webhook Showcase** > > ![Discord-With-Rewards](https://i.imgur.com/H1kcSHg.png) > ![Discord-Without-Rewards](https://i.imgur.com/5dysmev.png) > **🌐 Web Editor Showcase** > > ![Webeditor](https://i.imgur.com/b63bL7g.png) > ![Webeditor-tree](https://i.imgur.com/ATvyMvn.png) --- ## Commands | Command | Description | |------------------------------------------|---------------------------------------------------| | `/padv help` | Show help menu | | `/padv gui` | Open advancement management GUI (or tab selector) | | `/padv tabs` | List all advancement tabs | | `/padv wiki` | Open the plugin wiki | | `/padv editor` | Get the web editor link | | `/padv editor-trust

`              | Authorize a browser session                       |
| `/padv info `                        | Show full advancement details                     |
| `/padv give  `      | Grant an advancement to a player                  |
| `/padv take  ` | Revoke an advancement (or all) from a player      |
| `/padv list [player]`                    | List completed advancements                       |
| `/padv stats [player]`                   | Open stats GUI with progress bars                 |
| `/padv setplaytime  `   | Set a player's total playtime (v2.5)              |
| `/padv loginstreak [player]`             | Check a player's login streak (v2.5)              |
| `/padv setloginstreak  `   | Set a player's login streak (v2.5)                |
| `/padv reload`                           | Reload configuration                              |
| `/padv placeholders`                     | List all placeholders                             |

### Permissions

| Permission                         | Default  | Description                       |
|------------------------------------|----------|-----------------------------------|
| `premiumadvancements.admin`        | OP       | Full access to all admin commands |
| `premiumadvancements.give`         | OP       | Grant advancements                |
| `premiumadvancements.take`         | OP       | Revoke advancements               |
| `premiumadvancements.list`         | **true** | List own advancements             |
| `premiumadvancements.list.others`  | OP       | List others' advancements         |
| `premiumadvancements.stats`        | **true** | View own stats                    |
| `premiumadvancements.stats.others` | OP       | View others' stats                |

### Placeholders

| Placeholder                                | Description                   |
|--------------------------------------------|-------------------------------|
| `%premiumadvancements_completed%`          | Total completed advancements  |
| `%premiumadvancements_total%`              | Total available advancements  |
| `%premiumadvancements_progress_%`      | Progress (e.g., 45/100)       |
| `%premiumadvancements_completed_%`     | Completed status (true/false) |
| `%premiumadvancements_percent%`            | Overall completion %          |
| `%premiumadvancements_percent_%`       | Per-advancement completion %  |
| `%premiumadvancements_latest%`             | Latest completed title        |
| `%premiumadvancements_ranking%`            | Player rank by completions    |
| `%premiumadvancements_tab_completed_%` | Tab completions               |
| `%premiumadvancements_tab_total_%`     | Tab total                     |
| `%premiumadvancements_tab_percent_%`   | Tab completion %              |

---

## Requirements

- **Paper, Spigot or Purpur** 1.20.4+
- **Java** 17+ (21+ required by MC 1.20.5+)
- **UltimateAdvancementAPI** 3.0.0-beta-3+ (required)
- **Vault** (optional, for money rewards)
- **PlaceholderAPI** (optional, for placeholders)
- **LuckPerms** (optional, for permission rewards)
- **PlayerPoints** (optional, for points rewards)
- **WorldGuard** (optional, for REGION_ENTER trigger)

---

## Full Documentation

[![Wiki](https://img.shields.io/badge/Wiki-skyxnetwork.net/advancements-blue)](https://wiki.skyxnetwork.net/advancements/)

> Everything you need to know: tabs, advancements, triggers, rewards, commands, placeholders, web editor, and more.
>
> **https://wiki.skyxnetwork.net/advancements/**

---

## ❤️ Donators

> *These amazing people help keep Premium Advancements alive. Thank you!*

| Username | Contribution |
|----------|--------------|
| **Soup** | *€15*        |

---

## Support

[Discord](https://discord.gg/pTErYjTh5h) • [Website](https://skyxnetwork.net) • [Wiki](https://wiki.skyxnetwork.net/advancements/) • [GitHub](https://github.com/XPaladiumyX/PremiumAdvancements-Releases)

---

**Made by Sky X Network**

Chek later

Curated by

Details