PAWN - SAMP

PAWN

Índice
Introdução
Use o search
FAQ
Perguntas Frequentes
Primeiros passos
Examinando o código
Variaveis
Strings
Floats
Ints
Bools
Funções
Chamando
Definindo
Parâmetros
Exemplos de Funções
Source Code
Tipos de script
Créditos
Introdução
Bem, eu estive a pensar em criar um grande tutorial sobre pawn, já tenho algum conhecimento e penso que seja capaz de fazer um tutorial destes, tenho o objetivo de facilitar os membros a aprenderem pawn e tentar reduzir as duvidas que muitos tem, lembrando que isto é um tutorial muito complexo.
Use o search
Muita gente vem ao forum sa-mp e cria uma conta, espera que ela seja ativada e começa a criar pedidos de ajudas sem verificar as regras e/ou sem procurar no forum usando o search, muitas vezes o que nós escrevemos é absurdo, ou seja, é algo que a probabilidade que exista é nula, por exemplo:

"O meu sistema de gasolina não funciona" (ERRADO)
"sistema de gasolina" (CERTO)
Por vezes podemos não achar o que queremos em português, então se colocarmos em inglês podemos ter algum resultado, veja "fuel system" , nem sempre o forum facilita a nossa ajuda, então também é aconselhável usar o Google.
Na minha opinião é mais interessante procurar do que for criar um tópico, porque ao procurar você ganha conhecimento e experiência.
FAQ
Perguntas Frequentes
Pergunta: O que é o PAWN?
Resposta: PAWN é uma linguagem de programação não-oficial, criada em 1998 pela ITB CompuPhase, pawn é derivado da linguagem de programação chamada Small-C e que tem uma sintaxe parecida a C.
Pergunta: O que é o PAWNO?
Resposta: Pawno é o IDE(Integrated development environment) oficial da linguagem de programação pawn, ou seja, pawno é o editor da linguagem de programação.
Pergunta: O que é o PAWNCC?
Resposta: O pawncc é o compilador, ele serve para compilar os nossos códigos, após serem compilados será criado um arquivo .amx .
Pergunta: PAWN é uma linguagem de programação oficial?
Resposta: Não, pawn é uma linguagem de programação não-oficial, ele é usado em jogos, como o SA-MP, Counter-Strike 1.6 AmxMod, Half-Life mod.
Pergunta: PAWN é dificil de programar?
Resposta: Não, eu acho pawn uma linguagem muito simples de programar, após você aprender pawn, torna-se simples aprender as outras linguagens de programação.
Pergunta: O que é um GF?
Resposta: GF, vem do prefixo GodFather, o GF foi um Gamemode muito famoso, é atualmente utilizado pela maioria dos servidores de RPG no Brasil e em Portugal.
Pergunta:Vale a pena editar um gamemode?
Resposta:Na minha opinião não, porque muitos desses gamemodes vem bugados, mal feitos, sem optimização, não utilizam coisas corretas, etc... Mas existem gamemodes que são bem feitos e bem estruturados, esses sim vale a pena editar.
Pergunta:Vale a pena criar um gamemode?
Resposta: Sim, lembre-se que tudo criado por si é bom, claro que nem sempre podemos usar coisas criadas por nós, porque cada linguagem de programação tem coisas nativas que foram criadas por outras pessoas, mas sobre criar um gamemode, vale sempre mais a pena criar o seu gamemode, você conta com muitas coisas, optimização, sem bugs, estruturado, coisas exclusivas, entre outras...
Pergunta: Porque devo deixar os créditos de um script que eu não fiz?
Resposta: Bem, como disse nem todos os scripts são feitos por nós certo, então convém deixar os devidos créditos do autor, os créditos não precisam de ser um comando, deixar no script já é muito útil, então pense sempre, gostava que alguém roubasse algo seu e disse-se que foi ele que fez?
Clique aqui para ver mais Perguntas Frequentes
Primeiros passos
Bem, os primeiros passos são fáceis, mas muita gente pergunta "Como eu começo a programar pawn?", simples, se você quer mesmo programar pawn basta ter dedicação e você aprende.
Pawn não é um quebra cabeças, muito pelo contrario, no inicio pode ser complicado, mas se nos dedicarmos ele torna-se fácil.

Então para começar você deve fazer o download do sa-mp server:
SA-MP 0.3e Windows Server: Download
SA-MP 0.3e Linux Server (x86): Download

1º Após fazer o download, extraia os arquivos para uma pasta.
2º Apos extrair os arquivos, abra o pawno e clique em new.
3º Agora vamos começar por criar um pequeno script, começe por eliminar tudo menos:
#include
public OnFilterScriptInit
public OnFilterScriptExit
public OnPlayerConnect
4º Apos isso, compile (pressionando F5) e de um nome ao seu arquivo.
Após você ter compilado o arquivo, poderemos começar a programar e a criar pequenas coisas, lembre-se que o source code deve se parecer com este.
Source code (*.pwn):
pawn Code:

Examinando o código
Agora vamos passar a fase de examinar o código, quando examinamos o código temos a noção do que estamos a fazer, por vezes é util usamos comentarios, ou seja (//comentário) , assim isto facilita-nos quando temos de ler o nosso código, se implementarmos a lógica nos comentários ate podemos resolver alguns bugs caso eles existem.
Variaveis
As variáveis são coisas muito importantes no nosso script, para alem de serem dinâmicas, elas guardam dados temporários, ou seja, enquanto tivermos o server ligado e as variáveis não modificadas, sem valores alterados, os dados vão ser iguais.
Strings
Uma string, é uma Array1D, que permite-nos armazenar caracteres, para quem não sabe, array's1D são aquelas arrays que contem apenas um [], ou seja, new arr[20]; , isto é uma array 1D, pelo que eu sei, o máximo que existe é ate 4D's, ou seja, new arr[20][20][20][20]; , então, digamos que a string é uma array 1D, lembrando que tambem é possivel criar uma string com apenas um caracter, mas eu chamo isso de, cell, ou seja, new arr = '1'; , mas para ser considerada uma string é necessário ser no mínimo 1D, menos que isso, será considerada uma cell, ou seja, célula e lembrando que as cells só permitem apenas 1 carácter.
Floats
Uma float, é uma variavel decimal, ela contem um ponto (.) entre os dois numeros, para declararmos uma float, necessitamos de fazer, new Float:tempposx; , penso que o tamanho máximo da Float é entre 6000 e -6000, isto é o tamanho do mapa do GTA.
Ints
Uma int, é uma variavel base, os dados que armazenamos na int pode ser números, ou Hexadecimal, para criarmos uma int, basta escrever new arr = 1;
Bools
Uma bool, é uma variável que tem apenas 2 condições, verdadeira ou falsa, para declararmos uma variavel booleana, basta escrever, new bool: arr = false;
Funções
As funções podem ser funções nativas, como SendClientMessage , ou podem ser funções criadas por nós, as funções podem ser criadas de 5 formas, forward & public, stock, #define, native ou digitando apenas o nome da função.
Chamando
Para chamarmos uma função podemos usar 3 formas, via timer, via Remote/Local Function ou via normal, para chamarmos via timer, usamos o SetTimer ou SetTimerEx.
pawn Code:
SetTimer(callback[],tempo,bool:repetir)
callback[] Neste parâmetro iremos definir o nome da função que queremos chamar.
tempo Neste parametro iremos definir o tempo necessário para a função ser chamada, lembrando que o tempo é definido em ms, ou seja, milissegundos, clique aqui para ver um conversor de tempo
repetir Neste parâmetro iremos definir se queremos chamar a função apenas 1 vez, ou se queremos chamar a função para sempre, lembrando que aqui teremos que usar apenas a condição verdadeiro ou falso, ou seja (1, true || 0, false)
Nota: Esta função funciona apenas para publics.
pawn Code:
SetTimerEx(callback[],tempo,repetir,format[],{Float,_}:...);
callback[] Neste parâmetro iremos definir o nome da função que queremos chamar.
tempo Neste parametro iremos definir o tempo necessário para a função ser chamada, lembrando que o tempo é definido em ms, ou seja, milissegundos, clique aqui para ver um conversor de tempo
repetir Neste parâmetro iremos definir se queremos chamar a função apenas 1 vez, ou se queremos chamar a função para sempre, lembrando que aqui teremos que usar apenas a condição verdadeiro ou falso, ou seja (1, true || 0, false)
format[] Aqui iremos definir o parametro que queremos usar, ou seja:
i & d - Representa um parâmetro inteiro, ou seja, uma int
s - Representa um parâmetro string, ou seja, uma string
f - Representa um parâmetro float, ou seja, uma float.
b - Representa um parâmetro bool, ou seja, uma booleana.
{Float,_}:... Número indefinido de argumentos para passar
Nota: Esta função funciona apenas para publics.
Tambem podemos usar o CallRemoteFunction para chamar funções de um filterscript, mas lembrando que essas funções tem de ser publics, para chamar funções normais, basta colocar o nome dela no script, exemplo.
pawn Code:

Código:

SayHello();,kr

Definindo
Como disse a pouco, existem 5 formas para definir uma função, então vamos rever.
public & forward Criarmos uma função com public & forward é mais vantajoso, alem de poder ser chamada com CallRemote(Local)Function & SetTimer(Ex), também é rápida.
stock Criarmos uma função com stock, são funções simples, como dar dinheiro do jogador e nível ao mesmo tempo, entre outras, veja um exemplo stock HelloWorld();
#define Podemos criar uma pequena função com o #define, porém na minha opinião e pelo que me disseram, usar #define não vale muito a pena, porque o #define ao ser executado ele vai ser criado varias vezes tornando o tamanho do amx maior.
native Isto é muito curiso, porque quando se cria uma include, podemos colocar /* native HelloWorld(); */ e ele vai mostrar a função na lista lateral direita, onde tem todas as includes, mas a native é usada para plugins, digamos que ela faz a conexão entre o script e o plugin.
Nome da função Em vez de criarmos uma stock, podemos colocar logo o nome da função, veja HelloWorld();
Parâmetros
Os parâmetros de uma função são variáveis que nos permitem transferir dados, ou seja, em vez de usarmos variáveis globais, podemos usar variaveis locais e transferir os dados para essa mesma função, vejamos:

Como podemos ver aqui, usamos 2 integers, mas o primeiro tem um &, esse & serve para passar valores por referencia, ou seja, quando fazemos

Isto foi apenas uma das coisas que podemos fazer, claro que podemos fazer outras coisa.
Tipos de script
Existem muitos tipos de script, desde um código útil ate um gamemode, então vejamos quais são os tipos de script.
Código Útil Um código util, é um script muito pequeno, ele pode ser apenas uma função (Clique Aqui)
FilterScript Um filterscript, pelo nome diz, filtro de script, é um script pequeno, que contem algumas funções e sistemas.
GameMode Um GameMode, pelo nome diz modo de jogo, é um script grande, em que os jogadores pode jogar nele, existem vários tipos de GameModes, desde RP,RPG,DM,TDM,DRIFT,STUNT entre outros.
Include Uma include é um script externo, ou seja, ele é um ficheiro gravado em .inc, assim facilita ao programador usar as funções, para usar uma include basta colocar no seu script #include
Plugin Um plugin também é um script externo, mas ele usa a linguagem de programação C++, ou seja, com um plugin poderemos fazer coisas que no pawn não dá, por vezes devida ao seu tamanho o plugin usa uma include, como por exemplo o plugin sscanf.
Créditos
BlueX - Criação do tutorial;
rjjj - Retirada de duvidas;
Stewie` - Retirada de duvidas;
Wiki SA-MP - Retirada de duvidas;
Wikipédia - Informações;
[iPs]TeaM - Creative Logic;
SA-MP TeaM - Passado\Presente\Futuro;
Kyosaur - Fonte de inspiração para o tutorial;

Postado na ssgames por weslley_script