This site has been archived and made available for preservation purposes. No edits can be made.
OnClientAuthenticate
(Difference between revisions)
Return to current revision
-
Gets called when a client attempts to connect to the server.
[h="2"] Declaration [/h]
[highlight=cpp]
VAULTSCRIPT VAULTSPACE State OnClientAuthenticate(VAULTSPACE cRawString, VAULTSPACE cRawString) _CPP(noexcept);
[/highlight]
[highlight=c]
forward OnClientAuthenticate(const name{}, const pwd{});
[/highlight]
[h="2"] Parameters [/h]
[image]Authenticate.png|right|thumb|This is what gets passed to the callback[/image]
-
-
[b]name[/b] - the name of the client (guaranteed to be at least 3 and at maximum [wiki]MAX_PLAYER_NAME[/wiki] characters long)
[b]pwd[/b] - the password of the client (guaranteed to be at maximum [wiki]MAX_PASSWORD_SIZE[/wiki] characters long)
-
+
[b][wiki]cRawString[/wiki][/b] - the name of the client (guaranteed to be at least 3 and at maximum [wiki]MAX_PLAYER_NAME[/wiki] characters long)
[b][wiki]cRawString[/wiki][/b] - the password of the client (guaranteed to be at maximum [wiki]MAX_PASSWORD_SIZE[/wiki] characters long)
-
[h="2"] Return value [/h]
-
-
When returned [wiki]True[/wiki], the client is allowed to connect and play on this server. When returned [wiki]False[/wiki], the client gets kicked (authentication denied).
-
+
If returned [wiki]True[/wiki], the client is allowed to connect and play on this server. If returned [wiki]False[/wiki], the client gets kicked (authentication denied).
-
[h="2"] Usage example (C++) [/h]
[highlight=cpp]
State VAULTSCRIPT OnClientAuthenticate(cRawString name, cRawString pwd)
{
return True; // Everybody is allowed to connect
}
[/highlight]
[category]VaultMP interface[/category]
[category]Scripting callbacks[/category]