Logs / Error guide / Garry's Mod
Garry's Mod: “Couldn't include file … (File not found)”
What the message means
A Lua file wants to include another file that doesn't exist on the server. The parentheses show which file tried (@addons/…). Everything that would be in the missing file is then missing – more errors often follow.
What it looks like in the log
Mounting addon 'Advanced Doors' (1987654321)
Loading gamemode darkrp
Couldn't include file 'advdoors/sh_config.lua' (File not found) (@addons/advanced_doors/lua/autorun/sh_advdoors.lua (line 14))
Couldn't include file 'advdoors/sv_doors.lua' (File not found) (@addons/advanced_doors/lua/autorun/sh_advdoors.lua (line 18))
Excerpt from an example log, marked the way the analysis marks it.
Common causes
- The addon was uploaded incompletely, a folder is missing.
- Upper and lower case: on Linux servers, Sh_Config.lua and sh_config.lua are two different files.
- The addon was unpacked nested twice (addons/addon/addon/lua/…).
- Part of the addon is expected as a separate addon or via Workshop and is missing.
How to fix it
- In the file manager, check whether the named file really exists under addons/<addon>/lua/ – compare path and spelling exactly.
- The folder structure must be addons/<name>/lua/…, not addons/<name>/<name>/lua/…
- Upload the addon again or unpack it completely once more.
- Restart the server and check whether the follow-up errors are gone too.