# :icon-download: Installation

* * *

#### 

**Installation Steps**

1. Place the `PremiumAdvancements.jar` in your `plugins/` folder
2. Ensure `UltimateAdvancementAPI` is installed and up-to-date
3. **Optional (v2.5+):** Install `WorldGuard` for the `REGION_ENTER` trigger
4. Restart the server
4. 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:

1. Detects `advancements.yml` and/or `adv-gui.yml` at the plugin root
2. Creates a backup in `backups/migration_<timestamp>/`
3. Merges both files into `Advancements/default.yml`
4. Renames old files to `.migrated`
5. 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
```