Naev Lua API

• Index

Modules

• ai
• vn
• escort
• fleet
• format
• lazyload
• linenoise
• lmisn
• lmusic
• love_shaders
• asteroid
• audio
• bkg
• camera
• canvas
• colour
• commodity
• data
• diff
• evt
• faction
• file
• font
• gfx
• gui
• hook
• jump
• linopt
• misn
• music
• naev
• news
• outfit
• pilot
• pilotoutfit
• player
• rnd
• safelanes
• shader
• ship
• shiplog
• spfx
• spob
• system
• tex
• time
• tk
• transform
• var
• vec2
• equipopt.optimize
• pilotai
• portrait
• pp_shaders
• prng
• prob
• proximity
• swapship
• vntk

Module naev

Naev generic Lua bindings.

Functions

version ()	Gets the version of Naev and the save game.
versionTest (v1, v2)	Tests two semver version strings.
language ()	Gets the current language locale.
lastplayed ()	Gets how many days it has been since the player last played Naev.
ticksGame ()	Gets the game seconds since the program started running.
ticks ()	Gets the seconds since the program started running.
clock ()	Gets the approximate CPU processing time.
keyGet (keyname)	Gets a human-readable name for the key bound to a function.
keyEnable (keyname[, enable=false])	Disables or enables a specific keybinding.
keyEnableAll ()	Enables all inputs.
keyDisableAll ()	Disables all inputs.
eventStart (evtname)	Starts an event, does not start check conditions.
missionStart (misnname)	Starts a mission, does no check start conditions.
eventReload (evtname)	Reloads an event's script, providing a convenient way to test and hopefully not corrupt the game's state.
missionReload (misnname)	Reloads a mission's script, providing a convenient way to test and hopefully not corrupt the game's state.
shadersReload ()	Reloads all the Naev shaders excluding those created by the shader library.
isSimulation ()	Gets whether or not the universe is being simulated or not.
conf ()	Gets the configuration information.
confSet (name, value)	Sets configuration variables.
cache ()	Gets the global Lua runtime cache.
trigger (hookname, arg)	Triggers manually a hook stack.
claimTest (params[, inclusive=false])	Tests a claim of a system or strings.
plugins ()	Gets the list of available plugins.
menuInfo ([window="main"])	Opens the info menu window.
menuSmall ([info=false[, options=false[, allowsave=false]]])	Opens the small menu window.
pause ()	Checks to see if the game is paused.
pause ()	Pauses the game.
unpause ()	Unpauses the game.
hasTextInput ()	Checks to see if text inputting is enabled.
setTextInput (enable, Text, Text, Text, Text)	Enables or disables text inputting.
envs ()	Gets a table with all the active Naev environments.

Functions

version ()

Gets the version of Naev and the save game.

Returns:

1. string The version of the game.
2. string Version of current loaded save or nil if not loaded.

Usage:

game_version, save_version = naev.version()

versionTest (v1, v2)

Tests two semver version strings.

Parameters:

• v1 string Version 1 to test.
• v2 string Version 2 to test.

Returns:

number Positive if v1 is newer or negative if v2 is newer.

language ()

Gets the current language locale.

Returns:

string Current language locale (such as "en" for English, "de" for German, or "ja" for Japanese).

lastplayed ()

Gets how many days it has been since the player last played Naev.

Returns:

number Number of days since the player last played.

ticksGame ()

Gets the game seconds since the program started running.

These are modified by whatever speed up the player has.

Returns:

number The seconds since the application started running.

ticks ()

Gets the seconds since the program started running.

Useful for doing timing on Lua functions.

Returns:

number The seconds since the application started running.

clock ()

Gets the approximate CPU processing time.

Returns:

number Seconds elapsed since start of the process.

keyGet (keyname)

Gets a human-readable name for the key bound to a function.

Parameters:

• keyname string Name of the keybinding to get value of. Valid values are listed in src/input.c: keybind_info.

Usage:

bindname = naev.keyGet( "accel" )

keyEnable (keyname[, enable=false])

Disables or enables a specific keybinding.

Use with caution, this can make the player get stuck.

Parameters:

• keyname string Name of the key to disable (for example "accel").
• enable boolean Whether to enable or disable. (default false)

Usage:

naev.keyEnable( "accel", false ) -- Disables the acceleration key

keyEnableAll ()

Enables all inputs.

Usage:

naev.keyEnableAll() -- Enables all inputs

keyDisableAll ()

Disables all inputs.

Usage:

naev.keyDisableAll() -- Disables all inputs

eventStart (evtname)

Starts an event, does not start check conditions.

Parameters:

• evtname string Name of the event to start.

Returns:

boolean true on success.

Usage:

naev.eventStart( "Some Event" )

missionStart (misnname)

Starts a mission, does no check start conditions.

Parameters:

• misnname string Name of the mission to start.

Returns:

1. boolean true if mission was either accepted, or started without misn.finish() getting called in create.
2. boolean true whether or not the mission was accepted.

Usage:

naev.missionStart( "Some Mission" )

eventReload (evtname)

Reloads an event's script, providing a convenient way to test and hopefully not corrupt the game's state. Use with caution, and only during development as a way to get quicker feedback.

Parameters:

• evtname string Name of the event to start.

Returns:

boolean true on success.

Usage:

naev.eventReload( "Some Event" )

missionReload (misnname)

Reloads a mission's script, providing a convenient way to test and hopefully not corrupt the game's state. Use with caution, and only during development as a way to get quicker feedback.

Parameters:

• misnname string Name of the mission to start.

Returns:

boolean true on success.

Usage:

naev.missionReload( "Some Mission" )

shadersReload ()

Reloads all the Naev shaders excluding those created by the shader library.

isSimulation ()

Gets whether or not the universe is being simulated or not.

Returns:

boolean true if the world is being simulated.

conf ()

Gets the configuration information.

Returns:

table Table of configuration values as they appear in the configuration file.

confSet (name, value)

Sets configuration variables. Note that not all are supported.

Parameters:

• name string Configuration variable name.
• value number or string Value to set to.

cache ()

Gets the global Lua runtime cache. This is shared among all environments and is cleared when the game is closed.

Returns:

table The Lua global cache.

Usage:

c = naev.cache()

trigger (hookname, arg)

Triggers manually a hook stack. This is run deferred (next frame). Meant mainly to be used with hook.custom, but can work with other hooks too (if you know what you are doing).

Note This will trigger all hooks waiting on a stack.

Parameters:

• hookname string Name of the hook to be run.
• arg Parameter to pass to the hooks.

Usage:

naev.trigger( "my_event", data ) -- data will be passed to the receiving end

claimTest (params[, inclusive=false])

Tests a claim of a system or strings.

Parameters:

• params System, String or {System,String...} Table of systems/strings to claim or a single system/string.
• inclusive boolean Whether or not to allow the claim to include other inclusive claims. Multiple missions/events can inclusively claim the same system, but only one system can exclusively claim it. (default false)

Returns:

boolean true if it is possible to claim, false otherwise.

Usage:

if not naev.claimTest( { system.get("Gamma Polaris") } ) then print("Failed to claim!") end

plugins ()

Gets the list of available plugins.

Returns:

table Table containing the list of plugins.

menuInfo ([window="main"])

Opens the info menu window.

Possible window targets are:
- "main" : Main window.
- "ship" : Ship info window.
- "weapons" : Weapon configuration window.
- "cargo" : Cargo view window.
- "missions" : Mission view window.
- "standings" : Standings view window.

Parameters:

• window string parameter indicating the tab to open at. (default "main")

Usage:

naev.menuInfo( "ship" ) -- Opens ship tab

menuSmall ([info=false[, options=false[, allowsave=false]]])

Opens the small menu window.

Parameters:

• info boolean Show the info button. (default false)
• options boolean Show the options button. (default false)
• allowsave boolean Allow saving the game from the menu (either directly or by exiting the game from the menu). (default false)

Usage:

naev.menuSmall()

pause ()

Checks to see if the game is paused.

Returns:

boolean Whether or not the game is currently paused.

pause ()

Pauses the game.

unpause ()

Unpauses the game.

Can not be run while landed.

hasTextInput ()

Checks to see if text inputting is enabled.

Returns:

boolean Whether or not text inputting is enabled.

setTextInput (enable, Text, Text, Text, Text)

Enables or disables text inputting.

Parameters:

• enable boolean Whether text input events should be enabled.
• Text integer rectangle height.
• Text integer rectangle height.
• Text integer rectangle height.
• Text integer rectangle height.

envs ()

Gets a table with all the active Naev environments.

Only available only debug builds.

Returns:

table Unordered table containing all the environments.