With Lua Refresh (called "Auto Refresh" in Garry's Mod) your server automatically reloads changed Lua files as soon as they are saved on the server. This lets you see changes to your addons right away without restarting the server. On our servers Lua Refresh is disabled by default.
Enable Lua Refresh
-
Open the dashboard
Open the dashboard of your server. -
Open the settings
Navigate to the Settings. -
Turn on Lua Refresh
Enable the Lua Refresh setting. -
Restart the server
Save the setting and restart your server.
If you now edit a Lua file via SFTP and save it, the server reloads it automatically.
Disable Lua Refresh for live operation
We recommend turning on Lua Refresh only while you are working on your addons. According to the Garry's Mod Wiki, Auto Refresh can lag the server when editing certain Lua files triggers a cascade of further reloads. If you upload files while players are on the server, this can cause lag for them.
-
Open the dashboard
Open the dashboard of your server. -
Open the settings
Navigate to the Settings. -
Turn off Lua Refresh
Disable the Lua Refresh setting. -
Restart the server
Save the setting and restart your server.
Limitations of Lua Refresh
Not every change is picked up automatically. Auto Refresh only works for files that the game or the gamemode includes automatically:
- files in
autorun - effects, entities and weapons
- the gamemode's
init.luaandcl_init.luaand the files included from them
The following changes are not reloaded automatically:
- files included dynamically via
includeorAddCSLuaFile– depending on the case, they are not reloaded at all or only partly - changes to the base file of a weapon or entity: weapons and entities that build on it only pick up the change once they are reloaded themselves
- on Linux servers, a system limit for file watching can be reached when there are very many files. Individual files are then not reloaded automatically
In these cases, restart your server so the changes are loaded.