Concluindo esta parte você irá:
Aprender a chamar funções, métodos e sua mãe. Com isto, você pode aproveitar de funções internas do jogo, ou mesmo de outros plugins, como asi e dll.
Comandos CALL
Há poucos...
CALL_FUNCTION
CALL_FUNCTION_RETURN
CALL_METHOD
CALL_METHOD_RETURN
As variações
RETURN são as funções que retornam algum valor.
FUNCTION é uma função comum, enquanto
METHOD são métodos relacionados à instância de uma class.
Por exemplo:
Criar um tiro num local, normalmente será um
CALL_FUNCTION
Fazer um carro explodir, normalmente será um
CALL_METHOD
Tendo a ideia base na cabeça, agora vamos ser mais objetivos...
Interpretando e escolhendo os comandos CALL
Antes de tudo, você precisa ter as informações de uma função ou método.
Inclusive, vamos simplificar a comunicação e chamar tudo de "função", certo?
Eu recomendo altamente que você aprenda o
básico de engenharia reversa para você mesmo procurar as funções do jogo e não ser dependente de sites e outras pessoas, mas você não precisa parar agora para isso, vamos trabalhar com alguns exemplos retirados do IDB do GTA SA:
Considerações iniciais:
Os comandos de
CALL são semelhantes ao
CLEO_CALL, com a diferença de que você envia um endereço do jogo, ou de uma função de algum .asi etc. E diferente do
CLEO_CALL que após a label você envia um
0 que o compilador automaticamente preencherá para você, os
CALL você deve não só colocar o número de argumentos que você enviou (push), como também o pop. Isto são conceitos do Assembly, mas na prática é simples:
No CALL_FUNCTION, o número de pop é sempre o mesmo do push, enquanto no CALL_METHOD, o número de pop é sempre 0. Você entenderá melhor abaixo.
A sua real dor de cabeça será que, ao chamar algo por CLEO, você deve enviar os argumentos de maneira contrária. Isto é algo muito sério, se você não quer perder o seu dia tentando resolver um problema, lembre-se disso. Se uma função pede
arma munição você tem que enviar
munição arma, é péssimo!
Exemplos práticos:
void __cdecl CGameLogic::PassTime(unsigned int a1) (0x004414C0)
O que faz: Simula o passar do tempo dado um número de minutos, considerando todo o relógio e calendário do jogo, tempo dos pickups e até mesmo posição das nuvens do
Real Skybox. Lembre-se que há o comando
PASS_TIME no
CLEO+.
Comando: CALL_FUNCTION, pois é um
__cdecl, o tipo mais comum de todos. O mesmo vale para
__stdcall. E não há retorno, como vemos no início em
void.
Argumentos: Coleta 1 argumento, e por ser
__cdecl, temos que dar o mesmo número de pops, portanto:
1 1. Para
__stdcall pode ser necessário usar 0 em pop, ou seja, neste exemplo seria
1 0.
Uso: CALL_FUNCTION 0x004414C0 1 1 (60)()
CPed *__thiscall CPed::SetAmmo(CPed *this, int weapon, int ammo) (0x005DF290)
O que faz: Dará certa quantidade de munição para certa arma de certo CPed. Igual ao comando
SET_CHAR_AMMO.
Comando: CALL_METHOD, pois é
__thiscall onde você precisa enviar um ponteiro para um CPed. Acontece o mesmo com
__fastcall. No início vemos um
CPed * que dá a entender que retorna um ponteiro para um CPed, no entanto, isto não é verdade. É comum você ver coisas assim no IDA Pro pois a maneira que o código foi compilado e Assembly funciona não dá para ter certeza de que algo é retornado ou não, portanto, use a sua lógica, neste caso, não há retorno algum.
Argumentos: Coleta 2 argumentos, lembrando que o
this não conta por ser um
__thiscall. Inclusive, por ser
__thiscall, o número de pops sempre será 0, portanto,
2 0. Lembrando que a ordem dos argumentos/parâmetros é invertida!!!
Uso: CALL_METHOD 0x005DF290 pChar 2 0 (9999 iWeaponType)()
Uso completo:
Código: Selecionar tudo
IF TEST_CHEAT AMMO
GET_CURRENT_CHAR_WEAPON scplayer iWeaponType
GET_PED_POINTER scplayer (pChar)
//CPed *__thiscall CPed::SetAmmo(CPed *this, int weapon, int ammo) (0x005DF290)
CALL_METHOD 0x005DF290 pChar 2 0 (9999 iWeaponType)()
ENDIF
int __thiscall CAutomobile::GetNumContactWheels(CAutomobile *this) (0x006A62A0)
O que faz: Retornará o número de rodas em contato com o chão para aquele CAutomobile, lembrando que CAutomobile é a classe pai de um CVehicle, CBike e tudo (sim, o nome é confuso, pois CAutomobile é o pai de todos os veículos, não só automóveis, lembre-se disso e reclame com a Rockstar). Lembre-se do que aprendemos sobre
classes. Isto somente lê o
CAutomobile+0x960 (1 byte), portanto não é um comando tão útil na prática.
Comando: CALL_METHOD_RETURN, pois é um
__thiscall onde você precisa enviar um ponteiro para um CAutomobile, e no início, vemos um
int, que é o datatype de retorno.
Argumentos: Não coleta nenhum argumento, portanto o número de push e pop é
0 0
Uso: CALL_METHOD_RETURN 0x006A62A0 pVeh 0 0 ()(n)
Uso completo:
Código: Selecionar tudo
IF IS_CHAR_SITTING_IN_ANY_CAR scplayer
STORE_CAR_CHAR_IS_IN_NO_SAVE scplayer (hVeh)
GET_VEHICLE_POINTER hVeh (pVeh)
//int __thiscall CAutomobile::GetNumContactWheels(CAutomobile *this) (0x006A62A0)
CALL_METHOD_RETURN 0x006A62A0 pVeh 0 0 ()(n)
PRINT_FORMATTED_NOW "Contact wheels: %i" 100 n
ENDIF
void __usercall CVehicle::DoSunGlare(CVehicle *entity@<ecx>, int a2@<ebp>) (0x006DD6F0)
O que faz: Renderiza o reflexo do Sol no tal CVehicle, como no GTA Vice City, removido da versão final do jogo, reativado pelo SkyGfx.
Comando: CALL_METHOD, pois é um
__usercall que é semelhante ao
__thiscall.
Argumentos: Nenhum, diferente do que parece. No
__usercall temos um argumento adicional, falso, que deve ser ignorado, aquele com registrador
ebp.
Uso: CALL_METHOD 0x006DD6F0 pVeh 0 0 ()()
Ainda mais considerações:
Você precisa entender o ultra básico de outras programações, como C++, para compreender os argumentos, pois há algumas funções muito difíceis de serem chamadas, por exemplo:
char __thiscall CWeapon::FireInstantHit(CWeapon *this, CPed *firingEntity, CVector *posn, CVector *effectPosn, CEntity *targetEntity, CVector *target, CVector *posnForDriveBy, char a8, char additionalEffects)
Você precisará de muitas coisas, por exemplo, o que diabos é um
CVector *? É simplesmente um ponteiro para uma sequência de 3 floats (normalmente coordenadas XYZ), algo que você consegue por exemplo com thread memory ou tendo uma sequência de 3 variáveis seguidas,
x y z, o ponteiro para a variável
x é equivalmente à um
CVector *, entendeu? E se fosse um
CVector **, seria um ponteiro, para um ponteiro.
Para domar o uso de funções, você precisa ter bom entendimento das classes do jogo, afinal, o que diabos é um
CWeapon *? O array de CWeapon fica em
CPed + 0x5A0, e o tamanho de cada CWeapon é
0x1C (
28 bytes), ou seja, para ter o
CWeapon * da arma de slot
2 você precisa
CPed + 0x5A0 + (28 * 2), e lembre-se, é um ponteiro para o CWeapon, portanto você tem que enviar este endereço, literal, bruto, em vez de lê-lo. Tudo isto você entende domando
engenharia reversa, lendo o código do jogo e lista de structs/classes você mesmo.
No exemplo dito agora, há também
char que é simplesmente um número de 1 byte, sem mistérios.
Mas o problema vem quando o retorno é um bool: Um bool, de verdade, é 1 bit, portanto, quando você usar uma função que retorna um
bool, retornará somente o primeiro bit como verdadeiro ou falso. Sendo assim, você não poderá usar
IF ret = TRUE para checar se o retorno foi verdadeiro, mas sim
IF IS_LOCAL_VAR_BIT_SET_CONST ret 0, pois a única coisa que importa é o primeiro bit, que é o bit 0.
Mais dicas
Mesmo não necessário no gta3script, eu recomendo que você deixe explícito os argumentos de envio e retorno marcando-os com
(), por exemplo,
(car)(health) (imaginando que você enviou um carro e retornou a health),
(car)() (imaginando o mesmo, sem retorno),
()(day) (imaginando que você enviou nada mas retornou o dia), ou até mesmo
()() para funções que enviam nada e retornam nada. Assim fica mais legível e menos propenso à erros bobos.
Também eu recomendo que você sempre deixe uma linha comentada com a anotação da função original para, caso algum erro, você confira se realmente colocou os argumentos corretamente etc.
Próxima parte:
(em breve...)
