From 63d0ac6facc72ae8a52e2c6b46ff9b389b426a33 Mon Sep 17 00:00:00 2001 From: carsakiller Date: Sat, 21 Sep 2024 10:14:15 -0400 Subject: [PATCH] add: ability to reject auth with reason onPlayerAuth can be rejected with a reason string --- docs/en/scripting/server-reference.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/en/scripting/server-reference.md b/docs/en/scripting/server-reference.md index a183c80a..5d840e95 100644 --- a/docs/en/scripting/server-reference.md +++ b/docs/en/scripting/server-reference.md @@ -909,7 +909,14 @@ Triggered when the server shuts down. Currently happens after all players were k Arguments: `player_name: string`, `player_role: string`, `is_guest: bool`, `identifiers: table -> beammp, ip` Cancellable: YES -First event that gets triggered when a player wants to join. +First event that gets triggered when a player wants to join. A player can be denied from joining by returning `1` or a reason (`string`) from the handler function. + +```lua +function myPlayerAuthorizer(name, role, is_guest, identifiers) + return "Sorry, you cannot join at this time." +end +MP.RegisterEvent("onPlayerAuth", "myPlayerAuthorizer") +``` ##### `onPlayerConnecting`