CSO Scripts Decifrado
Introdução
Olá pessoal, vou começar este post com uma pergunta, quantos de vocês já jogaram o jogo
Scarface: The World is Yours de 2006 ?
Pois é, sei que é um jogo um pouco antigo, mas pessoalmente me rendeu várias horas de muita diversão na frente da TV (PS2).
Com o jogo em mãos para a versão de computador, aliado aos meus estudos em engenharia reversa, decidi que iria tentar decodificar os arquivos de script do jogo.
Por qual motivo estou criando esse tópico ?
Simples, porque não existe sequer uma documentação sobre os scripts do Scarface na internet.
O que eu descobri pode ser útil algum dia para dar um pontapé inicial ao modding do jogo.
Sem falar na minha enorme vontade de criar um script para o player pular, sim, PULAR.
O Tony Montana do jogo não sabe pular, ele só sabe andar, atirar, dirigir, pilotar lancha, mas não sabe PULAR (que raiva aaarrghhh).
Descobertas
Os arquivos de script do jogo estão no formato .DSO e outros no formato .CSO
Na primeira vez que abri um dos scripts, tive quase a certeza de que era um script LUA, a estrutura era bem semelhante, então uma empolgação tomou conta de mim, bastava usar o LuaDec e problema resolvido, certo ? Só que não! Após alguns minutos de análise pude notar algumas pequenas diferenças quanto a estrutura e descartei essa possibilidade.
Veja abaixo uma snippet de um dos scripts.
Então o que eu poderia fazer ? Não tenho muita familiaridade com formatos dos jogos antigos, estava com dificuldade de entender o formato, não havia nada sobre o desenvolvimento do jogo na web... então só me restava uma coisa, conhecer a história! A partir daí tudo começou a fazer mais sentido.
Conheci mais sobre a produtora (Radical Entertainment), os jogos passados e descobri que na verdade eles utilizaram uma engine que na época era referência para criação de jogos: a
Torque Engine. Essa engine foi disponibilizada em código aberto em 2012.
Logo, por associação, ficou claro que os scripts do jogo na verdade estavam escritos em
Torque Script, mais precisamente na linguagem "C Script" que se assemelha muito á linguagem C que conhecemos.
Excelente, sabendo a linguagem era hora de estudar sobre ela e tentar encontrar meios de decifrá-la.
Para minha sorte, encontrei 2 artigos que falavam sobre como decodificar os scripts para 2 jogos:
Frozen Synapse e
Think Tanks.
Esses dois artigos foram essenciais para que eu aprendesse o formato do arquivo, em especial o primeiro artigo.
https://blog.kwiatkowski.fr/?q=en/broken-synapse
http://www.planetthinktanks2.com/forums ... hp?t=12819
Fiquei muito feliz, mas essa felicidade durou pouco, mais uma vez...
Não havia compatibilidade entre os 2 tipos de "C Script", apesar do formato ser o mesmo.
Por exemplo, a leitura de 4 bytes em um, no outro era 2 bytes.
A contagem de um deveria ser multiplicada por 8 enquanto no outro deveria ser por 4.
A ordem das tabelas de string e floats estava alterada.
Vários bytes foram removidos, dentre outros.
Tudo isso inviabilizou o uso dos
decompilers existentes, até mesmo entre os dois jogos (Frozen e Tanks) não havia compatibilidade alguma.
Enfim, só me restava agora bater de frente com o problema, e a partir do que eu já tinha em mãos, tentar decifrar os arquivos do Scarface por conta própria.
Passei dias e dias tentando entender realmente como os códigos estavam organizados e finalmente, depois de muitos erros e poucos acertos cheguei a uma conclusão, no qual tenho 99,999999% de certeza.
O Formato do Arquivo
Abaixo você encontra a organização dos scripts do jogo. No formato: [ X bytes - Descrição ]
- 4 bytes: Versão do Script (É sempre 1)
- 4 bytes: Tamanho da Tabela GS
- X bytes: Tabela GS
- 4 bytes: Tamanho da Tabela GF
- X bytes: Tabela GF
- 4 bytes: Tamanho da Tabela FS
- X bytes: Tabela FS
- 4 bytes: Tamanho da Tabela FF
- X bytes: Tabela FF
- 4 bytes: Tamanho do Código
- X bytes: Código
- 4 bytes: Tamanho da Tabela IDENT
// Para cada item da Tabela IDENT teremos:
- 4 bytes: Offset
- 4 bytes: Count
- 4 bytes * Count: Locations
Nomenclatura
- GS: Global Strings
- GF: Global Floats
- FS: Function Strings
- FF: Function Floats
Para entender melhor o que significa todos esses parâmetros recomendo você ler o
primeiro artigo que deixei acima.
Lá está explicado com mais detalhes, e para não ficar muito grande o post deixo pra você essa lição de casa :D
Cada string das Tabelas GS, GF, FS, FF são separadas por bytes nulos
0x00 (ou 00)
Para o
Código a leitura é feita byte por byte, levando em conta o tamanho dele.
A cada byte
0xFF (ou FF)
encontrado devemos ler os 2 próximos bytes seguintes como se fosse um único byte.
Exemplo de leitura, utilizando o CSharp.
Código: Selecionar tudo
// br faz referência ao BinaryReader
for (uint contarCodigo = 0; contarCodigo < tamanhoDoCodigo; contarCodigo++)
{
ushort byteAtual = br.ReadByte();
if (byteAtual == 0xFF){ byteAtual = br.ReadUInt16(); }
code.Add(byteAtual);
}
Há casos em que encontraremos 2 bytes FF seguidos e isso deve ser levado em consideração, por exemplo:
Na sequência de bytes
48 00 FF FF 04 4D 33 34 há 2 bytes
FF seguidos.
Nesse caso, devemos desconsiderar a leitura dos
2 bytes seguidos do primeiro byte
FF e ler os dois bytes seguidos do outro
FF no qual leríamos
04 4D. Não sei até que ponto isso pode influenciar na leitura do código durante uma decompilação, pelos outros scripts não notei casos de FF seguidos, nem tratamentos caso isso acontecesse.
Se você leu os artigos que deixei acima, pode perceber que existem algumas diferenças nos formatos de cada jogo...
Ao invés de 2 bytes de leitura para cada byte FF no
Código do Scarface, você deveria ler 4 bytes no
Frozen Synapse...
Não existe
linebreak_count e nem
linebreak_pairs para os scripts de Scarface.
Mapeamento dos bytes de um dos scripts
No exemplo abaixo, você pode visualizar como está dividido os bytes de um script (pequeno em tamanho).
O que vem mais ?
Neste tópico estou reunindo todas as minhas descobertas sobre o formato do script, bem como encontrar maneiras de decodificá-lo.
Não garanto que irei conseguir, por isso mesmo estou criando este tópico, para deixar todas as minhas descobertas sobre o script e caso eu não consiga outra pessoa com mais experiência no assunto possa conseguir, pelo menos uma base sólida de conhecimento sobre o formato já vai encontrar.
Scarface é um jogo incrivel, tem suas falhas, mas ainda assim as qualidades são maiores, além de lembrar nosso querido GTA.
Não há nenhuma comunidade modding para ele, e infelizmente está caindo no limbo do esquecimento.
As possibilidades são imensas para esse jogo. Pelas minhas pesquisas, a Torque Script nativa possibilitaria a criação de milhares de mods, tanto pela facilidade de escrever seus códigos como pela vasta documentação que possui.
Espero vir com boas notícias em breve, no momento é isso, abraços.
Leo "Meth0d"