3.4 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"
Since the control script may not belong to any of the packs, it does not belongs to its own package and has its own global namespace in which all global functions and tables are available, as well as the app library.
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,
-- maximum number of engine loop ticks after which
-- a "max ticks exceed" exception will be thrown
[optional] max_ticks = 1e9,
-- maximum wait time in seconds.
-- (works with system time, including test mode)
[optional] timeout = 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.is_content_loaded() -> bool
Checks if content is loaded.
app.new_world(
-- world name, empty string will create a nameless world
name: str,
-- generation seed
seed: str,
-- generator name
generator: str
-- local player id
[optional] local_player: int=0
)
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.
app.focus()
Brings the window to front and sets input focus.