#if defined mention_included
    #endinput
#endif
#define mention_included

/// <summary>
/// Número máximo de citaçõs em um texto.
/// </summary>
#define MAX_MENTION                (3)

/// <summary>
/// Texto/Caractere que irá aparecer na citação de um jogador bloqueado.
/// </summary>
#define BLOCKED_MENTION_TEXT       "*"

/// <summary>
/// Variável interna responsável por gerenciar os bloqueios de citações.
/// </summary>
static bool:blockedPlayer[MAX_PLAYERS][MAX_PLAYERS];

/// <summary>
/// Chamado quando um jogador cita outro(s).
/// </summary>
/// <param name="playerid">ID do jogador que realizou a citação.</param>
/// <param name="citedid">ID do jogador citado.</param>
/// <param name="blocked">True caso o jogador (citedid) esteja bloqueado e False caso contrário.</param>
/// <returns>1</returns>
forward OnPlayerMentionPlayer(playerid, citedid, bool:blocked);

/// <summary>
/// Pega citações em um texto no formato '@000'
/// </summary>
/// <param name="out_str">String passada por referência.</param>
/// <param name="str">String contendo citações.</param>
/// <returns>1</returns>
stock GetMention(str[], out_str[], playerid = INVALID_PLAYER_ID)
{
    new str2[500],
        name[MAX_MENTION][MAX_PLAYER_NAME + 10],
        strId[MAX_MENTION][3],
        idx1 = -1,
        idx2 = -1,
        count = 0;

    strcat(str2, str, sizeof str2);

    while(count < MAX_MENTION)
    {
        idx1 = strfind(str2, "@", true, idx1+1);
        idx2 = strfind(str2, " ", true, idx1);

        if(idx1 > -1)
        {
            strmid(strId[count], str2, idx1+1, idx2, MAX_PLAYER_NAME + 10);
            IsNumber(strId[count]);
            if(IsNumber(strId[count]))
            {
                new id = strval(strId[count]);

                if(playerid != INVALID_PLAYER_ID)
                {
                     OnPlayerMentionPlayer(playerid, id, blockedPlayer[id][playerid]);
                }

                if(IsPlayerConnected(id))
                {
                    strdel(str2, idx1, idx2);
                    GetPlayerName(id, name[count], MAX_PLAYER_NAME);
                    format(name[count], MAX_PLAYER_NAME + 10, "@%s", (blockedPlayer[id][playerid] ? (BLOCKED_MENTION_TEXT) : (name[count])));
                    strins(str2, name[count], idx1, sizeof str2);
                }
            }
        }
        else
            break;
                    
        count ++;
    }

    strcat(out_str, str2, sizeof str2);
    return 1;
}

/// <summary>
/// Verifica se um jogador bloqueou outro.
/// </summary>
/// <param name="playerid">ID do jogador que irá bloquear.</param>
/// <param name="targetid">ID do jogador que será bloqueado.</param>
/// <param name="toggle">True para bloquear um jogador e False para desbloquear</param>
/// <returns>1</returns>
stock PlayerBlockPlayerMention(playerid, targetid, bool:toggle)
{
    blockedPlayer[playerid][targetid] = toggle;
    return 1;
}

/// <summary>
/// Verifica se um jogador bloqueou outro.
/// </summary>
/// <param name="playerid">ID do jogador que bloqueou.</param>
/// <param name="targetid">ID do jogador que foi bloqueado.</param>
/// <returns>True caso o playerid esteja bloqueado para o targetid e False caso contrário.</returns>
stock IsPlayerBlockedMentionForPlayer(playerid, targetid)
    return blockedPlayer[playerid][targetid];

/// <summary>
/// Função interna que verifica se a string contém somente números.
/// </summary>
/// <param name="str">String que será verificada.</param>
/// <returns>True caso contenha somente números ou False caso contenha caracteres não-inteiros.</returns>
static IsNumber(str[])
{
    for(new i = 0; i < strlen(str); i ++)
    {
        if(i > 0)
        {
            switch(str[i])
            {
                case '0'..'9': continue;
                default: return 0;
            }
        }
    }
    return 1;
}