onPlayerConnect

SerwerGraczeIdentyczne z MTA:SA

Gracz łączy się z serwerem, zanim powstanie jego element. Możesz odrzucić połączenie, np. za nick albo bana.

Obsługa

addEventHandler("onPlayerConnect", root, function(playerNick, playerIP, playerUsername, playerSerial, playerVersionNumber, playerVersionString) ... end)

Parametry

playerNickstring: Nick.
playerIPstring: Adres IP.
playerUsernamestring: Nazwa konta launchera.
playerSerialstring: Numer seryjny gracza.
playerVersionNumberint: Numer wersji klienta.
playerVersionStringstring: Wersja klienta jako tekst.

Źródło

source to root.

cancelEvent(true, "powód") odrzuca połączenie; gracz widzi powód.

Przykład

Zakaz nicków z ukośnikiem.

addEventHandler("onPlayerConnect", root, function(nick)
    if nick:find("/", 1, true) then
        cancelEvent(true, "Nick nie może mieć ukośnika.")
    end
end)

Zobacz też

onPlayerJoinGracz wszedł na serwer. Dobre miejsce na powitanie, logowanie i pierwsze odrodzenie.
getCancelReasonZwraca powód podany w cancelEvent(true, powod) przez ostatnie anulowanie zdarzenia, np. powód odrzucenia połączenia w onPlayerConnect.
cancelEventAnuluje bieżące zdarzenie z wnętrza jego obsługi. Dla zdarzeń, które na to pozwalają, blokuje domyślne działanie, np. onPlayerChat (wiadomość nie pojawi się na czacie), onPickupHit (pickup nie zostanie zebrany), onVehicleStartEnter (gracz nie wsiądzie). Pozostałe obsługi nadal się wywołują i mogą sprawdzić stan przez wasEventCancelled. Na serwerze można podać powód, który odczyta getCancelReason.