Warp/docs/api/1.1/server.md

# Server <Badge type="tip" text="1.1" />

For Server-sided operations.

## Getting the Server Object

```lua
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.
but this is optional and conditional, you may have to use this if you had a problem with identifier namespace on client.

::: code-group
```luau [Variable]
(
	namespaces: { string },
) -> Connection
```

```luau [Example]
Server.reg_namespaces({
	"ServerNotify",
	"ServerMessage",
	"WelcomeMessage",
	"Broadcast",
	"DataReplication",
	"RequestData",
	"Update"
})
```
:::

## `.Connect`

Connect to an event to receive incoming data from clients.

::: code-group
```luau [Variable]
(
	remoteName: string,
	fn: (player: Player, ...any) -> ...any
) -> Connection
```

```luau [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.

::: code-group
```luau [Variable]
(
	remoteName: string,
	fn: (player: Player, ...any) -> ...any
) -> Connection
```

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

## `.Wait` <Badge type="warning" text="yield" />

Wait for an event to be triggered.

::: code-group
```luau [Variable]
(
	remoteName: string
) -> (number, ...any)
```

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

## `.DisconnectAll`

Disconnect all connections for a specific event.

::: code-group
```luau [Variable]
(
	remoteName: string
)
```

```luau [Example]
Server.DisconnectAll("ServerNotify")
```
:::

## `.Destroy`

Disconnect all connections and remove the event.

::: code-group
```luau [Variable]
(
	remoteName: string
)
```

```luau [Example]
Server.Destroy("ServerNotify")
```
:::

## `.Fire`

Fire an event to a specific player.

::: code-group
```luau [Variable]
(
	remoteName: string,
	reliable: boolean,
	player: Player,
	...: any
)
```

```luau [Example]
Server.Fire("ServerNotify", true, player, "Hello from server!")
```
:::

## `.Fires`

Fire an event to all connected players.

::: code-group
```luau [Variable]
(
	remoteName: string,
	reliable: boolean,
	...: any
)
```

```luau [Example]
Server.Fires("Broadcast", true, "Server announcement!")
```
:::

## `.FireExcept`

Fire an event to all players except specified ones.

::: code-group
```luau [Variable]
(
	remoteName: string,
	reliable: boolean,
	except: { Player },
	...: any
)
```

```luau [Example]
local excludedPlayers = { player1, player2 }
Server.FireExcept("Update", true, excludedPlayers, "Game update")
```
:::

## `.Invoke` <Badge type="warning" text="yield" />

Invoke a client with timeout support.

::: code-group
```luau [Variable]
(
	remoteName: string,
	player: Player,
	timeout: number?,
	...: any
) -> ...any
```

```luau [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.

::: code-group
```luau [Variable]
(
	remoteName: string,
	schema: Buffer.SchemaType
)
```

```luau [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.