lession3.sp

/*
 * Autor: "SHARIVAN do clã ZM Brasil (ΖмBя.™ Clan)
 *
 * Descrição:
 *   Terceira aula de programação em sourcepawn 1.7.
 *   Nesta lição serão abordados os seguintes assuntos:
 *      - Strings.
 *      - Listas.
 *      - Vetores.
 *
 *   Para maiores informações sobre como programar plugins de sourcemod, recomendo ter as seguintes competências:
 *
 *   - Conhecimento de matemática básica, principalmente geometria euclidiana, geometria analítica e vetores.
 *   - Lógica da programação
 *   - Conhecimento básico e intermediário das linguagens C e C++
 *   - Linguagem Pawn
 *
 *   Segue abaixo alguns links importantes:
 *
 *   Manual do sourcepawn:
 *     Pré 1.7: https://wiki.alliedmods.net/Introduction_to_sourcepawn
 *     Pós 1.7: https://wiki.alliedmods.net/Introduction_to_SourcePawn_1.7
 *
 *   API do sourcemod:
 *     Pré 1.7: https://sm.alliedmods.net/api/
 *     Pós 1.7: https://sm.alliedmods.net/new-api/
 *
 *   Realçador de sintaxe do sourcepawn para Notepad++: https://forums.alliedmods.net/showthread.php?t=120037
 *
 *   Pawn Studio: http://sourceforge.net/projects/pawnstudio/
 *
 */

#pragma semicolon 1

// Includes

#include <sourcemod>
#include <sdktools>
#include <zombiereloaded> // API do Zombie:Reloaded
#include <smlib> // API da SMLib que pode ser obtida em https://forums.alliedmods.net/showthread.php?t=148387

// Defines

#define VERSION "1.0"

// Variáveis globais

char g_sString[16]; // Declaração de uma string com 16 caracteres. Strings em sourcepawn são como arrays, elas devem sempre ser declaradas com um tamanho fixo exceto quando são parâmetros de funções onde seu tamanho pode ser indeterminado.
ArrayList g_hLista; // Uma variável do tipo ArrayList. ArrayList é uma classe (methodmap) que encapsula as operações para manipulação de uma lista.

// Info

public Plugin myinfo = {
    name = "Aula 3",
    author = "SHARIVAN from ΖмBя.™ Clan",
    description = "Terceira aula de sourcepawn",
    version = VERSION,
    url = "http://www.zmbrasil.com.br/"
};

// Forwards

public void OnPluginStart() {
    // Atribuir um valor a uma string
    g_sString = "Olá"; // Válido somente para inicializar a variável.
    g_sString = "Hello"; // Não recomendável caso ela já tenha sido inicializada.
    strcopy(g_sString, sizeof(g_sString), "Olá"); // Esse seria o mais recomendável.
    Format(g_sString, sizeof(g_sString), "%s", "Olá"); // Uma forma alternativa de atribuir valores para strings.

    // Atribuir variável string para string
    char sString2[16] = "Como vai?";
    strcopy(g_sString, sizeof(g_sString), sString2);

    // Concatenar strings
    char sString3[16] = "Tudo bem?";
    StrCat(g_sString, sizeof(g_sString), sString3); // Isso é o mesmo que g_sString = g_sString + sString3 em Java/C#
    Format(g_sString, sizeof(g_sString), "%s%s", g_sString, sString3); // Uma forma alternativa de concatenar strings;

    if (strlen(g_sString) > 10) // Para obter a quantidade de caracteres em uma string use a função strlen.
        LogMessage("O tamanho da string g_sString é maior que 10."); // API do sourcemod que escreve uma mensagem nos logs do sourcemod.

    if (StrEqual(g_sString, "hehehe")) // Para comparar duas strings use a função StrEqual. Ela aceita um terceiro parâmetro opcional booleano que se for verdadeiro (padrão) compara as strings usando case sensitive, ou seja, diferencia maiúsculas de minúsculas. Caso seja falso, ele não leva em conta o case sensitive.
        LogMessage("O tamanho da string g_sString é maior que 10.");

    g_hLista = new ArrayList(); // Criação de uma lista. Caso queira que os elementos tenham mais de uma célula de tamanho, deverá ser especificado o número de células passado como parâmetro neste construtor, caso contrário será assumido como apenas uma célula por elemento.
}

public void OnPluginEnd() {
    delete g_hLista; // Destruição de uma lista (opcional).
}

public void OnClientPutInServer(int client) {
    g_hLista.Push(client); // Adiciona um elemento a uma lista colocando ele no final dela.
}

public void OnClientDisconnect(int client) {
    int indice = g_hLista.FindValue(client); // Procura um elemento em uma lista retornando seu índice caso seja encontrado. Caso não o encontre, é retornado -1.
    if (indice != -1)
        g_hLista.Erase(indice); // Deleta um elemento de uma lista, sempre passando seu índice como parâmetro.
}

// A forward OnPlayerRunCmd é chamada a cada frame do servidor, passando como parâmetros o estados dos botões que o jogador pressionou, do impulse, sua velocidade, angulos e arma a ser usada. Essa forward é invocada antes que o engine processe o comando enviado pelo jogador, desta forma é possível verificar por exemplo se ele pressionou determinada tecla e desativa-la antes mesmo que o engine saiba disso.
public Action OnPlayerRunCmd(int client, int &buttons, int &impulse, float vel[3], float ang[3], int &weapon) {
    if (impulse == 100) // Se ele ligou ou desligou a lanterna (impulse=100) envia uma mensagem pra ele notificando sobre isso.
        PrintToChat(client, "Você acendeu/apagou a lanterna.");

    if (!IsPlayerAlive(other) || !ZR_IsClientZombie(client)) // Se ele não estiver vivo ou se ele não for um zumbi, cai fora.
        return Plugin_Continue;

    float vecOrigem[3]; // Vetores tridimensionais em sourcepawn são dados sempre na forma de um array de 3 posições do tipo float. Segue abaixo o significado de cada posição deste array.
    // vecOrigem[0] = coordenada x
    // vecOrigem[1] = coordenada y
    // vecOrigem[2] = coordenada z
    GetClientAbsOrigin(client, vecOrigem); // Obtem as coordenadas da origem do jogador.

    if ((buttons & IN_ATTACK) != 0) // Se ele pressionou o botão de ataque.
        for (int other = 1; other <= MaxClients; other++) { // Varre todos os demais clientes.
            if (other != client // Se o outro usuário não for eu mesmo
                && Client_IsIngame(other) // Se ele for um cliente válido e estiver em jogo (aqui foi usada uma API da SMLib para este fim).
                && IsPlayerAlive(other) // Se ele estiver vivo.
                && ZR_IsClientHuman(other) // E por fim, se ele for um humano.
                ){ // Então...
                float vecOrigemDoOutro[3];
                GetClientAbsOrigin(other, vecOrigemDoOutro); // Obtém as coordenadas deste usuário.
                if (GetVectorDistance(vecOrigem, vecOrigemDoOutro) <= 200.0) // Calcula a distância entre eu e ele. Se essa distância for menor que 200.
                    ZR_InfectClient(other, client); // Infecta este usuário!
            }
        }

    return Plugin_Continue;
}

// Stocks

// Essa seria uma possível implementação do método FindValue da claase ArrayList para o caso de seus elementos forem somente números inteiros.
// A palavra chave stock indica que a função é uma função de estoque. Não tem efeito nenhum durante a execução do código, é apenas uma forma de dizer pro compilador que essa função está ali e mesmo que não seja usada para ele não emitir uma warning dizendo que ela está ali de enfeite. Muito útil o uso de stocks quando se está escrevendo bibliotecas para sourcepawn, observe que todas as includes que são usadas pelos plugins usam essa palavra chave em todas as suas funções.
stock int ProcuraClientNoArray(int client) {
    // Varre-se todo o array em busca de um elemento que seja igual ao nosso parâmetro client. Para isso nosso índice i deve começar do zero e ser sempre menor que g_hList.Length. Length é uma propriedade da classe ArrayList que retorna o número de elementos contidos na lista.
    for (int i = 0; i < g_hList.Length; i++) {
        int elemento = g_hLista.Get(i); // Para obter um elemento celular de uma lista, use o método Get.
        if (elemento == client)
            return i; // Se o elemento for igual, retorne o seu índice na lista.
    }

    return -1; // Senão retorne -1.
}

// Como a classe ArrayList não provém nenhum método que permite a inserção de um elemento em um índice qualquer, segue abaio uma possível implementação de tal função.
stock void InsereNoArray(int elemento, int indice) {
    if (indice < 0 || indice > g_hList.Length) // Verifica se o índice é válido, ou seja, se está entre zero e o tamanho da lista.
        ThrowError("O índice do array deve ser maior ou igual a zero e menor ou igual ao tamanho dele."); // Senão lança uma exceção. No sourcepawn ainda não é possível lançar exceções de tipos específicos como na maiora das linguagens, nem capturar exceções ou outras construções como por exemplo try finally.

    if (indice == g_hList.Length) // Se o índice for igual ao tamanho da lista, insere o elemento no final da lista.
        g_hLista.Push(elemento);
    else { // Senão...
        ShiftUp(indice); // Desloca os elementos à direita (da menor para a maior posição) a partir do índice desejado para que esse índice fique livre.
        g_hLista.Set(indice, elemento); // Modifica o valor da posição no índice que agora está livre, para o nosso elemento desejado.
    }
}