Garry's Mod Wiki


  resource.AddFile( string path )


Adds the specified and all related files to the files the client should download.

For convenience, this function will automatically add any other files that are related to the selected one, and throw an error if it can't find them. For example, a .vmt file will automatically add the .vtf with the same name, and a .mdl file will automatically add all .vvd, .ani, .dx80.vtx, .dx90.vtx, .sw.vtx, .phy, .png and .jpg files with the same name, with a separate error for each missing file.

If you do not want it to do this, use resource.AddSingleFile.

There's a 8192 downloadable file limit. If you need more, consider using Workshop addons - resource.AddWorkshop. You should also consider the fact that you have way too many downloads. This limit is shared among all resource.Add* functions.
The file must exist on the server it will not be added to the downloadables list!


1 string path
Virtual path of the file to be added, relative to garrysmod/.
Do not add .bz2 to the filepath.
Do not put gamemodes/*gamemodename*/content/ or addons/*addonname*/ into the path.


Example of usage.

resource.AddFile( "materials/my/material.vmt" ) -- Automatically adds materials/my/material.vtf resource.AddFile( "models/my/model.mdl" ) -- Automatically adds models/my/model.vtx and the rest resource.AddFile( "sound/my/sound.wav" ) -- Be careful, there's no S in the sound.