PcoWSkbVqDnWTu_dm2ix
Collapse Sidebar

IsLoaded

This function returns true if the client has finished loading the game for the first time.

When all initial Instance|Instances in the game has finished replicating to the client, this function will return true.

Unless they are parented to ReplicatedFirst, LocalScript|LocalScripts will not run while the game has not loaded. The following snippet, ran from a LocalScript in ReplicatedFirst will yield until the game has loaded:

if not game:IsLoaded() then
    game.Loaded:Wait()
end

See also

  • DataModel/Loaded, an event that fires when the game has loaded
  • Instance/WaitForChild, a function which can be used to wait for an individual Instance to replicate without having to wait for the whole game to

Returns

Return Type Summary

Whether the client has finished loading the game for the first time


Code Samples


Custom Loading Screen

This sample is a simple demonstration of how a custom loading screen can be implemented. To run this code it should be placed in a LocalScript and parented to ReplicatedFirst.

In this example, a basic loading screen will be created and shown until the game has loaded (for a minimum time of 3 seconds). Developers may wish to expand on this with more elegant GUI elements. When doing so ensure that all such elements are parented to ReplicatedFirst and fetched using Instance/WaitForChild to ensure they replicate correctly.