Skip to main content
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

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.
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

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

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

​
Advanced settings

Click Advanced settings… in the popover.
Hot reload settings with Server, Reload, Collision, Parts, and Session sections

Hot reload settings.

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.

​
Troubleshooting

Click Link server…, which opens Settings › Bridge.
The server is stopped or not on this computer. Start it. Rageon checks again by itself while the popover is open.
Click Install in Settings › Bridge, add ensure rageon-bridge to server.cfg, and restart the server.
Click Update in Settings › Bridge, then restart the server.
Restart the server after installing or updating the bridge.
Type refresh in the server console, or restart the server.
The exported copy of this project is running on the server and blocks the preview. Remove its ensure line and restart.
Click Clear.
Read the reason after the sentence, then click Reload now.
Click Reload now.
Click Reload now.
Split the structure into smaller ones.
Have the player reconnect.
Restart the server.
Other errors name the problem in the message. Click Reload now after fixing it.