Entendendo scripts da Pasta Data

Nessa Serie de Tutoriais vou explicar e faze-los entender a base dos scripts em lua e xml.
Desde você que não sabe nada de scripts e você que está num estagio médio
A idéia aqui é você aprender e saber o que e não pode fazer, já que a criatividade é sua parte

Esses tutoriais serão divididos em 11 partes, começando a explicar o if, else até os esquemas mais avançados.
A vantagem daqui é que você poderá testar seus scripts no otserver e sabendo o que deve fazer fica mais fácil do que fazer coisas a esmo...

Lembrando que você não ficará expert em LUA e sim em scripts de Otserver.

A divisão será em : (com links)

Parte I – Básico do básico de Lua
Parte II – Funções Lua
Parte III - Monstros
Parte IV - Raids
Parte V - Spells e suas grandes funções
Parte VI – Actions
Parte VII – Talk Actions e Movements
Parte VIII – A magia dos NPCS
Parte IX – Mega Quests
Parte X – Itens e grandes idéias
Parte XI – Weapons, Vocations e outfits

Todos esses tutoriais foram baseados em The Forgotten Server 0.3.0 Alpha 3 (Ou superior) use ele que é o melhor.

Parte I – Básico do básico de Lua
Começaremos por LUA porque é uma linguagem simples, que não precisa declarar variáveis e tudo mais. Aqui não explicarei as funções do otserver e sim como montar um script.
Nessa primeira parte usarei o Português Estruturado que sinceramente não é útil
quando você aprende a sintaxe da linguagem, porém é ótimo para você que está começando aprender o que está fazendo e não só copiando e colando.

LEMBRANDO QUE PORTUGUÊS ESTRUTURADO NÃO É UMA LINGUAGEM
É APENAS UM JEITO DE VOCÊ ENTENDER A SINTAXE DAS LINGUAGENS.

Começando vamos explicar a sintaxe de um script bem básico mesmo. Aquele script que quando você da use em 100 gps ele vira 1 platinum coin



Em português estruturado ele ficaria assim :


Com português estruturado da para entender essa action

Agora da para explicar melhor a estrutura de um arquivo lua de actions :

► Essa parte é a que diz ao servidor que essa função vai se ativar quando o player usar o item indicado no actions.xml. No caso é a função aoUsar ou seja quando o player clicar com o direito nesse item irá acontecer algo.

► O SE é uma condição, se estiver tudo certo dentro dele ele faz a condição contida no caso
o id (numerodoitem) tem que ser 2148 (Gold Coin) e tem que ser do tipo 100 (No caso de itens juntáveis o tipo é a quantidade), faça remova ele e adicione UM item 2152 (platinum coin).

► Senão ou seja, se o item não for 2148 ou não ter tipo 100, não retorne ao começo do script e finalize.


Espero que essa parte tenha esclarecido um pouquinho mais sobre actions. Agora vou explicar um pouco mais sobre algumas condições e suas sintaxes.

Sintaxe do IF, Else e Elseif.

A condição if de longe é a mais importante de todas as programações e é essencial para um script um pouco mais complexo ou para evitar que você faça 200 scripts para certas funções (comida do tibia por exemplo).

Vocabulário do tio Ta4e


Única coisa que o lua pede é que cada item tenha um end para cada if colocado tenha um end, você também tem que entender a questão do if encadeado que será tema da próxima aula aqui.
Mais para ela se tem que saber o básico de um If normal.
Esse é o script anterior com adição de uma condição que se o player tiver 100 platinum coin ele se transforme em uma crustal coin.


Você percebe que eu alinhei o if e elseif a seu end, isso chama-se Estruturação, isso é muito importante já que para achar um erro será muito mais fácil E fica mais organizado seu script

Você percebe que o IF tem um end no final da sua cadeia, pois todo IF tem que ter um end
porém o ELSEIF se enquadra dentro do IF.
O ELSEIF ajuda pois você diminui linhas de scripts e serve para outras funções mais avançadas que serão vistas nas próximas aulas.
Lembrando também que a função toda função também tem seu END, isso ajuda no caso de você querer colocar duas funções no mesmo script (muito usado em movements).

IF Encadeado
O if encadeado ou cadeia de if, indica funções pouco mais complexas que o if solitário, porém não é nenhum bicho de 7 cabeças, se você fazer a estruturação do script.
Aqui vai o script de exemplo, é um script muito mais complexo do que os do gps



Esse script é o que eu uso para minhas quest. Esse é um ótimo exemplo de if encadeado.
Perceba que ele está estruturado. Claro que colorido é muito simples identificar cada else e end
Agora vou explicar a sintaxe.

►A primeira parte pede que o uniqueid (é um numero especial usado apenas uma vez no mapa inteiro), seja 2300.

►Essa parte do queststatus é uma variável que será explicado a parte

►Esse If, checa se o player tem o valor da variável listada acima, senão ele manda a mensagem o “the chest is empty”.


►Esse outro if checa se o player tem a capacidade 29.50, senão ele manda a mensagem “You have found a demon helmet. Weighing 29.50 oz it is too heavy”.

►Chama-se cadeia de if porque as funções em preto só serão executados se todos os IFS forem verdadeiros, se apenas um não for ele já acusa o erro. Seria mais ou menos como tirar um RG



Perceba que você terá que ter tudo isso para fazer o RG senão tiver você não consegue tirar

►Voltando ao script perceba que todos tem seu respectivo end, isso é importantíssimo

Variáveis
Variáveis é uma parte da memoria na qual se guarda um valor ou informação, em outras linguagens elas tem tipos como de números inteiros, reais ou de letras, porém em lua não existe isso.
O que facilita muito nossas vidas as variáveis são maneiras ou jeitos de você fazer scripts para outras pessoas ou por pura preguiça mesmo...
São extremamente necessárias em scripts grandes na qual um item de mesmo id é repetido muitas vezes, e talvez depois seja necessário muda-lo
Lembra do script anterior da quest a parte que da questatus



A quest status é uma variável, que pergunta ao servidor se o player tem o valor nele
Se não tiver faça, ou seja -1 é igual a negativo ou negação, no caso se o programador quisesse que ele tivesse colocava 1
Essa parte é bem simples de se entender, já que variáveis servem para simplificar a vida de não programadores, porém deixam seu servidor mais pesado, não é coisa grande, porém como já disse a variável ocupa memoria, em torno de 3kb cada uma, mais em um otserver básico possuem muitas variáveis
Elas podem ser indicadas em qualquer parte do script, e elas sempre recebem dados ou perguntam.
Pode se fazer cálculos nas variáveis ou usar outras variáveis dentro dela sem problema nenhum.


Sinais Matemáticos e de comparação
Aqui vai uma coisa que confunde muita gente :

►= - Faz o item anterior receber algo
Exemplo : gold = 2148

►== - Verificação. É para checar
Exemplo : if item.itemid == 2555 then

► Os sinais matemáticos são +, -, / e * .

►E como toda linguagem não existe , entre números 1,5 é 1.5 virgula é só para separar variáveis

►Para se checar pode ser usar == (igual a ), >= (maior ou igual a ), <= (menor ou igual a ) o sinal de diferente é agora com certeza é ~=.

►Pode se calcular os itens dentro de variáveis ou até dentro de funções.



IF com varias condições
Você já deve entender um pouco mais de scripts portanto agora colocarei scripts cortados
Vamos a um exemplo :



Nesse caso o item.itemid é aqueles itens que você pode dar use with (vara de pescar por exemplo) e o item2.itemid é o local a ser clicado.
Então seria Se o item for 2694 e o segundo item for 1381 ou 1382 ou 1383 ou 1384 faça.
Ou seja qualquer um desses itens é considerado válido.
Essa é a básica desse tipo porém pode-se fazer umas mais complexas como essa debaixo que não existe em actions e é só para explicar :


Nesse caso o player teria que usar o item 1381 e o 1382 juntos ou o 1383 e 1384 juntos.
É usado em movements, npcs e talk actions muito frequentemente.
Parece fácil mais da para se confundir facinho ai.


Quando usar IF e quando usar ELSEIF
Essa parte é a final desse primeiro tutorial e serve apenas para dar uma idéia de como melhor seu script básico
Como eu já disse o Elseif é uma é a junção de else + if e ele só vai executado depois se o if primário for falso. Ou seja ele é usado quando apenas uma das condicionais vai ser verdadeira , eu uso muito isso em npcs para o quests de npcs, mais podemos mostrar uns exemplos em actions.
Já o if sempre será checado, bom para os ifs encadeados já que eles tem todos estarem certos ou errados.

Exemplo de If e Elseif junto



►Perceba que nesse caso é usado o elseif porque é impossível que o mesmo bau tenha o mesmo uniqueid (Como disse anteriormente cada uniqueid é usado apenas 1 vez no mapa e um item só tem 1 uniqueid). Então ou é um ou é outro. E ELSEIF não tem end.

►Nesse caso todos tem que ser reais para poder se executar o script, então é necessários ser if e ter seus ENDS.


Comentários
Para inserir comentários na linguagem lua é necessário adicionar – 2 hifens.
Pode ser em qualquer parte do script (pelo amor de deus não coloque dentro de um if)
normalmente usado para explicar o script ou colocar créditos


Siglas e Dicionario

id – Identificador ou seja no caso de otserver é o numero do item para o tibia.
cid – Creature Id :Identificador da criatura, no caso a criatura que executa a ação, no caso o player.
uid – Unique Id : Identificador único usado uma vez no mapa (em algumas funções ele serve como para indicar um id.
actionid – Identificador de ação pode ser usado varias vezes no mapa, usado principalmente para aquele chão que afunda perto do DP.


Esperto que tenha gostado desse tutorial. E você que leu tenha aproveitado, e espere que os próximos vem ai, qualquer duvida, reclamação ou sugestão coloque aqui.
Ele fico melhor no word porém aqui ficou meio estranho

comentem flws

Um bom tutorial pra que nao sabe ta aprendendo...gostei da traduçao facilita as pessoas

Aprovado por mim!

Continue assim!

Tutorial grande e de boa formatação, um exemplo.

Tutorial aprovado.

Achei otimo que gostaram

To fazendo a segunda parte

E logo colocarei aqui

Tenho muitas ideias porém pouco tempo

Mais acho que agora serão 10 tutos

Um excelente tutorial !
Tirei várias dúvidas lendo este tutorial e estou aguardando os outros, principalmente sobre 'Mega Quests' e 'Itens e grandes idéias' :)
Obrigado Tibiaa4e!
Abraço

Obrigado por compartilhar conosco seus conhecimentos.
Espero ansioso pelos próximos tutos!

Grande abraço!