Livraria CLEO 4.3.23 beta

Atualizado 4.3.23 beta (não-oficial) - 13/04/18

Sobre a atualização:
Não era possível utilizar endereços variáveis de arquivos .ini, assim impossibilitando criar certos tipos de mods, um deles foi o MDPMv5 devido ao sistema de skins. Tuning Mod teve o mesmo problema mas improvisei.
Fabio fez esta correção e ela já foi aprovada oficialmente no Github da CLEO, no entanto, ainda não lançada. Em vez de esperar os responsáveis pela CLEO lançarem a nova versão (que eu já pedi há 2 meses) para só assim ser possível lançar o MDPMv5, foi decidido que eu mesmo lançarei de modo não-oficial. E sim, isto é permitido pela licença (ver LICENSE.md).

De fato, esta atualização é toda do pessoal aqui do blog, o Nex' também fez a segunda correção.

-- 4.3.23 beta (unofficial) --

• Possibilidade de usar ponteiro no parâmetro de endereço nos opcodes de manipulamento de arquivos .ini.
• Corrigido o opcode 0ABA causando heap corruption.
• Corrigido as variáveis compartilhadas não resetadas corretamente. O que causava mal funcionamento em mods que as usam e você dar new game ou load game num slot sem as variáveis.
• Bug: Não compatível com modelos acima do ID 2000 (ou seja, incompatível com conversões totais como SAxVCxLC e GTA Underground)

Se você cria mods, já pode se beneficiar desta correção, pois ela certamente estará no próximo lançamento oficial.

---

Inicialmente desenvolvida por pelo russo "Seemann" em 24/03/07, a Livraria CLEO (mais corretamente chamada de Biblioteca CLEO) atualmente volta para corrigir certos problemas ocorridos no desenvolvimento e, em breve, quem sabe chegaremos na CLEO 5!

Pontos fortes da nova versão da CLEO:

• Diferente da CLEO 4.1, nunca mais terá bugs dos quadrados brancos na tela caso usar vários mods que adicionam imagens (sprites) ao mesmo tempo (por exemplo visto em mods de velocímetro).
• Vários crashes e bugs corrigidos. Os novos mods criados usarão estes benefícios e correções da livraria nos scripts, portanto cuidado em usar mods novos com CLEO 4.1, os novos podem funcionar somente na CLEO 4.3 (em vários casos). Eu particularmente crio meus mods sempre para a versão mais recente disponível.
• Caso algum mod feito para CLEO 3 não funcione na CLEO 4.3, você pode renomear o arquivo para .cs3 para assim entrar no modo de compatibilidade. (mas isso é raro de acontecer)
• Várias outras compatibilidades entre mods e correções de comandos não funcionando corretamente.

Baixe mods cleos aqui na MixMods (cleo é o ponto forte deste blog)

Aprenda a criar mods cleos, o mais moderno e atualizado tutorial de cleo do mundo! Escrito por mim.
Aprenda como foi a história de desenvolvimento da cleo (cleo 1, cleo 2 etc), uma boa curiosidade.

---

Autores:

CLEO 1, 2, 3 e 4.3: Seemann

CLEO 4 e 4.1: Alien

CLEO 4.3: Deji

Agradecimentos:
Listener (pela bela exploração no universo GTA)
NTAuthority e LINK/2012 (pela ajuda com a CLEO 4.3)
mfisto (alpha tests da CLEO 4, suporte e conselhos)

4.3.23 beta (não-oficial)
Necessário para o funcionamento do MDPMv5 e outros mods que estão por vir.

  

4.3.22 (oficial)

(instalação automática; instalador oficial)

---

Como instalar Livraria CLEO

(pelo download oficial)

Extraia para alguma pasta do seu PC (caso você use 7zip, você pode ir em "botão direito do mouse > Abrir por Fora", ou extraia se quiser)

Inicie o instalador (de preferência em modo de administrador).

Durante a instalação selecione a pasta do seu GTA San Andreas. Lembre-se que é recomendado não tê-la instalada na pasta Program Files.

Também terá uma parte para marcar o que você quer ou não instalar, não precisa mexer nisso, ou então instale o Silent Asi Loader também, no entanto, virá uma versão desatualizada. Você pode baixar a última versão aqui e instalar depois.

Depois de instalar, vá na pasta do seu GTA, terá uma pasta com nome "CLEO", também um "cleo.asi" e dentro da pasta "CLEO" terá também arquivos ".cleo" e pasta "cleo_text". Se não tiver, você vai precisar mover a pasta do jogo para os Documents como dito acima ou então iniciar o instalador da cleo em modo de administrador (botão direito no .exe) (também como dito acima).

Tendo a pasta CLEO instalada no GTA, basta baixar os mods cleo para o jogo e instalar normalmente como dito no arquivo "Leiame.txt" de cada mod que você baixa, ou seja, arquivos .cs dentro da pasta CLEO (ou utilizando ModLoader).

 

---

  

  

Abra o post para ver a lista completa de novidades desde a CLEO 4.3

(Change Log em inglês)

---

       CLEO 4
--------------------
     Change Log

-- 4.3.22 --

* Now creates cleo, cleo/cleo_saves and cleo/cleo_text folders on startup if they do not exist
* Fix to issue with 0AE9 not returning result

-- 4.3.21 --

* Fixed operand type IDs in CLEO.h
* Added 'extern' to variables declared in CLEO.h

* Fix to issue with 0AB1 in missions not storing mission locals

-- 4.3.19-20 --

* Fixed issue with 0AB1 passing incorrect variable scope in missions
* Updated SDK version

-- 4.3.17-18 --

* Fixed potential future problem with 0AB0 which used methods with undefined behaviour
* Fixed incorrect method used for 0AB7

-- 4.3.16 --

* Fixed bugs with CLEO saves when saved scripts ended
* Prevented crashing when invalid audiostream handles are used

-- 4.3.15 --

* Improvemed compatibility fix for opcodes 0AE1, 0AE2 and 0AE3 with incorrect find_next usage

-- 4.3.14 --

* Fixed 0AAA only returning custom scripts
* Fixed many things which use the 'SCM Block' or 'Mission Local Storage' space
* Fixed parameters being passed to script local storage instead of mission local storage through 0A94
* Fixed potential problems with iteration through the script queues (may cause rare and hard to trace bugs)

-- 4.3.13 --

* Fixed crashing when starting a new game after a game has already started with CLEO scripts installed
* Possibly fixed other issues with starting a game with CLEO scripts installed

-- 4.3.12.1 --

* Un-did the 'Scripts no longer load prematurely' fix as it caused scripts to not load certain circumstances (like before CLEO 4)
* Included 'cleo_text' folder in installation

-- 4.3.12 --

* Fixed string parameter skipping in 'SkipOpcodeParams' used by CLEO plugins
* 0AC8 now returns a NULL value to the output var if allocation failed (as it did before 4.3a)
* 0AC9 now checks the memory was allocated by 0AC8 before attempting to free it
* FXT references are now case insensitive (as they were before 4.3a)
* File operations now check the input handle isn't null (as it seems was the way before 4.3a)
* 'Loaded mission' status now reset on new/loaded game (as it was before 4.3a)
* Scripts no longer load prematurely (like before 4.3a)
* Resolved conflicts with other menu hooks such as 'HUME'
* Other minor tweaks

-- 4.3.11 --

* Fixed crash with 0ADA in scripts beginning with an opcode ending in '00'

-- 4.3.10 --

* Improvements to opcodes 0AE1, 0AE2 and 0AE3 - now loops around the pool even when the 'find_next' flag isn't used correctly
* Fixed 0AD2 not returning peds targetted with the mouse, while targetting with a pad worked

-- 4.3.9 --

* Will now be able to start a CLEO mission after recently finishing a standard mission
* Will no longer error & terminate when scripts fail to open and instead simply log the error
* Will no longer terminate on warnings
* No longer includes paths in automatically generated script names (e.g. cleo\dir\demo.cs is now named 'demo.cs' and not 'dir\dem')
* Improved handling of script load errors

-- 4.3.8 --

* Fixed crash which would occur when missions were ended with 004E

-- 4.3.7 --

* Custom missions launched by CLEO scripts now inherit their compatibility mode - possibly fixing incompatibilities with mods using custom missions
* The current directory set by 0A99 is now script-dependant and only affects running CLEO scripts (not the entire game or the main.scm)
* Text and texture/sprite draws are now script-dependant (doesn't affect main.scm scripts)

-- 4.3 --

* Replaced code which dynamically allocated and deallocated memory for script parameters every time 0AA5-0AA8 were called with static arrays
* Removed a script execution loop replacement which wasn't used for anything important and weirdly only worked with 1.0US that caused crashes with script logging plugins
* Added support for Steam (v3) versions of gta_sa.exe
* Prevented the local storage from being initialized in SCM functions when the script is in CLEO 3 compatibility mode ('.cs3' extension)


* Updates to behaviour of following opcodes:

0A99
CHANGE_DIRECTORY can now correctly change to the program directory

0A9A
OPEN_FILE now uses a 'legacy' mode when passing an integer as the mode parameter for compatibility of CLEO file handles and SA file handles
Note that you should really not pass CLEO file handles to game functions. However, this legacy mode now ensures that the handles are compatible.
Other file functions have also been updated ensuring that game file handles are passed to relevant game functions.
It is recommended to not rely on passing files to game functions and instead use CLEO 4's in-built file functions in future.

0AD1
CALL now accepts string input, which is passed as a string pointer following string convention

0AD4
SCAN_STRING now returns a condition result

0AE6
FIND_FIRST_FILE now accepts string array output

0AE3
FIND_ALL_RANDOM_OBJECTS_IN_SPHERE now ensures no fading objects are returned and returns -1 instead of 0 on failure

0AE2
FIND_ALL_RANDOM_CARS_IN_SPHERE now ensures no script vehicles or fading vehicle are returned and returns -1 instead of 0 on failure

0AE1
FIND_ALL_RANDOM_CHARS_IN_SPHERE now ensures no script characters or fading characters are returned and returns -1 instead of 0 on failure

0ADF
ADD_TEXT_LABEL now updates existing text labels if they already exist

0AD6
IS_END_OF_FILE_REACHED now returns true if a file error occured

0AD2
GET_CHAR_PLAYER_IS_TARGETING now returns -1 instead of 0 when no target is found

0AB5
STORE_CLOSEST_ENTITIES now ensures no script entities or fading entities are returned and ensures the player ped is not returned