Server 1.1

For Server-sided operations.

Getting the Server Object

local Server = Warp.Server()

.reg_namespaces

Register namespaces to ensure all of the namespaces is being registered earlier on the server to prevent any unexpected issues on the client.

INFO

this is optional and conditional, you may have to use this if you had a problem with identifier namespace on client.

Variable

(
	namespaces: { string },
)

Example

Server.reg_namespaces({
	"ServerNotify",
	"ServerMessage",
	"WelcomeMessage",
	"Broadcast",
	"DataReplication",
	"RequestData",
	"Update"
})

.Connect

Connect to an event to receive incoming data from clients.

Variable

(
	remoteName: string,
	fn: (player: Player, ...any) -> ...any
) -> Connection

Example

local connection = Server.Connect("ServerNotify", function(player, message)
	print(`Client message from {player}: {message}`)
end)
print(connection.Connected)

.Once

Similar to :Connect but automatically disconnects after the first firing.

Variable

(
	remoteName: string,
	fn: (player: Player, ...any) -> ...any
) -> Connection

Example

Server.Once("WelcomeMessage", function(welcomeText)
	print(`Welcome: {welcomeText}`)
end)

.Wait yield

Wait for an event to be triggered.

Variable

(
	remoteName: string
) -> (number, ...any)

Example

local elapsed, message = Server.Wait("ServerMessage")
print(`Received message after {elapsed} seconds: {message}`)

.DisconnectAll

Disconnect all connections for a specific event.

Variable

(
	remoteName: string
)

Example

Server.DisconnectAll("ServerNotify")

.Destroy

Disconnect all connections and remove the event.

Variable

(
	remoteName: string
)

Example

Server.Destroy("ServerNotify")

.Fire

Fire an event to a specific player.

Variable

(
	remoteName: string,
	reliable: boolean,
	player: Player,
	...: any
)

Example

Server.Fire("ServerNotify", true, player, "Hello from server!")

.Fires

Fire an event to all connected players.

Variable

(
	remoteName: string,
	reliable: boolean,
	...: any
)

Example

Server.Fires("Broadcast", true, "Server announcement!")

.FireExcept

Fire an event to all players except specified ones.

Variable

(
	remoteName: string,
	reliable: boolean,
	except: { Player },
	...: any
)

Example

local excludedPlayers = { player1, player2 }
Server.FireExcept("Update", true, excludedPlayers, "Game update")

.Invoke yield

Invoke a client with timeout support.

Variable

(
	remoteName: string,
	player: Player,
	timeout: number?,
	...: any
) -> ...any

Example

local response = Server.Invoke("RequestData", player, 3, "userInfo")
if response then
	print("Client responded:", response)
else
	print("Request timed out")
end

WARNING

This function is yielded. Returns nil if timeout occurs.

.useSchema

Define a schema for strict data packing on a specific event.

Variable

(
	remoteName: string,
	schema: Buffer.SchemaType
)

Example

local Server = Warp.Server()

local dataSchema = Server.Schema.struct({
	Coins = Server.Schema.u32,
	Level = Server.Schema.u8,
	Inventory = Server.Schema.array(Server.Schema.u32),
	Settings = Server.Schema.struct({
		VFX = Server.Schema.boolean,
		Volume = Server.Schema.f32,
		Language = Server.Schema.string,
	})
})

Server.useSchema("DataReplication", dataSchema)

.Schema

Access to Buffer.Schema for creating data schemas.