# Web Editor

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

Workflow

1. Upload: Run /padv editor to upload current advancements to the API
2. Authorize: Run /padv editor-trust <code> to authorize your browser (code shown in editor)
3. Edit: Use the web editor at the provided URL
4. 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

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:

1. Downloads the editor data from the API
2. Parses the JSON into advancement objects
3. Saves all tabs to their respective files
4. Removes tab files that no longer exist
5. Reloads the plugin (1 tick delay)
6. 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