💻 Server

Server represents all Server controls in the Server side.

🗿Static ClassServer Only🧑‍💻API Source

---

🎒 Examples

Server/Index.lua

-- prints "Server started" when the server is starting
Server.Subscribe("Start", function()
    Console.Log("Server started")
end)

-- prints "Server stopped" when the server stops / shutdown
Server.Subscribe("Stop", function()
    Console.Log("Server stopped")
end)

-- prints the delta time about every 33 ms
Server.Subscribe("Tick", function(delta_time)
    Console.Log("Tick: " .. delta_time)
end)

🗿 Static Functions

	Returns	Name	Description
		AddMapSpawnPoint	Adds a spawn point to the current map's spawn points list
		BanByAccountID	Ban the player from the server by its Account ID, ideal for banning from inside PlayerConnect event
		ChangeMap	Restarts the server in a new Map, restarts all packages and reconnects all players
	table of Base Actor	GetActorsInRadius	Returns the actors within the specified radius
	table of string	GetAllValuesKeys	Gets a list of all values keys
	integer	GetCompressionLevel	Returns the server Compression Level being used
	integer	GetConnectionCount	Returns the number of connected players (including players in the process of connecting)
	table of table	GetCustomSettings	Returns the Server Custom Settings passed as parameter or New Game screen
	integer	GetDefaultEntityDimension	Returns the default entity dimension
	integer	GetDefaultPlayerDimension	Returns the default player dimension
	string	GetDescription	Returns the Server Description
	Base Entity or nil	GetEntityByID	Returns the entity with the specified ID
	string	GetIP	Returns the server Public IP
	integer	GetLogLevel	Returns the current log level
	string	GetMap	Returns the current Map Package name
	string	GetMapAsset	Returns the current Map Asset reference
	table	GetMapConfig	Returns a list of the Custom Config of the current map (defined in the map package's Package.toml)
	table of table	GetMapSpawnPoints	Returns a list of the Spawn Points of the current map (defined in the map package's Package.toml)
	integer	GetMaxPlayers	Returns the Max Players configured
	string	GetName	Returns the Server Name
	table of table	GetPackages	Returns a list of Packages running, optionally returns all Packages installed in the server
	table of Player	GetPlayersInRadius	Returns the players within the specified radius
	integer	GetPort	Returns the server Port
	integer	GetQueryPort	Returns the server QueryPort
	integer	GetTickRate	Returns the Configured Tick Rate
	integer	GetTime	Gets the Unix Epoch Time in milliseconds
	any	GetValue	Gets a value given a key
	string	GetVersion	Returns the server version
	boolean	IsAnnounced	Returns if the Server is announced in the Master List
	boolean	IsPackageLoaded	Returns if a Package is currently loaded
	boolean	IsUnsafeLibsEnabled	Returns if the server was started with --enable_unsafe_libs
		KickByAccountID	Kicks the player from the server by its Account ID, ideal for kicking from inside PlayerConnect event
	boolean	LoadPackage	Loads a Package
	boolean	ReloadPackage	Reloads a Package on the next server tick
		Restart	Restarts the server, reloading all Packages and reconnecting all Players
		SetDefaultEntityDimension	Sets the default server dimension that entities will spawn in
		SetDefaultPlayerDimension	Sets the default server dimension that players will spawn in
		SetDescription	Sets the description of the server, optionally overrides Config.toml
		SetLogo	Sets the logo of the server, optionally overrides Config.toml
		SetMaxPlayers	Sets the maximum player slots of the server, optionally overrides Config.toml
		SetName	Sets the name of the server, optionally overrides Config.toml
		SetPassword	Sets the password of the server, optionally overrides Config.toml
		SetValue	Sets a global value in the Server, which can be accessed from anywhere (server side)
		Stop	Stops the server
	function	Subscribe	Subscribes for an Event
		Unban	Unbans a Player by its account ID
	boolean	UnloadPackage	Unloads a Package
		Unsubscribe	Unsubscribes from all subscribed Events in this Class and in this Package, optionally passing the function to unsubscribe only that callback

---

Optimal

AddMapSpawnPoint

Adds a spawn point to the current map's spawn points list

Server.AddMapSpawnPoint(location, rotation?)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	Spawn location
Rotator	rotation?	Rotator()	Spawn rotation

See also GetMapSpawnPoints.

---

Moderate

BanByAccountID

Ban the player from the server by its Account ID, ideal for banning from inside PlayerConnect event

Server.BanByAccountID(player_account_id, reason)

Parameters

Type	Parameter	Default	Description
string	player_account_id	Required parameter	The Player's nanos world account ID
string	reason	Required parameter	The reason shown to the Player

---

Slow

ChangeMap

Restarts the server in a new Map, restarts all packages and reconnects all players

Server.ChangeMap(map_path)

Parameters

Type	Parameter	Default	Description
string	map_path	Required parameter	The new map to load

---

Moderate

GetActorsInRadius

Returns the actors within the specified radius

local ret = Server.GetActorsInRadius(location, radius, only_classes?, dimension?)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	The center location of the search
number	radius	Required parameter	The search radius
table of string	only_classes?	[]	Only actors of these classes will be returned (pass empty for all classes)
integer	dimension?	0	The dimension to search in (pass 0 for all dimensions)

Returns

Type	Description
table of Base Actor	The actors found in radius

---

Moderate

GetAllValuesKeys

Gets a list of all values keys

local ret = Server.GetAllValuesKeys()

Returns

Type	Description
table of string	a list with all values keys

See also GetValue, SetValue.

---

Optimal

GetCompressionLevel

Returns the server Compression Level being used

local ret = Server.GetCompressionLevel()

Returns

Type	Description
integer	the server Compression Level

---

Optimal

GetConnectionCount

Returns the number of connected players (including players in the process of connecting)

local ret = Server.GetConnectionCount()

Returns

Type	Description
integer	Number of connected players

---

Slow

GetCustomSettings

Returns the Server Custom Settings passed as parameter or New Game screen

local ret = Server.GetCustomSettings()

Returns

Type	Description
table of table	a list of the Custom Settings with this format

---

Optimal

GetDefaultEntityDimension

Returns the default entity dimension

local ret = Server.GetDefaultEntityDimension()

Returns

Type	Description
integer	Default entity dimension

See also SetDefaultEntityDimension.

---

Optimal

GetDefaultPlayerDimension

Returns the default player dimension

local ret = Server.GetDefaultPlayerDimension()

Returns

Type	Description
integer	Default player dimension

See also SetDefaultPlayerDimension.

---

Optimal

GetDescription

Returns the Server Description

local ret = Server.GetDescription()

Returns

Type	Description
string	the Server Description

See also SetDescription.

---

Moderate

GetEntityByID

Returns the entity with the specified ID

local ret = Server.GetEntityByID(entity_id)

Parameters

Type	Parameter	Default	Description
integer	entity_id	Required parameter	The entity ID

Returns

Type	Description
Base Entity or nil	the entity

---

Optimal

GetIP

Returns the server Public IP

local ret = Server.GetIP()

Returns

Type	Description
string	the server Public IP

---

Optimal

GetLogLevel

Returns the current log level

local ret = Server.GetLogLevel()

Returns

Type	Description
integer	the log level

---

Optimal

GetMap

Returns the current Map Package name

local ret = Server.GetMap()

Returns

Type	Description
string	the current map package

---

Optimal

GetMapAsset

Returns the current Map Asset reference

local ret = Server.GetMapAsset()

Returns

Type	Description
string	the current map asset

---

Slow

GetMapConfig

Returns a list of the Custom Config of the current map (defined in the map package's Package.toml)

local ret = Server.GetMapConfig()

Returns

Type	Description
table	a list of the Custom Config of the current map

---

Moderate

GetMapSpawnPoints

Returns a list of the Spawn Points of the current map (defined in the map package's Package.toml)

local ret = Server.GetMapSpawnPoints()

Returns

Type	Description
table of table	a list of the Spawn Points of the current map with this format

See also AddMapSpawnPoint.

---

Optimal

GetMaxPlayers

Returns the Max Players configured

local ret = Server.GetMaxPlayers()

Returns

Type	Description
integer	the max players configured

See also SetMaxPlayers.

---

Optimal

GetName

Returns the Server Name

local ret = Server.GetName()

Returns

Type	Description
string	The Server Name

See also SetName.

---

Slow

GetPackages

Returns a list of Packages running, optionally returns all Packages installed in the server

local ret = Server.GetPackages(only_loaded?, package_type_filter?)

Parameters

Type	Parameter	Default	Description
boolean	only_loaded?	true	Set to true the function return only loaded and running packages. Caution: setting to false will retrieve Packages list from disk, which is a slow operation!
PackageType	package_type_filter?	PackageType.All	Which Package type to return. Leave it default to return all types.

Returns

Type	Description
table of table	a list of Packages data with this format

---

Moderate

GetPlayersInRadius

Returns the players within the specified radius

local ret = Server.GetPlayersInRadius(location, radius, dimension?)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	The center location of the search
number	radius	Required parameter	The search radius
integer	dimension?	0	The dimension to search in

Returns

Type	Description
table of Player	The players found in radius

---

Optimal

GetPort

Returns the server Port

local ret = Server.GetPort()

Returns

Type	Description
integer	the server Port

---

Optimal

GetQueryPort

Returns the server QueryPort

local ret = Server.GetQueryPort()

Returns

Type	Description
integer	the server QueryPort

---

Optimal

GetTickRate

Returns the Configured Tick Rate

local ret = Server.GetTickRate()

Returns

Type	Description
integer	the server Tick Rate

---

Optimal

GetTime

Gets the Unix Epoch Time in milliseconds

local ret = Server.GetTime()

Returns

Type	Description
integer	the unix timestamp

---

Moderate

GetValue

Gets a value given a key

local ret = Server.GetValue(key, fallback)

Parameters

Type	Parameter	Default	Description
string	key	Required parameter	Key
any	fallback	Required parameter	Fallback Value if key doesn't exist

Returns

Type	Description
any	Value at key or fallback if key doesn't exist

See also GetAllValuesKeys, SetValue.

---

Optimal

GetVersion

Returns the server version

local ret = Server.GetVersion()

Returns

Type	Description
string	the server version

---

Optimal

IsAnnounced

Returns if the Server is announced in the Master List

local ret = Server.IsAnnounced()

Returns

Type	Description
boolean	if the Server is announced in the Master List

---

Optimal

IsPackageLoaded

Returns if a Package is currently loaded

local ret = Server.IsPackageLoaded(package_name)

Parameters

Type	Parameter	Default	Description
string	package_name	Required parameter	The package folder name

Returns

Type	Description
boolean	If the package is loaded

---

Optimal

IsUnsafeLibsEnabled

Returns if the server was started with --enable_unsafe_libs

local ret = Server.IsUnsafeLibsEnabled()

Returns

Type	Description
boolean	Whether the server was started with --enable_unsafe_libs

---

Moderate

KickByAccountID

Kicks the player from the server by its Account ID, ideal for kicking from inside PlayerConnect event

Server.KickByAccountID(player_account_id, reason)

Parameters

Type	Parameter	Default	Description
string	player_account_id	Required parameter	The Player's nanos world account ID
string	reason	Required parameter	The reason shown to the Player

---

Slow

LoadPackage

Loads a Package

local ret = Server.LoadPackage(package_folder_name)

Parameters

Type	Parameter	Default	Description
string	package_folder_name	Required parameter	The package to load

Returns

Type	Description
boolean	if the Package was loaded

See also ReloadPackage, UnloadPackage.

---

Slow

ReloadPackage

Reloads a Package
Note: the package is effectively reloaded in the next server tick

local ret = Server.ReloadPackage(package_folder_name)

Parameters

Type	Parameter	Default	Description
string	package_folder_name	Required parameter	The package to reload

Returns

Type	Description
boolean	if the Package was found

See also LoadPackage, UnloadPackage.

---

Slow

Restart

Restarts the server, reloading all Packages and reconnecting all Players

Server.Restart()

---

Optimal

SetDefaultEntityDimension

Sets the default server dimension that entities will spawn in. You can change it before spawning an entity and restore it afterwards to just spawn a specific entity directly on it

Server.SetDefaultEntityDimension(default_dimension)

Parameters

Type	Parameter	Default	Description
integer	default_dimension	Required parameter	The new default server dimension that entities will spawn in

See also GetDefaultEntityDimension.

---

Optimal

SetDefaultPlayerDimension

Sets the default server dimension that players will spawn in

Server.SetDefaultPlayerDimension(default_dimension)

Parameters

Type	Parameter	Default	Description
integer	default_dimension	Required parameter	The new default server dimension that players will spawn in

See also GetDefaultPlayerDimension.

---

Optimal

SetDescription

Sets the description of the server, optionally overrides Config.toml

Server.SetDescription(description, persist_to_config_file?)

Parameters

Type	Parameter	Default	Description
string	description	Required parameter	The new description
boolean	persist_to_config_file?	false	Persist to config file

See also GetDescription.

---

Optimal

SetLogo

Sets the logo of the server, optionally overrides Config.toml

Server.SetLogo(logo_url, persist_to_config_file?)

Parameters

Type	Parameter	Default	Description
string	logo_url	Required parameter	The new logo
boolean	persist_to_config_file?	false	Persist to config file

---

Optimal

SetMaxPlayers

Sets the maximum player slots of the server, optionally overrides Config.toml

Server.SetMaxPlayers(max_players, persist_to_config_file?)

Parameters

Type	Parameter	Default	Description
integer	max_players	Required parameter	The maximum players
boolean	persist_to_config_file?	false	Persist to config file

See also GetMaxPlayers.

---

Optimal

SetName

Sets the name of the server, optionally overrides Config.toml

Server.SetName(name, persist_to_config_file?)

Parameters

Type	Parameter	Default	Description
string	name	Required parameter	The new name
boolean	persist_to_config_file?	false	Persist to config file

See also GetName.

---

Optimal

SetPassword

Sets the password of the server, optionally overrides Config.toml

Server.SetPassword(password, persist_to_config_file?)

Parameters

Type	Parameter	Default	Description
string	password	Required parameter	The new password
boolean	persist_to_config_file?	false	Persist to config file

---

Moderate

SetValue

Sets a global value in the Server, which can be accessed from anywhere (server side)

Server.SetValue(key, value, sync_on_client?)

Parameters

Type	Parameter	Default	Description
string	key	Required parameter	Key
any	value	Required parameter	Value
boolean	sync_on_client?	false	If enabled will sync this value through all clients, accessible through Client.GetValue() static class

See also GetAllValuesKeys, GetValue, ValueChange.

---

Slow

Stop

Stops the server

Server.Stop()

---

Optimal

Subscribe

Subscribes for an Event

local ret = Server.Subscribe(event_name, callback)

Parameters

Type	Parameter	Default	Description
string	event_name	Required parameter	The name of the Event
function	callback	Required parameter	Callback function

Returns

Type	Description
function	the function callback itself

---

Moderate

Unban

Unbans a Player by its account ID

Server.Unban(account_id)

Parameters

Type	Parameter	Default	Description
string	account_id	Required parameter	nanos account ID

---

Slow

UnloadPackage

Unloads a Package
Note: the package is effectively unloaded in the next server tick

local ret = Server.UnloadPackage(package_folder_name)

Parameters

Type	Parameter	Default	Description
string	package_folder_name	Required parameter	The package you want unload

Returns

Type	Description
boolean	if the Package was found

See also LoadPackage, ReloadPackage.

---

Optimal

Unsubscribe

Unsubscribes from all subscribed Events in this Class and in this Package, optionally passing the function to unsubscribe only that callback

Server.Unsubscribe(event_name, callback?)

Parameters

Type	Parameter	Default	Description
string	event_name	Required parameter	The name of the Events
function	callback?	nil	Callback function

🚀 Events

	Name	Description
	ChangeMap	Called when the map changes
	PlayerConnect	Called when a player is attempting to connect to the server
	PlayerDisconnect	Called when a player is disconnecting from the server
	Restart	Triggered when the server is restarting
	Start	Triggered once when the server has started and all packages are loaded
	Stop	Triggered when the server is stopping
	Tick	Triggered every 33ms by default
	ValueChange	Triggered when a Value is changed with Server.SetValue()

---

ChangeMap

Called when the map changes. This is always called just before Restart event

Server.Subscribe("ChangeMap", function(old_map, new_map)
	-- ChangeMap was called
end)

Arguments

Type	Argument	Description
string	old_map	The previous map
string	new_map	The new map

---

PlayerConnect

Called when a player is attempting to connect to the server, before the Player entity is created.

To refuse the connection, call Server.KickByAccountID() or Server.BanByAccountID() with the player_account_id (returning false is deprecated).

Server.Subscribe("PlayerConnect", function(ip, player_account_id, player_name, player_steam_id)
	-- PlayerConnect was called
end)

Arguments

Type	Argument	Description
string	ip	IP of the player
string	player_account_id	Account ID of the player
string	player_name	Player name
string	player_steam_id	SteamID of the player

See also KickByAccountID, BanByAccountID, PlayerDisconnect.

---

PlayerDisconnect

Called when a player is disconnecting from the server

Server.Subscribe("PlayerDisconnect", function(ip, player_account_id, player_name, player_steam_id, disconnect_reason)
	-- PlayerDisconnect was called
end)

Arguments

Type	Argument	Description
string	ip	IP of the player
string	player_account_id	Account ID of the player
string	player_name	Player name
string	player_steam_id	SteamID of the player
string	disconnect_reason	Reason for disconnection

See also PlayerConnect.

---

Restart

Triggered when the server is restarting

Server.Subscribe("Restart", function()
	-- Restart was called
end)

---

Start

Triggered once when the server has started and all packages are loaded

Server.Subscribe("Start", function()
	-- Start was called
end)

---

Stop

Triggered when the server is stopping

Server.Subscribe("Stop", function()
	-- Stop was called
end)

---

Tick

Triggered every 33ms by default

Caution: Only small operations should be performed here, otherwise this can lead to server lag and delays

Server.Subscribe("Tick", function(delta_time)
	-- Tick was called
end)

Arguments

Type	Argument	Description
float	delta_time	Seconds since the last tick

---

ValueChange

Triggered when a Value is changed with Server.SetValue()

Server.Subscribe("ValueChange", function(key, value)
	-- ValueChange was called
end)

Arguments

Type	Argument	Description
string	key	The key that changed
any	value	The new value

See also SetValue.