Skip to main content
Version: bleeding-edge ๐Ÿฉธ

๐Ÿ๏ธ Level

Work with Unreal level in runtime.

๐Ÿ—ฟStatic ClassClient Only๐Ÿง‘โ€๐Ÿ’ปAPI Source

๐Ÿ—ฟย Static Functionsโ€‹

ReturnsNameDescription
varargs of anyCallLevelBlueprintEventCalls a Level Blueprint custom event (which can be added when creating levels through Unreal Engine)
table of tableGetStreamLevelsGets a list of all Stream Levels
LoadStreamLevelLoads a Level in runtime
SetStreamLevelVisibilitySets a Stream Level visibility
functionSubscribeSubscribes to an Event
UnloadStreamLevelUnloads a Level in runtime
UnsubscribeUnsubscribes from all subscribed Events in this Class and in this Package, optionally passing the function to unsubscribe only that callback

Slow

CallLevelBlueprintEventโ€‹

Calls a Level Blueprint custom event (which can be added when creating levels through Unreal Engine)
local ret_01, ret_02, ... = Level.CallLevelBlueprintEvent(event_name, arguments...?)

Parameters

TypeParameterDefaultDescription
stringevent_name Required parameter Event or Function name
anyarguments...?nil
Sequence of arguments to pass to the event

Returns

TypeDescription
varargs of anythe function return values

Moderate

GetStreamLevelsโ€‹

Gets a list of all Stream Levels
local ret = Level.GetStreamLevels()

Returns

TypeDescription
table of tablewith this format

Slow

LoadStreamLevelโ€‹

Loads a Level in runtime
Level.LoadStreamLevel(level_name, should_block_on_load?, make_visible_after_load?)

Parameters

TypeParameterDefaultDescription
stringlevel_name Required parameter No description provided
booleanshould_block_on_load?false
If this should be a blocking operation - the game will freeze
booleanmake_visible_after_load?true
If this should be visible automatically after loaded

Moderate

SetStreamLevelVisibilityโ€‹

Sets a Stream Level visibility
Level.SetStreamLevelVisibility(level_name, visibility)

Parameters

TypeParameterDefaultDescription
stringlevel_name Required parameter No description provided
booleanvisibility Required parameter If this level should be visible

Optimal

Subscribeโ€‹

Subscribes to an Event
local ret = Level.Subscribe(event_name, callback)

Parameters

TypeParameterDefaultDescription
stringevent_name Required parameter Event to subscribe to
functioncallback Required parameter Callback to run on the event occurring

Returns

TypeDescription
functionThe function callback

Moderate

UnloadStreamLevelโ€‹

Unloads a Level in runtime
Level.UnloadStreamLevel(level_name, should_block_on_unload?)

Parameters

TypeParameterDefaultDescription
stringlevel_name Required parameter No description provided
booleanshould_block_on_unload?false
If this should be a blocking operation - the game will freeze

Optimal

Unsubscribeโ€‹

Unsubscribes from all subscribed Events in this Class and in this Package, optionally passing the function to unsubscribe only that callback
Level.Unsubscribe(event_name, callback?)

Parameters

TypeParameterDefaultDescription
stringevent_name Required parameter Event to unsubscribe to
functioncallback?nil
Optional callback to specifically unsubscribe to

๐Ÿš€ย Eventsโ€‹

NameDescription
StreamLevelBeginPauseCalled when streaming pause begins
StreamLevelEndPauseCalled when streaming pause ends
StreamLevelHideCalled when a Stream Level is hidden
StreamLevelLoadCalled when a Stream Level is loaded
StreamLevelShowCalled when a Stream Level is shown
StreamLevelUnloadCalled when a Stream Level is unloaded

StreamLevelBeginPauseโ€‹

Called when streaming pause begins
Level.Subscribe("StreamLevelBeginPause", function()
-- StreamLevelBeginPause was called
end)

StreamLevelEndPauseโ€‹

Called when streaming pause ends
Level.Subscribe("StreamLevelEndPause", function()
-- StreamLevelEndPause was called
end)

StreamLevelHideโ€‹

Called when a Stream Level is hidden
Level.Subscribe("StreamLevelHide", function(level_name)
-- StreamLevelHide was called
end)

Arguments

TypeArgumentDescription
stringlevel_nameNo description provided

StreamLevelLoadโ€‹

Called when a Stream Level is loaded
Level.Subscribe("StreamLevelLoad", function(level_name)
-- StreamLevelLoad was called
end)

Arguments

TypeArgumentDescription
stringlevel_nameNo description provided

StreamLevelShowโ€‹

Called when a Stream Level is shown
Level.Subscribe("StreamLevelShow", function(level_name)
-- StreamLevelShow was called
end)

Arguments

TypeArgumentDescription
stringlevel_nameNo description provided

StreamLevelUnloadโ€‹

Called when a Stream Level is unloaded
Level.Subscribe("StreamLevelUnload", function(level_name)
-- StreamLevelUnload was called
end)

Arguments

TypeArgumentDescription
stringlevel_nameNo description provided