2.8 KiB
app library
A library for high-level engine control, available only in script or test mode.
The script/test name without the path and extension is available as app.script. The file path can be obtained as:
local filename = "script:"..app.script..".lua"
Functions
app.tick()
Performs one tick of the main engine loop.
app.sleep(time: number)
Waits for the specified time in seconds, performing the main engine loop.
app.sleep_until(
-- function that checks the condition for ending the wait
predicate: function() -> bool,
-- the maximum number of engine loop ticks after which
-- a "max ticks exceed" exception will be thrown
[optional] max_ticks = 1e9
)
Waits for the condition checked by the function to be true, performing the main engine loop.
app.quit()
Terminates the engine, printing the call stack to trace the function call location.
app.reconfig_packs(
-- packs to add
add_packs: table,
-- packs to remove
remove_packs: table
)
Updates the packs configuration, checking its correctness (dependencies and availability of packs). Automatically adds dependencies.
To remove all packs from the configuration, you can use pack.get_installed():
app.reconfig_packs({}, pack.get_installed())
In this case, base will also be removed from the configuration.
app.config_packs(
-- expected set of packs (excluding dependencies)
packs: table
)
Updates the packs configuration, automatically removing unspecified ones, adding those missing in the previous configuration. Uses app.reconfig_packs.
app.new_world(
-- world name
name: str,
-- generation seed
seed: str,
-- generator name
generator: str
)
Creates a new world and opens it.
app.open_world(name: str)
Opens a world by name.
app.reopen_world()
Reopens the world.
app.save_world()
Saves the world.
app.close_world(
-- save the world before closing
[optional] save_world: bool=false
)
Closes the world.
app.delete_world(name: str)
Deletes a world by name.
app.get_version() -> int, int
Returns the major and minor versions of the engine.
app.get_setting(name: str) -> value
Returns the value of a setting. Throws an exception if the setting does not exist.
app.set_setting(name: str, value: value)
Sets the value of a setting. Throws an exception if the setting does not exist.
app.get_setting_info(name: str) -> {
-- default value
def: value,
-- minimum value
[only for numeric settings] min: number,
-- maximum value
[only for numeric settings] max: number
}
Returns a table with information about a setting. Throws an exception if the setting does not exist.