> ## Documentation Index > Fetch the complete documentation index at: https://docs.rageon.dev/llms.txt > Use this file to discover all available pages before exploring further. # Hot reload > See edits to an open structure in a connected game on your own FiveM server, without exporting or restarting. Hot reload sends the structure you are editing to a FiveM server running on your computer. A player connected to it sees the changes after a short pause, with no export in between. It only follows the structure open in **Structures**, and it stays on when you switch tools or tabs. Closing the project turns it off. ![Hot reload pill in its states, from off to applied to server problems](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/projects/hot-reload-pill.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=7ebe4fb2df15ad0ce6bfa875b0a3485a) The Hot reload pill in each state, next to the project sheet. ## What the server needs * FXServer running on the same computer as Rageon. * The server linked in **Settings** › **Bridge**, with the `rageon-bridge` resource installed. * `ensure rageon-bridge` in the server's `server.cfg`. Rageon copies the resource but never edits `server.cfg`. * A server restart after you install or update the bridge. * No exported copy of the same project running on that server. Remove its `ensure` line and restart. Rageon tells you when the bridge is missing or too old, and offers the fix. ## Link a server **1. Add the server** Click the **Settings** gear in the title bar, open the **Bridge** tab, click **Add**, and choose the server folder. Each row shows the server's name, its `resources/` path, whether it is online, and the state of its bridge. ![Bridge settings listing FiveM servers with online dots and bridge badges](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/projects/bridge-settings.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=81da8b63da8d4c067428ab3c51cf7fd6) Settings › Bridge with linked servers and their bridge states. **2. Install the bridge** Open **Actions for …** on the server row and choose **Install**. Choose **Reinstall** when the badge says **outdated**. The badge turns **current** when the installed files are up to date; the server still needs a restart to use them. **3. Restart the server** Add `ensure rageon-bridge` to `server.cfg` if it is not there, then restart the server. **Remove … from the list** only unlists the server. The resource stays in the server folder. **Open directory** opens the install destination; **Change destination folder…** chooses a different folder under `resources/`. The bridge badges are **checking**, **missing**, **current**, **outdated**, **error**, and **installing** during installation. ## Turn it on **1. Open a structure** In **Structures**, open the structure you want to test. **2. Open the Hot reload pill** Click **Hot reload**, choose a server, then switch **Hot reload** on. The switch and server selector are disabled until you link a server; **Reload now** is enabled only when hot reload is on and the server is ready. **Automatic** uses the first linked server with an export destination remembered for this project. If none is remembered, it uses the first online server, or the first linked server if all are stopped. ![Hot reload popover with the switch on, server My PC online, and Reload now](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/projects/hot-reload-popover.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=12ba11a92b8e04360cf6d8e99ebc0b19) The popover with the server, engine, last reload, and parts. **3. Edit** With the default **On edit** trigger, a pause in editing starts a reload. Wait for **applied** to confirm it succeeded; **Reload now** requests another reload. Switch **Hot reload** off to remove the preview from the server. ## Pill states | Pill | Meaning | | - | - | | Gray dot | Off. | | Spinner | A reload is being assembled or applied. | | Green dot | **applied**: the last reload went through. **online**: it is on and the server is ready, nothing applied yet. | | Red dot | The last reload failed. | | Amber dot | A server problem: no server, server stopped, no `rageon-bridge`, outdated bridge, restart needed, no collision layers, or the project resource is live. Open the popover to read it. | ## Advanced settings Click **Advanced settings…** in the popover. ![Hot reload settings with Server, Reload, Collision, Parts, and Session sections](https://mintcdn.com/rageon/SL02705KjqddBRzg/images/projects/hot-reload-settings.webp?fit=max\&auto=format\&n=SL02705KjqddBRzg\&q=85\&s=510036928ea3f51ef772d79e4c0db280) Hot reload settings. | Option | What it does | Default | | - | - | - | | **Server** | Which server receives the preview. **Manage servers…** opens **Settings** › **Bridge**. | **Automatic** | | **Port** | The port of the game server. The detected value is shown as a placeholder. Enter a port from 1 to 65535 to override it; clear the override to use detection again. | Detected | | **Trigger** | **On edit** reloads after a pause in editing, **On save** when you save the project, **Manual** only on **Reload now**. | **On edit** | | **Wait after editing** | The pause before an **On edit** reload, 300 to 3000 ms. Disabled for other triggers. | 300 ms | | **Update map collision** | Swaps the collision with each reload. While on, anyone near the area gets a black screen for about 2 seconds on every collision swap. While off, only the geometry swaps and the map's original collision stays solid. | On | | **Parts** | One switch per part of the structure, with the number of objects it reloads. Turn off the parts you are not testing. | All on | | **Clear previews** | Removes the preview from the server. Disabled without a server session. | | | **Open folder** | Opens the hot reload folder on the server. Disabled without a selected server. | | **Collision layers** shows how many of the session's collision swaps are used. **Session** shows the models registered on the server. **Log** lists the last 20 reloads, newest first, with the time of each phase in seconds. ## What does not reload Rooms, portals, lights, timecycle, entity sets, sound, and the edited game interior do not reload. Export, then reconnect to the server to see them. The **Parts** list marks what a part cannot reload. Each model stays in game memory until the player disconnects. When the session passes the memory warning, reconnect to free it. Hot reload was tested with one connected player. With more, Rageon warns that the preview may diverge. Emergency vehicles have no hot reload. Export the project and restart or `ensure` the resource. ## Limits and plans Hot reload has no limit of its own. It depends on the servers your plan lets you link. Servers over the limit stay in the list but do not show up as options. Details are on the [pricing page](https://rageon.dev/pricing). ## Troubleshooting > **No FiveM server linked.** > > Click **Link server…**, which opens **Settings** › **Bridge**. > **The server does not respond at …. The app checks again every 2 s.** > > The server is stopped or not on this computer. Start it. Rageon checks again by itself while the popover is open. > **rageon-bridge is not started on this server.** > > Click **Install in Settings › Bridge**, add `ensure rageon-bridge` to `server.cfg`, and restart the server. > **This server's rageon-bridge is …; hot reload requires ….** > > Click **Update in Settings › Bridge**, then restart the server. > **The server is still running the old engine. Restart the server.** > > Restart the server after installing or updating the bridge. > **The collision layers did not load. Run refresh in the server console or restart it.** > > Type `refresh` in the server console, or restart the server. > **This project's resource … is live. Remove it from server.cfg and restart the server.** > > The exported copy of this project is running on the server and blocks the preview. Remove its `ensure` line and restart. > **The server is still showing the preview from an earlier session.** > > Click **Clear**. > **The last reload failed. …** > > Read the reason after the sentence, then click **Reload now**. > **The server did not finish the reload within 20 seconds.** > > Click **Reload now**. > **The build did not finish within 60 seconds.** > > Click **Reload now**. > **The structure has too many objects for one reload (… objects).** > > Split the structure into smaller ones. > **A player could not load the preview.** > > Have the player reconnect. > **All 32 collision layers of this session have been used. Restart the server to free them.** > > Restart the server. Other errors name the problem in the message. Click **Reload now** after fixing it. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.