Índice de tutoriais
1. Tudo dentro do possível...
Estou reescrevendo este tutorial, pois percebi que exitem pouquíssimos tutoriais de main.scm pela internet, e os que existem, não são satisfatórios, então resolvi fazer o meu próprio, mas você também precisa fazer um esforço para as coisas darem certo, portanto, irei passar os requisitos mínimos para que possamos seguir com o tutorial.
Requisitos mínimos:
Um PC qualquer
Um PS2
Ler e entender os tutoriais de
Sanny Builder
Para um melhor entendimento e aplicação, também irei passar os
requisitos recomendados:
Um PC que rode o emulador de PS2
Ler e entender os tutoriais de
Sanny Builder
Ler e entender os tutoriais de
GTA3Script
Ler e entender o
Learn GTA3Script in Y minutes.
Note que removi a necessidade de um PS2, caso você tenha um computador razoável que rode o PCSX2, isso facilita e deixa os testes muito mais rápidos, e antes que me venha falar que o emulador não é o PS2, saiba que ele foi feito para funcionar com o PS2, inclusive a "BIOS" usada neles é extraída de consoles reais, ou seja, o que de mod não funciona no emulador, não funciona no PS2, ponto.
2. Colocando as coisas na prática
Existem dois métodos para criação de scripts para PS2, utilizando Sanny Builder ou Visual Studio Code, para qualquer um dos casos, os tutoriais estão linkados no trecho abaixo de "requisitos recomendados". Mas pera aí, Daniel, por qual motivo você está indicando tutoriais de CLEO Scripting, sendo que o GTA San Andreas de Playstation 2 ainda não possui uma biblioteca CLEO? A Biblioteca CLEO (erroneamente chamada de livraria, falso cognato) adiciona apenas cerca de 100 opcodes para facilitar e aumentar as possibilidades para mods, mas é uma ínfima quantidade comparada a quantidade de opcodes originais, pouco mais de 2300, então, dependendo do tipo e nível de complexidade do mod que deseja criar/portar, o uso de Opcodes CLEO não é algo absolutamente necessário.
Mas afinal, quais são esses opcodes que não podemos utilizar?
Opcodes que fazem parte da CLEO, e também os específicos para o PC e Xbox. Fiz uma lista, vou por em spoiler abaixo, pois ela é imensa:
Mesmo com essa lista em mãos, a possibilidade de colocar um opcode errado e crashar seu game é grande, portanto, eu(Daniel69) editei a versão mais recente do Sanny Builder e adicionei mais um "game" na lista inferior direita, o "GTA SA PS2". Com esse modo, você vai poder compilar qualquer código dentro do main.scm do PS2, e caso tenha algum opcode que o PS2 não leia, o Sanny Builder irá gerar um erro e parar o marcador direto no opcode não suportado.
NÃO RECOMENDO DESCOMPILAR SCRIPTS USANDO ESTE MODO, para descompilar, use o modo GTA SA SCR, pois não dará nenhum erro na hora de descompilar scripts com comandos CLEO.
Acho que já enrolei demais nessa parte, vamos pegar alguma situação prática.
Código: Selecionar tudo
03A4: script_name "VCAMRIV"
:VCAMRIV_11
0001: wait 0
00D6: if
0256: is_player_playing $PLAYER_CHAR
004D: goto_if_false @VCAMRIV_11
0001: wait 0
00D6: if
80DF: not is_char_in_any_car $PLAYER_ACTOR
004D: goto_if_false @VCAMRIV_11
0001: wait 0
00D6: if
8818: not is_char_in_air $PLAYER_ACTOR
004D: goto_if_false @VCAMRIV_11
0002: goto @VCAMRIV_78
:VCAMRIV_78
0001: wait 0
00D6: if
0256: is_player_playing $PLAYER_ACTOR
004D: goto_if_false @VCAMRIV_78
00D6: if and
80DF: not is_char_in_any_car $PLAYER_ACTOR
86B9: not has_cutscene_loaded
004D: goto_if_false @VCAMRIV_78
0819: get_char_height_above_ground $PLAYER_ACTOR store_to 10@
00D6: if or
8031: not 10@ >= 5.0
0A0C: is_player_using_jetpack $PLAYER_CHAR
004D: goto_if_false @VCAMRIV_78
04C4: get_offset_from_char_in_world_coords $PLAYER_ACTOR offset 0.27 0.2 0.5 store_to 1@ 2@ 3@
0920: camera_set_vector_track 1@ 2@ 3@ to 1@ 2@ 3@ time 100 ease 2
0922: camera_set_lerp_fov 70.0 to 70.0 time 2000 ease 2
00D6: if and
00E1: is_button_pressed 0 button 6
8A0C: not is_player_using_jetpack $PLAYER_CHAR
004D: goto_if_false @VCAMRIV_78
00D6: if and
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 1
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 2
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 3
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 4
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 5
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 6
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 7
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 8
004D: goto_if_false @VCAMRIV_78
00D6: if and
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 9
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 10
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 11
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 12
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 13
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 14
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 15
004D: goto_if_false @VCAMRIV_78
00D6: if and
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 16
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 17
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 18
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 39
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 40
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 44
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 45
82D8: not is_char_holding_weapon $PLAYER_ACTOR weapon 46
004D: goto_if_false @VCAMRIV_78
0002: goto @VCAMRIV_443
:VCAMRIV_443
0925: camera_reset_new_scriptables
0002: goto @VCAMRIV_78
O utilizado como exemplo é um script simples que altera a posição da câmera, ele é tão simples que nem chega a usar opcodes da CLEO, mas então, como vamos colocar ele no PS2?
Primeiramente, mude o modo para GTA SA PS2
Após isso, abra o main.scm e procure "start_new_script", e após encontrar, crie mais um com o seu mod, dessa forma:
Depois disso, procure o último script, no meu caso, o :NONAME_2 vá até o fim dele, crie a label do seu mod e cole ele logo abaixo, ficando mais ou menos assim:
Agora, só compilar o main.scm com o botão F6 ou na barra de ferramentas, e seja feliz ;)
Adendo 1:
Aqui abaixo, vou por alguns opcodes CLEO que você pode substituir por convencionais, então, essa parte será atualizada com o passar do tempo.
0A93: terminate_this_custom_script
para
004E: terminate_this_script
0AB0: key_pressed 73
para
00E1: is_button_pressed 0 button 16
(Tabela de botões
aqui)
