Biblioteca CLEO 4 (4.3.16)



































-
depositfiles.comDescargar
La nueva biblioteca CLEO 4 del 19 de marzo de 2014
Scripts
Al utilizar CLEO, se pueden añadir nuevos scripts al juego, escritos en Sanny Builder u otro editor de scripts, sin necesidad de comenzar una nueva partida. Todo lo que se requiere para agregar un script al juego es colocarlo en la carpeta CLEO. El script comenzará a funcionar al iniciar el juego. Para eliminar un script del juego, simplemente elimina el archivo correspondiente.
Todos los scripts son creados por fanáticos del juego y no tienen relación con los desarrolladores de CLEO. Aunque la biblioteca CLEO debería funcionar con varias versiones del juego, algunos scripts pueden tener sus propias limitaciones y requisitos de archivos del juego. Para preguntas sobre la funcionalidad de un script específico, contacta a su autor.
Opcodes
CLEO 4 añade 100 nuevos comandos de script al juego, que permiten trabajar con archivos externos, modificar datos en la memoria del juego, invocar funciones del juego con sus propios parámetros, y mucho más.
En la cuarta versión, se introdujeron nuevos comandos para trabajar con sonidos y cadenas, y se agregó la capacidad de mostrar texto en pantalla sin usar archivos externos (.gxt, .fxt). Para apreciar los nuevos logros y utilizarlos en tus scripts, instala la última versión de la biblioteca CLEO 4.
Plugins
Los plugins de CLEO son archivos DLL normales, pero con la extensión .CLEO. Al iniciar, la biblioteca CLEO busca archivos con esta extensión en la carpeta CLEO y trata de cargarlos. Si la carga es exitosa, el plugin comienza a funcionar y a ejecutar las funciones para las que fue diseñado.
CLEO 4 permite crear nuevos opcodes utilizando el código fuente del CLEO SDK. En el paquete de inicio de la biblioteca se pueden encontrar tres ejemplos de tales plugins.
Los plugins se instalan y eliminan de la misma manera que los scripts. La lista de plugins disponibles se puede encontrar en esta página.
Instalación
CLEO 4 se distribuye como un instalador automático. Para instalar la biblioteca, ejecuta el instalador y sigue sus instrucciones.
CLEO 4.3 soporta tres versiones del juego GTA San Andreas: 1.0, 1.01, 3.0 (steam).
CLEO requiere la instalación de ASI Loader, que se incluye con la biblioteca. ASI Loader es un programa que carga automáticamente archivos con la extensión .asi al iniciar el juego. ASI Loader reemplaza uno de los archivos originales del juego 'vorbisFile.dll' por el suyo propio, así que asegúrate de hacer una copia de este archivo.
Otros archivos del juego no son reemplazados, pero se añaden los siguientes archivos y carpetas:
- cleo\ (carpeta CLEO, donde se copian todos los scripts y plugins)
- cleo\FileSystemOperations.cleo (plugin para trabajar con archivos)
- cleo\IniFiles.cleo (plugin para trabajar con INI)
- cleo\IntOperations.cleo (plugin para trabajar con enteros a nivel de bits)
- cleo\cleo_save\ (carpeta de guardado de CLEO)
- cleo.asi (núcleo de la biblioteca CLEO)
- bass.dll (biblioteca para trabajar con audio)
- vorbisHooked.dll (ASI Loader de Silent)
Todos los plugins son opcionales, pero su funcionalidad puede ser utilizada por varios scripts de CLEO.
CLEO 4 para San Andreas para reproducir archivos de sonido requiere la biblioteca BASS.dll versión 2.4, que se puede descargar desde el sitio oficial de Un4seen Developments Ltd.
Compatibilidad con CLEO 3
CLEO se mejora y expande constantemente con el tiempo. En casos muy raros, algunos scripts escritos para CLEO 3 pueden no funcionar con CLEO 4. A partir de CLEO 4.3, puedes activar un modo de compatibilidad especial para scripts de CLEO 3. Para ello, cambia la extensión del archivo del script (normalmente '.cs') a '.cs3'. CLEO 4.3 funcionará con tales scripts en un modo especial que incluye cambios en el comportamiento de algunos comandos de script. Al mismo tiempo, en la gran mayoría de los casos, los scripts de CLEO 3 funcionan con CLEO 4 sin problemas, y no se requiere el uso del modo de compatibilidad.
Fdnjhs
El autor y desarrollador original de la biblioteca CLEO es Seemann.
Los desarrolladores no tienen relación con Take 2 Interactive o Rockstar Games y no asumen ninguna responsabilidad por posibles consecuencias negativas derivadas del uso de este producto o de cualquier otro producto distribuido junto con la biblioteca. Úsalo bajo tu propio riesgo.
En CLEO 4.3 se utiliza ASI Loader de Silent.
La información sobre los cambios en la versión 4.3 y una descripción más detallada de las capacidades de CLEO se puede encontrar en los archivos readme que vienen con la biblioteca.
Agradecimientos
A Stanislav Golovin (a.k.a. listener) - por su gran trabajo en la investigación de los juegos de GTA.
mfisto - por las pruebas alfa de la biblioteca CLEO 4, consejos y apoyo
NTAuthority y LINK/2012 - por la ayuda con CLEO 4.3.
CLEO 4
--------------------
Registro de cambios
-- 4.3.15 --
* Mejora en la compatibilidad para los opcodes 0AE1, 0AE2 y 0AE3 con el uso incorrecto de find_next
-- 4.3.14 --
* Arreglado 0AAA que solo devolvía scripts personalizados
* Arregladas muchas cosas que usan el espacio 'SCM Block' o 'Mission Local Storage'
* Arreglados parámetros que se pasaban al almacenamiento local del script en lugar del almacenamiento local de la misión a través de 0A94
* Arreglados problemas potenciales con la iteración a través de las colas de scripts (puede causar errores raros y difíciles de rastrear)
-- 4.3.13 --
* Arreglado el fallo al iniciar una nueva partida después de que ya se había comenzado una partida con scripts de CLEO instalados
* Posiblemente arreglados otros problemas al iniciar una partida con scripts de CLEO instalados
-- 4.3.12 --
* Arreglado el salto de parámetros de cadena en 'SkipOpcodeParams' utilizado por plugins de CLEO
* 0AC8 ahora devuelve un valor NULL a la variable de salida si la asignación falla (como lo hacía antes de 4.3a)
* 0AC9 ahora verifica que la memoria fue asignada por 0AC8 antes de intentar liberarla
* Las referencias FXT ahora son insensibles a mayúsculas (como lo eran antes de 4.3a)
* Las operaciones de archivo ahora verifican que el manejador de entrada no sea nulo (como parecía ser antes de 4.3a)
* El estado de 'misión cargada' ahora se restablece en un nuevo/juego cargado (como lo era antes de 4.3a)
* Los scripts ya no se cargan prematuramente (como antes de 4.3a)
* Resueltos conflictos con otros hooks de menú como 'HUME'
* Otros ajustes menores
-- 4.3.11 --
* Arreglado el fallo con 0ADA en scripts que comienzan con un opcode que termina en '00'
-- 4.3.10 --
* Mejoras en los opcodes 0AE1, 0AE2 y 0AE3 - ahora recorren el grupo incluso cuando la bandera 'find_next' no se usa correctamente
* Arreglado 0AD2 que no devolvía peds apuntados con el mouse, mientras que apuntar con un pad funcionaba
-- 4.3.9 --
* Ahora será posible iniciar una misión CLEO después de haber terminado recientemente una misión estándar
* Ya no dará error y terminará cuando los scripts no se abran y en su lugar simplemente registrará el error
* Ya no terminará en advertencias
* Ya no incluye rutas en los nombres de scripts generados automáticamente (por ejemplo, cleo\dir\demo.cs ahora se llama 'demo.cs' y no 'dir\dem')
* Mejora en el manejo de errores de carga de scripts
-- 4.3.8 --
* Arreglado el fallo que ocurría cuando las misiones se terminaban con 004E
-- 4.3.7 --
* Las misiones personalizadas lanzadas por scripts de CLEO ahora heredan su modo de compatibilidad - posiblemente arreglando incompatibilidades con mods que usan misiones personalizadas
* El directorio actual establecido por 0A99 ahora es dependiente del script y solo afecta a los scripts de CLEO en ejecución (no al juego completo o al main.scm)
* Los dibujos de texto y textura/sprite ahora son dependientes del script (no afecta a los scripts de main.scm)
-- 4.3 --
* Reemplazado el código que asignaba y liberaba memoria dinámicamente para parámetros de script cada vez que se llamaban 0AA5-0AA8 por arreglos estáticos
* Eliminado un reemplazo de bucle de ejecución de script que no se usaba para nada importante y que curiosamente solo funcionaba con 1.0US, lo que causaba fallos con plugins de registro de scripts
* Añadido soporte para versiones de Steam (v3) de gta_sa.exe
* Previsto que el almacenamiento local no se inicialice en funciones SCM cuando el script está en modo de compatibilidad de CLEO 3 (extensión '.cs3')
* Actualizaciones al comportamiento de los siguientes opcodes:
0A99
CHANGE_DIRECTORY ahora puede cambiar correctamente al directorio del programa
0A9A
OPEN_FILE ahora utiliza un modo 'legado' al pasar un entero como parámetro de modo para la compatibilidad de los manejadores de archivos de CLEO y los manejadores de archivos de SA
Ten en cuenta que realmente no deberías pasar manejadores de archivos de CLEO a funciones del juego. Sin embargo, este modo legado ahora asegura que los manejadores sean compatibles.
Otras funciones de archivo también han sido actualizadas asegurando que los manejadores de archivos del juego se pasen a las funciones relevantes del juego.
Se recomienda no depender de pasar archivos a funciones del juego y en su lugar utilizar las funciones de archivo integradas de CLEO 4 en el futuro.
0AD1
CALL ahora acepta entrada de cadena, que se pasa como un puntero de cadena siguiendo la convención de cadena
0AD4
SCAN_STRING ahora devuelve un resultado de condición
0AE6
FIND_FIRST_FILE ahora acepta salida de arreglo de cadenas
0AE3
FIND_ALL_RANDOM_OBJECTS_IN_SPHERE ahora asegura que no se devuelvan objetos desvanecidos y devuelve -1 en lugar de 0 en caso de fallo
0AE2
FIND_ALL_RANDOM_CARS_IN_SPHERE ahora asegura que no se devuelvan vehículos de script o vehículos desvanecidos y devuelve -1 en lugar de 0 en caso de fallo
0AE1
FIND_ALL_RANDOM_CHARS_IN_SPHERE ahora asegura que no se devuelvan personajes de script o personajes desvanecidos y devuelve -1 en lugar de 0 en caso de fallo
0ADF
ADD_TEXT_LABEL ahora actualiza etiquetas de texto existentes si ya existen
0AD6
IS_END_OF_FILE_REACHED ahora devuelve verdadero si ocurrió un error de archivo
0AD2
GET_CHAR_PLAYER_IS_TARGETING ahora devuelve -1 en lugar de 0 cuando no se encuentra un objetivo
0AB5
STORE_CLOSEST_ENTITIES ahora asegura que no se devuelvan entidades de script o entidades desvanecidas y asegura que el ped del jugador no sea devuelto
Новая библиотека CLEO 4 от 19 марта 2014
Скрипты
При использовании CLEO в игру можно добавлять новые скрипты, написанные в Sanny Builder или другом редакторе скриптов, без необходимости начала новой игры. Все, что требуется для добавления такого скрипта в игру, - это поместить его в папку CLEO. Cкрипт начнет работу после начала игры. Для удаления скрипта из игры - удалите соответствующий файл.
Все скрипты написаны фанатами игры и не имеют отношения к разработчикам CLEO. Хотя сама библиотека CLEO должна работать с различными версиями игры, отдельные скрипты могут иметь собственные ограничения и требования к файлам игры. По вопросам работоспособности конкретного скрипта обращайтесь к его автору.
Опкоды
CLEO 4 добавляет в игру 100 новых скриптовых команд, которые позволяют работать с внешними файлами, изменять данные в памяти игры, вызывать игровые функции со своими параметрами, а также многое другое.
В четвертой версии появились новые команды для работы со звуками, строками, была добавлена возможность выводить на экран текст без использования внешних файлов (.gxt, .fxt). Чтобы оценить новые достижения и использовать их в ваших скриптах, установите последнюю версию библиотеки CLEO 4.
Плагины
CLEO-плагины - это обычные DLL-файлы, но имеющие расширение .CLEO. При запуске библиотека CLEO ищет в папке CLEO файлы с данным расширением и пытается загрузить их. В случае удачной загрузки плагин начинает работать и выполнять те функции, для которых он написан.
CLEO 4 позволяет создавать новые опкоды, используя исходные коды CLEO SDK. В стартовом комплекте библиотеки можно найти три примера таких плагинов.
Плагины устанавливаются и удаляются также как и скрипты. Список доступных плагинов можно найти на этой странице.
Установка
СLEO 4 распространяется в виде автоматического инсталлятора. Для установки библиотеки запустите инсталлятор и следуйте его инструкциям.
CLEO 4.3 поддерживает три версии игры GTA San Andreas: 1.0, 1.01, 3.0 (steam).
CLEO требует установки ASI Loader, который идет совместно с библиотекой. ASI Loader - это программа, которая автоматически загружает файлы с расширением .asi при старте игры. ASI Loader заменяет один из оригинальных файлов игры 'vorbisFile.dll' собственным, поэтому убедитесь, что вы сделали копию этого файла.
Другие файлы игры не заменяются, однако добавляются следующие файлы и папки:
- cleo\ (папка CLEO, в которую копируются все скрипты и плагины)
- cleo\FileSystemOperations.cleo (плагин для работы с файлами)
- cleo\IniFiles.cleo (плагин для работы с INI)
- cleo\IntOperations.cleo (плагин для работы с целыми числами на уровне битов)
- cleo\cleo_save\ (папка сохранений CLEO)
- cleo.asi (ядро библиотеки CLEO)
- bass.dll (библиотека для работы с аудио)
- vorbisHooked.dll (Silent's ASI Loader)
Все плагины опциональны, но их функционал может быть использован различными CLEO скриптами.
CLEO 4 для San Andreas для проигрывания звуковых файлов требует установленной библиотеки BASS.dll версии 2.4, которую можно скачать с официального сайта Un4seen Developments Ltd.
Совместимость с CLEO 3
CLEO постоянно улучшается и расширяется с течением времени. В очень редких случаях некоторые скрипты, написанные для CLEO 3, могут не работать с CLEO 4. Начиная с CLEO 4.3, вы можете включить специальный режим совместимости для скриптов CLEO 3. Для этого измените расширение файла скрипта (обычно это '.cs') на '.cs3'. CLEO 4.3 будет работать с такими скриптами в особом режиме, который включает в себя изменение поведения некоторых скриптовых команд. В тоже время в абсолютном большинстве случаев скрипты CLEO 3 работают с CLEO 4 без каких-либо проблем, и использование режима совместимости не требуется.
Fdnjhs
Автор и первоначальный разработчик библиотеки CLEO - Seemann.
Разработчики не имеют отношения к Take 2 Interactive или Rockstar Games и не несут никакой ответственности за возможные негативные последствия, вызванные использованием данного продукта или любых других продуктов, распространяемых вместе с библиотекой. Используйте его на свой страх и риск.
В CLEO 4.3 используется ASI Loader от Silent.
Информацию об изменениях в версии 4.3 и более подробное описание возможностей CLEO можно найти в readme-файлах, которые идут в комплекте с библиотекой.
Благодарности
Станиславу Головину (a.k.a. listener) - за огромный труд в исследовании игр GTA.
mfisto - за альфа-тестинг библиотеки CLEO 4, советы и поддержку
NTAuthority и LINK/2012 - за помощь с CLEO 4.3.
CLEO 4
--------------------
Change Log
-- 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 --
* 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