Garry's Mod Wiki

Home / util.PrecacheModel

util.PrecacheModel

  util.PrecacheModel( string modelName )
Search Github

Description

Precaches a model for later use. Model is cached after being loaded once.

Modelprecache is limited to 8192 unique models. When it reaches the limit the game will crash.
Does nothing on the client.

Arguments

1 string modelName
The model to precache.

Example

If you have to deal with many models at a time, you'd better reduce the calls to that function. Too many calls will cause the game to run out of memory; e.g., too much precaching is a pre-crash. Use deep validation when you are about to spawn the model, and file validation on the client for drawing stuff. It is slow, so it's better to hash that as well.

-- Uses a custom model check to remove the pre-caching overhead local libModel = {} libModel.Skip = {} -- General disabled models for spawning libModel.Skip[""] = true -- Empty string libModel.Skip["models/error.mdl"] = true libModel.File = {} -- When the file is available libModel.Deep = {} -- When the model is spawned function IsModel(sModel, bDeep) if(not isstring(sModel)) then return false end if(libModel.Skip[sModel]) then return false end local vDeep = libModel.Deep[sModel] -- Read model validation status if(SERVER and bDeep and vDeep ~= nil) then return vDeep end -- Will spawn local vFile = libModel.File[sModel] -- File current status if(vFile ~= nil) then -- File validation status is present if(not vFile) then -- File is validated as invalid path print("Invalid file "..sModel); return vFile end else -- File validation status update. Status is missing. Calculate. vFile = false; libModel.File[sModel] = vFile -- Assume being invalid if(IsUselessModel(sModel)) then --Check model being Aqua from Konosuba print("File useless "..sModel); return vFile end if(not file.Exists(sModel, "GAME")) then -- Check model being a unicorn print("File missing "..sModel); return vFile end vFile = true; libModel.File[sModel] = vFile -- The file validated print("File >> "..table.concat({tostring(vDeep), tostring(vFile), sModel}, "|")) end -- At this point the file path is valid. Have to validate the model if(CLIENT or not bDeep) then return vFile end -- File is validated util.PrecacheModel(sModel); vDeep = util.IsValidModel(sModel) libModel.Deep[sModel] = vDeep -- Store deep validation print("Deep >> "..table.concat({tostring(vDeep), tostring(vFile), sModel}, "|")) return vDeep -- Gonna spawn on the server. Must validate. end

Account Management

Special Pages

Wiki List