1. Sanny Builder

Eu a partir de hoje vou publicar aqui, parte por parte do tutorial de cleo criado por LINK/2012, eh um tutorial completíssimo e super explicado q vc poderá aprender desdo oq eh o CLEO, ate criar coisas avançadas, entao caso vc deseja mesmo e tem vontade MESMO de estudar e ler muito para aprender oq eh cleo, seja bem vindo aqui!
TUTORIAL DE CLEO CRIADO POR LINK/2012 CONVERTIDO PARA BBCODE POR MIM


Bem vindos ao meu tutorial de SCM\CLEO Scripting, irei ensinar tanto a fazer mods CLEOs como também coisas sobre programação, não muito na parte de iniciantes para não confundir vossas mentes.


A primeira parte aborda somente a interface do Sanny Builder e suas características.

Antes de tudo você precisa do Sanny Builder, clique aqui para baixá-lo.
Instale o Sanny Builder normalmente, depois disso tenha certeza que você tem a CLEO4 instalada no seu Grand Theft Auto San Andreas, você pode escolher entre o instalador e a versão zipada.
-Download do Instalador
-Download Zipado (Basta extrair na pasta do seu GTA San Andreas)

Após ter instalado o Sanny Builder, vá em [Ferramentas > Opções]
Você verá algo como isso, configure como está na imagem abaixo, trocando apenas o Directorio do GTA San Andreas, pelo directório onde seu GTA SA esta instalado. E o INI Path pelo Directório do seu Sanny Builder\data\sa\sascm.INI



Ao Longo dos tutoriais irei explicar o que cada uma dessas opções fazem.
Ainda nas opções, vá ate a aba Formatos e procure isso (Convertedor do Case) no canto inferior direito e mude para Como é



Novamente, ao longo dos tutoriais vou informar o que isso faz.
Certo, ainda não acabamos, agora você prescizar atualizar parte do seu Sanny Builder para a CLEO4, como fazer isso? Temos duas formas... Com o instalador da CLEO4 ou com um zip que eu upei (é diferente do Zip acima.).
-Download do Instalador (Instale com a opção Sanny Builder 3 data files marcada)
-Download Zipado (Basta extrair na pasta do seu Sanny Builder)

O que é a Cleo?
Em poucas palavras: É uma biblioteca que adiciona novos opcodes (Se não sabe o que são opcodes, você entendera ao longo do tutorial, não nessa primeira parte) e a possibilidade de criar scripts customizadas, que não prescizam de se criar um novo jogo. (Antigamente, os mods eram .scm, e era necessário dar um novo game)


*O que é o Sanny Builder?
O Sanny Builder é uma IDE com syntax highlighting para SCM\CLEO, compila e decompila, e algumas ferramentas adicionais, existem outros compiladores, porem o Sanny Builder é o mais usado, por ser o melhor e mais novo.

Syntax Highlighting
Vejamos a diferença entre um código com Syntax Highlighter e sem, não precisa entender o código, ate porque eu ainda não ensinei nada.

Codigo com Syntax Highlighting:



Codigo sem Syntax Highlighting:



Percebeu a diferença? Fica muito mais simples.

Compilação e Decompilação
O Decompilador é o responsável por transformar o código de maquina que o GTA San Andreas entende para um código que possa ser lido por humanos. (Não que código de maquina não possam ser lidos por humanos, mas...)

O Compilador é o responsável por fazer ao contrario, transformar o código que escrevemos para o código de maquina que pode ser lido pelo GTA San Andreas.

Quando o código esta compilado é impossível de ler ele através de editores de texto, como bloco de notas.

Código compilado, em hexadecimal:

Código:

40 12 44 07 00 03 05 00 06 00 00 70 42 01 00 04 00 D6 00 04
00 56 02 02 08 00 4D 00 01 82 FF FF FF D6 00 04 00 B0 0A 04
4F 4D 00 01 88 F7 FF FF 02 00 01 6F FF FF FF AE 0A 03 03 00
06 00 03 02 00 04 00 02 00 01 AC FF FF FF 01 00 04 00 D6 00
04 00 B1 0A 01 87 F4 FF FF 04 00 00 4D 00 01 AC FF FF FF 90
03 09 4D 50 33 50 00 00 54 00 8F 03 04 01 0E 06 70 6C 61 79
65 72 8F 03 04 02 0E 06 76 6F 6C 75 6D 65 8F 03 04 03 0E 05
76 69 63 6F 6E 50 00 01

Código compilado, aberto no bloco de notas:

Código:

@ D        pB    Ö  V    M  ‚ÿÿÿÖ  °
 OM  ˆ÷ÿÿ  oÿÿÿ®
            ¬ÿÿÿ    Ö  ±
 ‡ôÿÿ  M  ¬ÿÿÿ  MP3P  T     player    volume    viconP

Tudo bem, não presciza entender coisas desse tipo por enquanto.

Interface do Sanny Builder

Expandir esta imagem Ver em tamanho real

Spoiler:

Ferramentas
O Sanny Builder vem com duas ferramentas muito importantes, são elas:

Opcode Search Tool (CTRL+ALT+2 ou Ferramentas>Ferramentas IDE>Procurar Opcodes)



Com esta ferramenta é possivel buscar por opcodes rapidamente, é a ferramenta mais útil na minha opinião.
Eu posso pesquisar por novas possibilidades (Ex: Create New Island, claro que não existe é só um exemplo) e procurar outras que já foram usadas que foram esquecidas (Ex: Create Car);

Gerenciador de Coordenadas (CTRL+ALT+1 ou Ferramentas>Ferramentas IDE>Gerenciador de Coords...)



Outra ferramentamenta bastante útil, todas as posições de um jogo é baseada em coordenadas, aqui você pode obter as coordenadas (O jogo tem que estar aberto para essa ferramenta ficar ativada), utilize o Copy para copiar as coordenadas para sua área de transferencia (Como CTRL+C), use o Read para ler as coordenadas atuais do seu personagem e use Set para mudar a posição do seu personagem para as coordenadas que você indicar.

Ferramentas do Usuário (Ferramentas>Ferramentas IDE>Ferramentas do Usuário...)
Boa ferramenta, você pode ligar o Sanny Builder a outras ferramentas de desenvolvimento (Ex: Map Editor), é muito simples de usar, vejam o exemplo da imagem logo abaixo, use com sabedoria.



Ficara algo como isso em Ferramentas > Ferramentas IDE



Perfeito, agora vamos testar se o seu GTA San Andreas esta mesmo com a CLEO4 e o Sanny Builder rodando perfeitamente...
Cole o código abaixo no seu Sanny Builder

Código:

{$CLEO}
0000:
:TESTE
0001: wait 0
if
0ADC: cheat "CLEO"
jf @TESTE
0AD1: show_formatted_text_highpriority "CLEO %i Funcionando Perfeitamente" time 2000 4
0001: wait 2000
jump @TESTE

Em seguida aperte F7 (Compilar+Copiar) salve o .txt em qualquer lugar, de OK no dialogo que aparecer do sucesso da compilação e depois aperte F8 (Iniciar San Andreas);

Entre em um jogo (Novo ou Salvo) e digite CLEO, se aparecer a mensagem "CLEO 4 Funcionando Perfeitamente", esta tudo certo, caso contrario, tem algo errado, cheque se você mudou o case para Como é (Mostrei isso logo no inicio do tutorial), e cheque se a CLEO4 esta instalada, no canto do Sanny Builder onde indica isso (Explicado também, na tabela da interface do Sanny Builder).

Por fim, delete o arquivo criado acima, na pasta CLEO do seu GTA San Andreas.