Client-server handlers

SanVerse uses server.emitClientEvent(player, eventName, payload) for a targeted server-to-client event. It is the explicit-target equivalent of a TriggerClientEvent style API: the target player is always supplied, which prevents an accidental broadcast.

Parameters

Value	Type	Description
player	Player | number	Authenticated target player or active player ID.
eventName	string	Namespaced event name, for example hud.welcome.
payload	string | undefined	Optional bounded serialized payload.

Example

server.on("playerJoin", (player) => {
  server.emitClientEvent(
    player,
    "hud.welcome",
    JSON.stringify({ playerId: player.id }),
  );
});

Notes

• Client code can listen for the event, but this method does not grant client authority.
• Client-to-server actions must use a named, validated request contract.
• Never trust client-provided health, position, inventory or entity ownership.

Related

• Event handlers
• Players
• Scripting model