In-Game GUI System

The plugin provides 7 graphical interfaces for managing advancements in-game.

AdvancementMainGUI

Size: 54 slots
Title: "&8Premium Advancements" (unfiltered) or "&8Tab: <name>" (tab-filtered)
Access: /padv gui

Layout:

Slots 10-16, 19-25, 28-34 (21 slots): Advancement items, paginated
Slot 45 (feather): Previous page (shown when page > 0)
Slot 48 (compass): Tab selector / back to tabs (shown when multiple tabs exist)
Slot 49 (emerald block): Create new advancement
Slot 53 (feather): Next page (shown when page < max)
Other slots: Gray stained glass pane decoration

Interactions:

Left-click on an advancement: Opens the edit GUI
Right-click on an advancement: Opens the delete confirmation GUI

AdvancementCreateGUI

Size: 54 slots
Title: "&8Create Advancement"
Access: Click the emerald block in the main GUI

Line 1 (Slots 10-13): Basic Info

Slot 10: Title (click to type in chat)
Slot 11: Description (click to type in chat)
Slot 12: Icon (click to type material name in chat)
Slot 13: Icon Custom Model Data

Line 1 (Slots 14-16): Reward Types

Slot 14: Item Rewards toggle
Slot 15: Permission Rewards toggle
Slot 16: PlayerPoints toggle

Line 2 (Slot 19): Trigger

Click to cycle through trigger types via chat input

Line 3 (Slots 28-29): Contextual Configuration

Depends on the selected trigger type

Line 4 (Slots 20-25, 30-34): Display & Sound

Slot 20: Custom Model Data / contextual field
Slot 21: Position X
Slot 22: Position Y
Slot 23: Frame type (cycles: TASK -> GOAL -> CHALLENGE -> TASK)
Slot 24: Random Reward Pools
Slot 25: Discord Webhook toggle
Slot 30: Toast notification toggle
Slot 31: Chat announce toggle
Slot 32: Action bar toggle
Slot 33: Sound settings
Slot 34: Broadcast toggle

Line 5 (Slots 37-39): Rewards

Slot 37: Command Rewards toggle
Slot 38: Reward Commands (click to add, right-click to clear)
Slot 39: Money Reward

Line 6 (Slots 40-44): Advanced

Slot 40: Dependencies / Requirements
Slot 41: Hidden toggle (locked until dependencies set)
Slot 42: World restrictions
Slot 43: Permission requirement
Slot 44: Visual connection target

Bottom:

Slot 49: Save / Create (green wool)
Slot 53: Cancel (red wool)

AdvancementEditGUI

Size: 54 slots
Title: "&8Edit: {title}"
Access: Left-click an advancement in the main GUI

Same layout as the create GUI with these differences:

Slot 49: Save Changes (green wool)
Slot 53: Back (barrier)
Additional edit features: Item rewards, Permission rewards, PlayerPoints, Broadcast, Reward pools

ConfirmDeleteGUI

Size: 27 slots
Title: "&cConfirm Delete"
Access: Right-click an advancement in the main GUI

Layout:

Slot 11: Confirm (red wool)
Slot 13: Advancement icon with warning lore
Slot 15: Cancel (gray wool)

Customizing Vanilla Advancement Broadcasts

When viewing a vanilla tab (e.g. "Minecraft") in the main GUI, each vanilla advancement is displayed with its icon, title, and description. You can customize the chat broadcast message for any vanilla advancement:

Left-click a vanilla advancement → opens chat input. Type your custom broadcast message and press Enter. Supports %player%, %advancement% (with hover tooltip showing the description), %description%, all color formats (&#RRGGBB, <gradient>, <rainbow>, & codes), and PlaceholderAPI placeholders.
Right-click a vanilla advancement → removes the custom message, reverting to the default vanilla broadcast.
Messages are stored in vanilla-messages.yml and take effect immediately — no reload needed.

StatsGUI

Size: 54 slots
Title: "&8Stats: {player}"
Access: /padv stats [player]

Layout:

Slot 0: Most recent completion
Slot 4: Player head with completion count and percentage
Slots 10-16, 19-25, 28-34: Paginated advancement list
- Completed: Shows progress bar and completion time
- In progress: Shows current progress
- Locked (hidden + not completed): Shows as BARRIER with "???"
- Not started: Shows as missing or locked

TabSelectorGUI

Size: 54 slots
Title: "&8Select Tab"
Access: Opens automatically when multiple tabs exist and /padv gui is used. Also accessible via the compass button (slot 48).

Layout:

Slots 10-16, 19-25, 28-34: Tab icons with name, namespace, advancement count
Slot 49: Info book explaining how to create/delete tabs (web editor or manual YAML)

Tab ordering: Tabs are sorted by their tabOrder value (ascending). Custom tabs use the tabOrder field in their YAML file or the Tab Position field in the web editor. Vanilla tabs use vanilla-tab-order in config.yml.

TabSettingsGUI

Size: 27 slots
Title: "&8Tab Settings: {name}"
Access: Right-click a tab in the TabSelectorGUI

Layout:

Slot 11 (comparator): Tab Position / Order -- left-click to change, right-click to reset to default (999)
Slot 13 (name tag / paper): Root Icon Custom Model Data -- left-click to change, right-click to clear
Slot 15 (tab root icon material): Root Icon info -- display only
Slot 22 (barrier): Back to tab selector
Slot 26 (green wool): Save & Close

Saving:

Custom tabs: saves to the tab's .yml file (tab.tabOrder, root.iconCustomModelData)
Vanilla tabs: saves vanilla-tab-order to config.yml
Run /padv reload to apply changes