Configuration & Files
config.yml
| Key | Default | Meaning |
|---|---|---|
license-key | — | Your key, activated once at the dashboard |
logic.allow-console-commands | true | Permit Run Command nodes / [console] element commands to run as server |
logic.allow-op-commands | true | Permit op-elevated commands |
placeholders.refresh-seconds | 20 | Default placeholder refresh for open screens (0 = never; per-screen override in editor) |
tebex.* | disabled | Headless-API public token, private key, complete/cancel URLs for the Tebex node |
dynamic.prefer-live-skin | true | Use the real in-game skin for heads/models first |
dynamic.skin-url | minotar | Fallback skin source ({name}/{uuid}) |
dynamic.cache-seconds | 600 | Head/skin cache |
stability.close-on-damage | true | Close the GUI when the viewer takes damage |
stability.close-on-fall | true | No mid-air opens; close when ground is lost (flying exempt) |
skin.align-x / align-y | -60 / 13 | Anvil input-skin art alignment (tune live with /nxgui skinalign) |
glyph-calibration.* · text-calibration.* · cursor.* | — | Rendering calibration — rarely needed; tweak in game, then /nxgui reload |
debug | false | Verbose logging |
Data folder layout
plugins/NxGui/
├─ config.yml
├─ screens/ ← compiled screens (one JSON per screen) — what the server runs
├─ editor/project.json ← your editable project (round-trips into /nxgui editor)
├─ output/resourcepack.zip ← the baked pack — host this for your players
├─ vars.yml ← 'global'-scope logic variables
└─ .nxgui-defaults ← marker: bundled NEXUS was seeded (delete-safe)Back up two things:
editor/project.json (your designs) and vars.yml (global data). Everything else regenerates from a deploy.