Configuration

config.yml

Language

language: 'en'

Available options: en (English), fr (French). Custom language files can be placed in the languages/ folder.

Database

database:
  type: 'sqlite'                # 'sqlite' or 'mysql'/'mariadb'
  host: 'localhost'             # MySQL only
  port: 3306                    # MySQL only
  database: 'premiumadvancements' # MySQL only
  username: 'root'              # MySQL only
  password: ''                  # MySQL only

Webhook (Global Toggle)

webhook:
  enabled: false                # Master switch for all Discord webhooks
  url: ""                       # Discord webhook URL
  vanilla:
    enabled: false              # Send webhooks for vanilla Minecraft advancements

Progression Display

progression:
  show-actionbar: true          # Show progress in action bar

When false, all action bar messages are suppressed globally and the action bar toggle in the creation/edit GUI is disabled.

Vanilla Tab Order

vanilla-tab-order:
  story: 1
  nether: 2
  end: 3
  adventure: 4
  husbandry: 5

Defines the display order of built-in Minecraft advancement tabs in the TabSelectorGUI. Edit these values to reorder vanilla tabs among your custom tabs. Custom tabs use the Tab Position field from the web editor or tabOrder in their YAML file. Changes survive plugin reload.

Web Editor

editor:
  enabled: true                 # Enable/disable the web editor
  api-url: "https://api.skyxnetwork.net"
  editor-url: "https://skyxnetwork.net/editor"
  debug: false                  # Enable verbose editor logs

Metrics

metrics:
  enabled: true                 # bStats metrics (ID: 28395)

Webhook Configuration (webhook.yml)

Controls the Discord embed appearance when advancements are completed. Each advancement can enable webhooks individually via webhook-enabled: true.

Allowed Placeholders

Placeholder	Description
`%player%`	Player name
`%advancement%`	Advancement title
`%description%`	Advancement description
`%rewards%`	Formatted rewards list

Embed Structure

embed:
  title: "&6&l%player% completed **%advancement%**!"
  description: "> %description%"
  color: "#FFAA00"                # Hex color
  timestamp: true                 # Append UTC timestamp

  author:
    enabled: true
    name: "%player%"
    icon_url: ""                  # Empty = auto via mc-heads.net
    url: ""

  thumbnail:
    enabled: true
    url: ""                       # Empty = auto player avatar

  image:
    enabled: false
    url: ""

  footer:
    enabled: true
    text: "PremiumAdvancements"
    icon_url: ""

  fields:
    rewards:
      enabled: true
      name: "Rewards"
      value: "auto"               # "auto" builds reward list automatically
      inline: false
      empty_text: "*No rewards*"

Vanilla Messages (vanilla-messages.yml)

Store custom in-game broadcast messages for vanilla Minecraft advancements. When a player completes a vanilla advancement (e.g., "Diamonds!"), and a matching entry exists with enabled: true, the message is broadcast to the entire server. Custom messages can be configured either via the in-game GUI or by editing this file directly.

In-Game GUI: Open /padv gui, select a vanilla tab (e.g. "Minecraft"), and left-click any advancement. Type your custom broadcast message in chat. Supports all color formats: &#RRGGBB hex, <gradient>, <rainbow>, <color:#XXXXXX>, & codes, and PlaceholderAPI placeholders. Right-click a vanilla advancement to reset its message to default.

Allowed Placeholders

Placeholder	Description
`%player%`	Player name
`%advancement%`	Advancement title (with hover tooltip showing the description)
`%description%`	Advancement description

Format

"minecraft:story/mine_diamond":
  enabled: true
  message: "&b%player% found Diamonds!"

"minecraft:nether/obtain_blaze_rod":
  enabled: true
  message: "&6%player% obtained a Blaze Rod!"