> For the complete documentation index, see [llms.txt](https://docs.nexomc.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexomc.com/addons/scaffolding.md).

# Scaffolding

Scaffolding is a Nexo addon that brings your server's custom content to **Bedrock players** who connect through [Geyser](https://geysermc.org/).

Nexo generates a Java ResourcePack for your custom items, blocks, furniture, armor, glyphs & more. Normally Bedrock-players cannot see any of this without a complex conversion of the Java-setup. Scaffolding handles all this for you automatically. It converts your entire Nexo-setup to a Bedrock compatible one, consisting of Geyser-mappings and MCPack files. It is also automatically deployed to Geyser and always kept up-to-date with your changes in Nexo.

<p align="center">MCModels | <a href="https://nexomc.com">NexoMC</a> | Voxel.shop</p>

{% hint style="warning" %}
**Early Access**

Scaffolding is in **early access**. It has had thorough testing and covers the large majority of Nexo content, but it is not guaranteed bug-free yet. If something looks wrong on Bedrock, report it in our Discord with a screenshot and the item, block or furniture involved. Quick bug reports are what push it toward a stable release.
{% endhint %}

<details>

<summary>Requirements (click to expand)</summary>

<table><thead><tr><th width="229.666748046875">Plugin</th><th width="126.6666259765625">Needed</th><th>Notes</th></tr></thead><tbody><tr><td><a href="https://nexomc.com">Nexo</a> <strong>1.26+</strong></td><td>Required</td><td>Scaffolding is a Nexo addon and reads the pack Nexo builds.</td></tr><tr><td><a href="https://geysermc.org/">Geyser</a> <code>2.11.0-SNAPSHOT</code> +</td><td>Required</td><td>Older Geyser builds lack the mapping and extension features Scaffolding relies on.</td></tr><tr><td><a href="https://geysermc.org/">Floodgate</a></td><td>Optional</td><td>Detects Bedrock players so their outgoing text is remapped to the Bedrock-safe glyph codepoints.</td></tr><tr><td><strong>ScaffoldingExtension</strong></td><td>Optional</td><td>Ships with Scaffolding. Required for <strong>NexoFurniture and/or ModelEngine</strong>, and for Geyser on a <strong>proxy or standalone</strong> (it receives the synced output).</td></tr></tbody></table>

Your server also needs outbound internet access.\
Scaffolding uploads the pack to a hosted converter service and unpacks the result, so the game server never does the heavy conversion itself.

</details>

### Setup

Where you run Geyser decides how Scaffolding deploys, so pick your setup below.

{% tabs %}
{% tab title="Paper (Geyser-Spigot)" %}
Nexo, Scaffolding and Geyser all run on one Paper server.

1. Drop `Scaffolding.jar` into `plugins/`, alongside Nexo and Geyser-Spigot.
2. Start the server. Scaffolding auto-detects Geyser and deploys the pack into its `packs/` and `custom_mappings/`.
3. **Restart once** so Geyser loads the new mappings.

That is it, nothing to configure in the common case.
{% endtab %}

{% tab title="Velocity / BungeeCord (Geyser on the proxy)" %}
Here Geyser runs on the proxy, while Nexo and Scaffolding run on a backend Paper server.\
Scaffolding syncs its output to the proxy's Geyser **automatically** - no copying files across.

1. Install Nexo, Scaffolding & [Floodgate](https://geysermc.org/wiki/floodgate/setup?platform=proxy-servers) on the **backend Paper server.**\
   Install Geyser & Floodgate for your proxy (Velocity or BungeeCord) on the **proxy**.
2. Set up Floodgate on the backend as in the [Floodgate proxy guide](https://geysermc.org/wiki/floodgate/setup?platform=proxy-servers):
   * `auth-type: floodgate` in the proxy Geyser's `config.yml`
   * `send-floodgate-data: true` in the proxy Floodgate's `config.yml`
   * Copy `key.pem` from the proxy Floodgate's folder into the backend Floodgate's folder
   * Player info forwarding enabled between the proxy and the backend
3. Drop `ScaffoldingExtension.jar` into the proxy Geyser's `extensions/` folder:\
   `plugins/Geyser-Velocity/extensions/` or `plugins/Geyser-BungeeCord/extensions/`.
4. Start everything. After a conversion, Scaffolding hands the output to Geyser over the **players' own Minecraft connection** - no ports to open, no shared folders needed.
5. **Restart the proxy once** so Geyser loads the new mappings, and have Bedrock players reconnect.

{% hint style="info" %}
The default transport needs a **Bedrock player online** to carry the data. If nobody is on when a conversion finishes, the next Bedrock player to join delivers it.\
`/scf sync` re-sends the last output on demand, and `/scf status` shows whether the proxy's Geyser is up to date.
{% endhint %}

{% hint style="success" %}
**Sharing a filesystem?** (same machine, Docker volume, network mount)\
Set `sync.type: FOLDER` in both the plugin's and the extension's `config.yml`, and point `sync.folder` on both sides at the same folder. Output then applies within seconds, with no player needed to carry it.
{% endhint %}

{% hint style="warning" %}
Run Nexo and Scaffolding on **one** server behind the proxy.

The proxy's Geyser serves that one server's converted content.
{% endhint %}
{% endtab %}

{% tab title="Geyser-Standalone" %}
Geyser-Standalone runs as its own program and joins your server the way a Java player would.\
The setup is the same as on a proxy:

1. Install Nexo, Scaffolding & Floodgate on the **Paper server**\
   Run **Geyser-Standalone** wherever suits you. There is no separate Floodgate for it.
2. Connect it to Floodgate as in the [Floodgate standalone guide](https://geysermc.org/wiki/floodgate/setup?platform=standalone):
   * `auth-type: floodgate` in Geyser-Standalone's `config.yml`
   * Copy `key.pem` from the Paper server's Floodgate folder into the Geyser-Standalone folder
3. Drop `ScaffoldingExtension.jar` into the standalone Geyser's `extensions/` folder.
4. Start everything. The output syncs over Geyser's connection to your server, so this works across machines with no extra ports.
5. **Restart the standalone Geyser once** so it loads the new mappings, and have Bedrock players reconnect.

The same notes as the proxy tab apply: a Bedrock player carries the data (the next one to join picks it up), `/scf sync` re-sends the last output, and `sync.type: FOLDER` is available when both sides can reach one folder.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Why the restart?**

Geyser loads custom mappings only at startup, and Bedrock re-downloads packs only on reconnect.\
So after changing your Nexo content, restart and have Bedrock players reconnect.\
Scaffolding logs when a restart is needed and stays quiet otherwise.
{% endhint %}

{% hint style="warning" %}
When Geyser runs on a **proxy** or **standalone**, Floodgate must be set up so the backend can tell who is a Bedrock player ([proxy guide](https://geysermc.org/wiki/floodgate/setup?platform=proxy-servers), [standalone guide](https://geysermc.org/wiki/floodgate/setup?platform=standalone)).\
This is needed for Glyphs & ModelEngine to work correctly
{% endhint %}

### Supported

<table><thead><tr><th width="180.6666259765625">Feature</th><th width="112.3333740234375">Status</th><th>Notes</th></tr></thead><tbody><tr><td>Items (2D and 3D)</td><td>✅ Works</td><td>3D models become held Bedrock models with an auto-rendered inventory icon; 2D items become sprites.</td></tr><tr><td>Dyeable models and furniture</td><td>✅ Works</td><td>Dyed and tinted models and furniture keep their color on Bedrock.</td></tr><tr><td>Bows, crossbows and tridents</td><td>✅ Works</td><td>Their draw and throw animations are rebuilt natively on Bedrock.</td></tr><tr><td>Custom blocks</td><td>✅ Works</td><td>All Nexo CustomBlocks (note-block, string, chorus, etc.) become real Bedrock custom blocks, with their sounds. Carpentry blocks likely work too, but are not fully tested yet.</td></tr><tr><td>Armor &#x26; Elytras for Players</td><td>✅ Works</td><td>Custom armor with an equipment texture renders as worn armor, elytras included.</td></tr><tr><td>Armor for mobs</td><td>✅ Works</td><td>Custom horse armor, wolf armor and llama decor render on Bedrock.</td></tr><tr><td>Glyphs and emotes</td><td>✅ Works *</td><td>Rebuilt as Bedrock glyph sheets, so they show in chat, names and UI. Tune their Bedrock size per glyph or font ( <a data-mention href="https://docs.nexomc.com/addons/scaffolding/emotes-and-glyphs.md">Emotes &amp; Glyphs</a> )</td></tr><tr><td>Custom sounds</td><td>✅ Works</td><td>Remapped so Bedrock players hear them</td></tr><tr><td>Custom GUIs</td><td>✅ Works</td><td>A title glyph that draws a custom inventory background is reproduced automatically(<a data-mention href="#custom-gui-and-hud">#custom-gui-and-hud</a>)</td></tr><tr><td>Vanilla GUI &#x26; HUD Overrides</td><td>✅ Works</td><td>Replaced vanilla GUIs &#x26; HUD-elements are supported</td></tr><tr><td>NexoFurniture</td><td>✅ With extension</td><td>Requires <a data-mention href="#scaffoldingextension">#scaffoldingextension</a></td></tr></tbody></table>

{% hint style="info" %}
**\* Glyphs on Bedrock**

Bedrock renders a glyph at its baked pixel size, so **scale and sharpness are tied together.**\
This is different from **Java,** where a glyph's size is set independently from its texture resolution.\
A larger texture meant to render as a small icon can therefore look **blurry** on Bedrock.\
See Emotes & Glyphs on Bedrock for how to tune this per glyph or font in `glyphs.yml`.

Geyser-Velocity & Geyser-Standalone also requires Floodgate for glyphs to function.
{% endhint %}

{% hint style="info" %}
Bedrock picks an item's look once from its data; it can't react to live gameplay states like Java.\
So **live-state model swaps,** like renaming an item, are not going to transfer over.
{% endhint %}

### Third-party plugins

Scaffolding also supports other big plugins, so your Bedrock players get the full experience.

<table><thead><tr><th width="180.6666259765625">Plugin</th><th width="112.3333740234375">Status</th><th>Notes</th></tr></thead><tbody><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-33da31d39041cb9de268d79cc5697ea09f457717%2Fmodelengine.png?alt=media" alt="" data-size="original"></p><p> <a href="https://mythiccraft.io/index.php?resources/model-engine%E2%80%94ultimate-entity-model-manager-1-19-4-26-2.1213/">ModelEngine</a></p></td><td>✅ With extension</td><td>Requires <a data-mention href="#scaffoldingextension">#scaffoldingextension</a></td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-f88612176d28bc7767c7e8f125c24c0c57ecc805%2Fmythichud.png?alt=media" alt="" data-size="original"></p><p> <a href="https://mcmodels.net/products/13679/mythichud">MythicHUD</a></p></td><td>✅ Works</td><td>Its HUD elements are rebuilt for Bedrock players.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-679d0fc12aca22b38d1739338e721cd4727da6b8%2Fmythicarmor.png?alt=media" alt="" data-size="original"></p><p> <a href="https://mcmodels.net/products/16936/mythic-armors">MythicArmors</a></p></td><td>✅ Works</td><td>Custom MythicArmors sets render as worn armor on Bedrock.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-14dae1b2af101e74a1bd6bd828092dce4b4f55d7%2Fhmccosmetics.png?alt=media" alt="" data-size="original"></p><p> <a href="https://www.spigotmc.org/resources/hmccosmetics.100107/">HMCCosmetics</a></p></td><td>✅ Works</td><td>Hats, backpacks and the wardrobe show for Bedrock players. The <a data-mention href="#scaffoldingextension">#scaffoldingextension</a> keeps the wardrobe camera in first person. Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-5485bd6d6dd21bfd59c9daf68fc28b4a8fc379b0%2Fbettermodel.png?alt=media" alt="" data-size="original"></p><p> BetterModel</p></td><td>✅ With extension</td><td>Requires <a data-mention href="#scaffoldingextension">#scaffoldingextension</a>. Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-54c5ae92f43e2a9faf7280b170a309a21a231206%2Fbetterhud.png?alt=media" alt="" data-size="original"></p><p> BetterHUD</p></td><td>✅ Works</td><td>Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-6947546abd53b44f9fb473aa2495798f8dd43cd1%2Fcustomnameplates.png?alt=media" alt="" data-size="original"></p><p> <a href="https://voxel.shop/product/2543/customnameplates">CustomNameplates</a></p></td><td>✅ Works</td><td>Nameplates convert, but chat bubbles do not work on Bedrock.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-4d0e1613bd594db381b5a319311147e4d3688de6%2Fcustomfishing.png?alt=media" alt="" data-size="original"></p><p> <a href="https://voxel.shop/product/2723/customfishing">CustomFishing</a></p></td><td>✅ Works</td><td>Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-dc574d7ebaaf6658fbb4354932a5c578dfe06f50%2Fluxdialogues.png?alt=media" alt="" data-size="original"></p><p> LuxDialogues</p></td><td>✅ Works</td><td>Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr><tr><td><p><img src="https://548966760-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTAoAxayP9PrBtX9UQ5wa%2Fuploads%2Fgit-blob-f7c9018805588bacdd0950d9e60ad6772e9e6c15%2Ftooltips.png?alt=media" alt="" data-size="original"></p><p> <a href="https://www.spigotmc.org/resources/%E2%AD%90tooltips.109912/">Tooltips</a></p></td><td>✅ Works</td><td>Tooltips are redrawn natively on Bedrock with their themes. Support is still fresh, so you may hit slight issues. Please report any bugs you find in our Discord.</td></tr></tbody></table>

### Not yet supported

Scaffolding aims for parity, but a few Nexo features do not convert yet or have known rough edges on Bedrock:

<table><thead><tr><th width="173">Feature</th><th width="129.0001220703125">Status</th><th>Notes</th></tr></thead><tbody><tr><td>Custom spears</td><td>⚠️ Partial</td><td>Spears look correct on Bedrock, but their animations do not play properly yet.</td></tr><tr><td>Custom paintings</td><td>❌ Not converted</td><td>Custom paintings show as vanilla for Bedrock players.</td></tr><tr><td>Hopper / dropper / dispenser reskins</td><td>❌ Not converted</td><td>These Bedrock screens are hardcoded and cannot be customized via a resource pack at the moment, so a reskin cannot reach them (see Custom GUI &#x26; HUD).</td></tr></tbody></table>

### Custom GUI & HUD

On Java a custom screen is one of two things: a glyph placed in a custom inventory's title (a GUI background), or a replaced vanilla HUD texture. Scaffolding reproduces both on Bedrock, along with reskins of vanilla container screens.

{% hint style="warning" %}
**Automatic alignment is approximate**

Bedrock and Java lay their screens out differently, so the automatic placement is **not guaranteed pixel-perfect** and some GUIs can show larger inconsistencies.\
See Custom GUI & HUD for per-screen support, the HUD elements covered, and how to nudge or override a background.
{% endhint %}

### ScaffoldingExtension

**Furniture** and **ModelEngine** models are not drawn by the resource pack alone, so Scaffolding ships a companion Geyser extension that recreates them on Bedrock. Drop `ScaffoldingExtension.jar` into Geyser's `extensions/` folder and restart.

{% hint style="warning" %}
Without the ScaffoldingExtension, items, blocks, armor and glyphs still convert and show, but **furniture and ModelEngine models will not render** for Bedrock players.
{% endhint %}

See [#scaffoldingextension](#scaffoldingextension "mention") for install detail, how furniture and ModelEngine are handled.

### Configuration

Defaults work for almost everyone, and the config is found at `plugins/Scaffolding/config.yml` .

<table><thead><tr><th width="198.333251953125">Setting</th><th width="97">Default</th><th>Purpose</th></tr></thead><tbody><tr><td><code>general.autoConvert</code></td><td><code>true</code></td><td>Convert and deploy whenever Nexo rebuilds its pack. Off means only <code>/scf reload</code> converts.</td></tr><tr><td><code>general.debug</code></td><td><code>false</code></td><td>Log conversion details and write <code>output/report.json</code>. Turn it on when reporting a problem.</td></tr><tr><td><code>general.cacheSize</code></td><td><code>10</code></td><td>How many past conversions to keep on disk, so switching back to an earlier setup is instant. <code>0</code> keeps none.</td></tr><tr><td><code>pack.name</code></td><td><code>Scaffolding</code></td><td>Name Bedrock shows for the pack. Split packs append their part, e.g. <code>Scaffolding Glyphs</code>. Changing it makes Bedrock players download the pack again.</td></tr><tr><td><code>pack.description</code></td><td><code>Generated by Scaffolding</code></td><td>Description shown under the pack name on Bedrock.</td></tr><tr><td><code>pack.split</code></td><td><code>false</code></td><td>Ship one pack per kind of content, so a change only re-sends the part that changed. Players can then pick animated, light or static items (needs the ScaffoldingExtension, see <a data-mention href="https://docs.nexomc.com/addons/scaffolding/scaffoldingextension.md#resource-pack-options">ScaffoldingExtension</a>).</td></tr><tr><td><code>optimizations.iconSize</code></td><td><code>X64</code></td><td>Inventory icon size: <code>X16</code>, <code>X32</code>, <code>X64</code> or <code>X128</code>.</td></tr><tr><td><code>optimizations.compression</code></td><td><code>BALANCED</code></td><td>Texture compression: <code>FAST</code> (biggest pack), <code>BALANCED</code>, or <code>MAX</code> (smallest pack, slowest conversion).</td></tr><tr><td><code>optimizations.animatedItems</code></td><td><code>FULL</code></td><td><code>FULL</code> looks best but copies the model per frame. <code>SIMPLE</code> copies nothing, pick it if Bedrock players crash on join. <code>NONE</code> shows the first frame only.</td></tr><tr><td><code>optimizations.soundQuality</code></td><td><code>ORIGINAL</code></td><td><code>ORIGINAL</code>, <code>COMPRESSED</code> or <code>COMPRESSED_MONO</code>. Needs ffmpeg on the converter host, and a sound is only replaced when it gets smaller.</td></tr><tr><td><code>text.font</code></td><td><code>JAVA</code></td><td><code>JAVA</code> draws Bedrock text in Java's font. <code>BEDROCK_SMALL_CAPS</code> keeps Bedrock's font but fixes small caps. <code>BEDROCK</code> keeps Bedrock's own font.</td></tr><tr><td><code>text.hexColors</code></td><td><code>48</code></td><td>How many hex colours Bedrock can draw exactly, on top of its own 16. <code>0</code> turns this off.</td></tr><tr><td><code>text.hexColorItems</code></td><td><code>false</code></td><td>Also colour item names and lore exactly. Leave it off if Bedrock players use creative mode.</td></tr><tr><td><code>chat.enabled</code></td><td><code>true</code></td><td>Restyle Bedrock chat to look and fade like Java's.</td></tr><tr><td><code>chat.bottomLeft</code></td><td><code>true</code></td><td>Move chat to the bottom left at Java's size, on the classic UI only.</td></tr><tr><td><code>chat.forceFont</code></td><td><code>true</code></td><td>Draw chat in Minecraft's default font and size, overriding each player's chat font settings.</td></tr><tr><td><code>chat.forceDuration</code></td><td><code>false</code></td><td>Keep chat lines 10 seconds like Java, overriding each player's chat duration.</td></tr><tr><td><code>sidebar.numbers</code></td><td><code>AUTO</code></td><td>The red score numbers: <code>AUTO</code> hides them where Java does (needs the ScaffoldingExtension), <code>HIDE</code> or <code>SHOW</code>.</td></tr><tr><td><code>sidebar.javaBackground</code></td><td><code>false</code></td><td>Draw Java's dark background behind the sidebar.</td></tr><tr><td><code>tabList.enabled</code></td><td><code>true</code></td><td>Let Bedrock players see Java's tab list with <code>/tablist</code>.</td></tr><tr><td><code>tabList.doubleSneak</code></td><td><code>true</code></td><td>Also open it by sneaking twice quickly.</td></tr><tr><td><code>tabList.seconds</code></td><td><code>5</code></td><td>How long it stays open, 1 to 60 seconds.</td></tr><tr><td><code>hudOffsets.mythichud / betterhud</code></td><td><code>{}</code></td><td>Move HUD elements up or down on Bedrock, in pixels, keyed by layout or <code>layout/element</code>.</td></tr><tr><td><code>vanillaReskins.enabled</code></td><td><code>true</code></td><td>Convert the pack's reskins of vanilla items, trims, blocks and menus.</td></tr><tr><td><code>vanillaReskins.blockShapes</code></td><td><code>false</code></td><td>Also rebuild vanilla blocks the pack reshapes, so the shape shows on Bedrock. This changes every placed block of that type.</td></tr><tr><td><code>items.weaponPoses</code></td><td><code>true</code></td><td>Give custom shields, bows and crossbows the vanilla pose while blocking or drawing. Replaces Bedrock's player entity file, so turn it off if another Bedrock pack changes player animations.</td></tr><tr><td><code>items.modelBaseItems</code></td><td><code>{}</code></td><td>Base item(s) for <code>item_model</code> ids Nexo does not own (dummy models, items from other plugins). Quote the model id; a model shared by several base items takes a list.</td></tr><tr><td><code>displayEntities.blocks</code></td><td><code>SEEN</code></td><td><code>SEEN</code> draws the block displays your server shows as the real block, <code>ALL</code> every block (about 1.2 MB more), <code>OFF</code> held block items. Needs the ScaffoldingExtension.</td></tr><tr><td><code>displayEntities.itemContexts</code></td><td><code>true</code></td><td>Item displays use an item's ground, item frame or head model instead of its held model. Each such model adds one Bedrock item. Needs the ScaffoldingExtension.</td></tr><tr><td><code>models.modelEngine</code></td><td><code>true</code></td><td>Show ModelEngine models to Bedrock players. Off makes the pack smaller, but they then see nothing there.</td></tr><tr><td><code>models.betterModel</code></td><td><code>true</code></td><td>The same for BetterModel models.</td></tr><tr><td><code>sync.type</code></td><td><code>PLUGIN_MESSAGE</code></td><td>How output reaches a remote Geyser (proxy or standalone, see Setup): <code>PLUGIN_MESSAGE</code> (over the players' connection, no ports), <code>FOLDER</code> (a shared folder), or <code>NONE</code>.</td></tr><tr><td><code>sync.folder</code></td><td>blank</td><td><code>FOLDER</code> only: a folder both this server and Geyser can reach.</td></tr><tr><td><code>sync.serverId</code></td><td>blank</td><td>The name this server goes by on the shared Geyser. Blank uses the server folder name.</td></tr><tr><td><code>converter.channel</code></td><td><code>STABLE</code></td><td>Which hosted converter to use: <code>STABLE</code> or <code>DEV</code>.</td></tr><tr><td><code>converter.timeout</code></td><td><code>10m</code></td><td>How long to wait for a conversion. Accepts <code>30s</code>, <code>10m</code>, <code>1h</code>.</td></tr></tbody></table>

A few settings are left out of the file because almost no server needs them. They are still read when you add them by hand:

<table><thead><tr><th width="198.333251953125">Setting</th><th width="97">Default</th><th>Purpose</th></tr></thead><tbody><tr><td><code>converter.url / converter.jar</code></td><td>blank</td><td>Not written by default. <code>url</code> points at a self-hosted converter, <code>jar</code> converts on this machine with no upload.</td></tr><tr><td><code>models.modelEnginePartSwaps</code></td><td>blank</td><td>Not written by default. Only needed when a plugin swaps a ModelEngine part onto a bone with a different name (for example Scenes' <code>left_pant</code> taking a <code>hat</code>), one line per pair: <code>"host_blueprint.host_bone &#x3C;- source_blueprint.source_bone"</code>, <code>*</code> for every blueprint. Same-name swaps are found automatically.</td></tr><tr><td><code>menus.geyserChestWindows</code></td><td><code>false</code></td><td>Not written by default. Turn it on if custom chest GUI art sits 1px above the slots on Bedrock.</td></tr><tr><td><code>glyphs.pixelArt</code></td><td><code>true</code></td><td>Not written by default. <code>false</code> resamples every glyph to its exact Java height; per glyph or font overrides go in <code>glyphs.yml</code>.</td></tr></tbody></table>

Two optional files sit next to it, both generated for you and only needed for fine-tuning:

| File         | Purpose                                                                                                                                                    |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `gui.yml`    | Per-GUI overrides for custom inventory backgrounds on Bedrock ( [Custom GUIs & HUDs](https://docs.nexomc.com/addons/scaffolding/custom-guis-and-huds.md) ) |
| `glyphs.yml` | The size a glyph or font is baked at on Bedrock ( [Emotes & Glyphs](https://docs.nexomc.com/addons/scaffolding/emotes-and-glyphs.md) )                     |

### Commands

The base command is `/scaffolding` (aliases `/scaffold`, `/scf`).

<table><thead><tr><th width="302.333251953125">Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>/scf help</code></td><td>List the available commands.</td></tr><tr><td><code>/scf reload &#x3C;-f></code></td><td>Reconvert the current Nexo pack and redeploy to Geyser (<code>rl</code> also works). Add <code>-f</code> to force new conversion, even when setup is the same</td></tr><tr><td><code>/scf status</code></td><td>Show the converter service, the last output pack, the sync target, and check that both are reachable.</td></tr><tr><td><code>/scf sync</code></td><td>Send the last converted output to the remote Geyser again (see <code>sync.type</code>). Useful after wiping or moving the proxy's Geyser folders.</td></tr><tr><td><code>/scf gui list</code></td><td>List the GUI overlays configured in <code>gui.yml</code>.</td></tr><tr><td><code>/scf gui import &#x3C;glyph> [screen]</code></td><td>Add a glyph to <code>gui.yml</code> as an overlay and reconvert (screen defaults to <code>container</code>).</td></tr><tr><td><code>/scf cache list</code> / <code>clear</code></td><td>Inspect or clear the on-disk conversion cache.</td></tr></tbody></table>
