Web Editor

The web editor provides a full browser-based GUI for managing advancements. It communicates with the server via a REST API.

Workflow

Upload: Run /padv editor to upload current advancements to the API
Authorize: Run /padv editor-trust <code> to authorize your browser (code shown in editor)
Edit: Use the web editor at the provided URL
Apply: Copy the /padv apply <token> command and run it on the server

Editor Features

Sidebar: Tab selector dropdown at the top + advancement list filtered by selected tab
Tree View: Visual hierarchy with connection lines, drag-and-drop positioning, zoom/pan
5-tab Editor: Basic, Trigger, Display, Rewards, Advanced
Search & Filter: Search advancements by name or ID
Import/Export: Full JSON import and export
Tab Management: Create, rename, configure, and delete tabs
Icon Picker: Browse all Minecraft items with textures
Stale Session Detection: Warns if server data was modified externally
Auto-refresh: Detects server reloads and warns the user

v2.1+ Features

Color Code Preview (v2.1+): The editor renders all color formats in real-time:

Title and description fields show live mcPreview() with 🖌️ color/format picker (16 swatches + 6 format buttons)
Broadcast message field also has live preview + picker
Color preview in sidebar list, tree view nodes, and tooltips
Supports &0-&f legacy codes, &#RRGGBB hex, MiniMessage tags (<gradient>, <rainbow>, <bold>, <light_purple>, etc.)

Three fields are version-gated and require plugin v2.1+ (the editor detects the plugin version from the __version__ field in session data):

Field	Location	Description
Tab Position	Tab Settings > General	Sets the `tabOrder` for the tab selector GUI sorting. Lower numbers appear first.
Root Icon Custom Model Data	Tab Settings > Display	Custom model data for the tab root icon (ItemsAdder/Oraxen).

When running plugin v2.0, these fields show "Requires plugin v2.1+" placeholders.

Tab Settings modal (v2.1+): The tab settings dialog now has internal tab navigation (General / Display / Advanced) for better organization.

Inline command editing (v2.1+): Reward commands in the Rewards tab are now editable inline without opening a separate modal.

Trust System

The first time you open the web editor, it generates a trust code. You must run /padv editor-trust <code> on the server to authorize the browser session. Trust codes are stored in editor-trusted.json.

Apply Command

/padv apply <token>
/padv apply <token> --force    # Skip stale session check

The apply command:

Downloads the editor data from the API
Parses the JSON into advancement objects
Saves all tabs to their respective files
Removes tab files that no longer exist
Reloads the plugin (1 tick delay)
Re-shows all tabs to online players

Configuration

editor:
  enabled: true
  api-url: "https://api.skyxnetwork.net"
  editor-url: "https://skyxnetwork.net/editor"
  debug: false