# Installation

#

Installation Steps

Place the PremiumAdvancements.jar in your plugins/ folder
Ensure UltimateAdvancementAPI is installed and up-to-date
Restart the server
The plugin creates the following structure automatically:

plugins/PremiumAdvancements/
├── Advancements/
│   └── default.yml          Default tab with example advancement
├── backups/                 Backup files
├── languages/               Language files
├── config.yml               Main configuration
├── webhook.yml              Discord webhook configuration
├── data.db                  SQLite database (if using SQLite)
├── .config-version          Tracks config version for updates
└── editor-session.json      Web editor session data

#

Migration from v1.70

On first startup after updating to v2.0, the plugin automatically:

Detects advancements.yml and/or adv-gui.yml at the plugin root
Creates a backup in backups/migration_<timestamp>/
Merges both files into Advancements/default.yml
Renames old files to .migrated
Notifies online admins about the migration

#

File Structure

plugins/PremiumAdvancements/
├── Advancements/               Each .yml file = one advancement tab
│   ├── default.yml             Default tab (auto-created)
│   ├── survival.yml            Example tab
│   └── combat.yml              Another tab
├── backups/                    Automatic backups
│   ├── config_2026-06-21_18-30-00.yml
│   └── migration_2026-06-21_18-30-00/
│       ├── advancements.yml
│       └── adv-gui.yml
├── languages/                  Language files
│   ├── en.yml                  English (default)
│   └── fr.yml                  French
├── config.yml                  Main configuration
├── webhook.yml                 Discord webhook config
├── data.db                    SQLite database (if applicable)
├── .config-version            Internal version tracker
└── server.id                  License server fingerprint