This site has been archived and made available for preservation purposes. No edits can be made.

OnClientAuthenticate

(Difference between revisions)
Return to current revision
  1.  
    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][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]
    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).
  2. -
    [h="2"] Usage example (C++) [/h]
  3. +
    [h="2"] Usage examples[/h]
  4.  
    [highlight=cpp]
    State VAULTSCRIPT OnClientAuthenticate(cRawString name, cRawString pwd)
    {
    return True; // Everybody is allowed to connect
  5. +
    }
    [/highlight]
    [highlight=c]
    public OnClientAuthenticate(const name {}, const pwd {})
    {
    return true; // Everybody is allowed to connect
  6.  
    }
    [/highlight]
    [category]VaultMP interface[/category]
    [category]Scripting callbacks[/category]