Garry's Mod Wiki


vararg include( string fileName )


Executes a Lua script.

Addon files (.gma files) do not support relative parent folders (.. notation).
The file you are attempting to include MUST NOT be empty or the include will fail. Files over a certain size may fail as well.
If the file you are including is clientside or shared, it must be AddCSLuaFile'd or this function will error saying the file doesn't exist.
This function will try to load local client file if sv_allowcslua is 1.
pcalling this function will break autorefresh.

Issue Tracker: 1976


1 string fileName
The name of the script to be executed. The path must be either relative to the current file, or be an absolute path (relative to and excluding the lua/ folder).

Please make sure your file names are unique, the filesystem is shared across all addons, so a file named lua/config.lua in your addon may be overwritten by the same file in another addon.


1 vararg
Anything that the executed Lua script returns.


Demonstrates correct and incorrect usage.

-- Correct usage: -- Will look for "lua/myLuaFolder/myLuaFile.lua" in all addons and then the base game **lua/** folder. include( "myLuaFolder/myLuaFile.lua" ) -- This is incorrect, and will NOT work. include( "lua/myLuaFolder/myLuaFile.lua" ) include( "addons/lua/myLuaFolder/myLuaFile.lua" ) include( "addons/MyAddon/lua/myLuaFolder/myLuaFile.lua" ) include( "MyAddon/lua/myLuaFolder/myLuaFile.lua" )

Page Links

Special Pages



Render Time: 188ms

DB GetPage 50
Generate Html 5
SaveChanges (1) 112
Render Body 0
Render Sidebar 18