描述
CLEO Library 或称CLEO库、CLEO主程序，它是一种脚本库，它允许玩家在不对任何游戏文件进行修改的情况下，在GTA游戏中运行自定义脚本（这类脚本叫做CLEO脚本，通常是以.cs为后缀的文件）。
CLEO库不是CLEO脚本，但是所有CLEO脚本都需要依赖于CLEO库存在，它的作用是加载并执行CLEO脚本。简单说就是如果没有它，CLEO脚本根本不会生效。
CLEO 5
针对不同的GTA游戏，有几种不同的CLEO版本可供使用，对于GTASA，目前最新为第五代CLEO，版本号从 5.0.0 开始，我们也可以叫它 CLEO 5 。
CLEO 5 基于 CLEO 4 最后一个版本 4.4.4 更新，由 CLEO之父 - Seemann 和 Miran 在2024年8月创建。CLEO 5 功能非常强大和激进，修复了 CLEO 4 中的各种问题，进行了大量的优化和改进，同时增加了部分新的 Opcode 。CLEO 5 可以对CLEO脚本进行调试，提供了断点、监控、记录、打印 Opcode 等 Debug 功能。
CLEO 5 几乎完全向下兼容 CLEO 4 ，简单说它就是 CLEO 4 继续更新的版本，目前它非常稳定，强烈建议使用 CLEO 5 。
CLEO 4
CLEO 4 的最后一个版本为 4.4.4 ，虽然不在推荐使用，但仍然提供下载，在某些极端情况下，使用 CLEO 4 是有必要的。
安装
支持的游戏版本
CLEO库并非支持所有游戏版本，取决于可执行文件（.exe）的版本。部分支持的游戏版本不推荐使用，可能会出现兼容性问题，缺少部分功能。
完全支持：
- GTA SA 1.0 US (美版)
- GTA SA 1.0 EU (欧版)
部分支持：
- GTA SA 1.01 EU（欧版）
- GTA SA 3.0 Steam
在 圣安地列斯（GTASA）中安装
下载该插件并解压，请将解压后的所有文件放入游戏的主目录中（你的游戏安装目录，也就是gta_sa.exe文件所在的文件夹）。 解压后的文件如下：
- CLEO.asi - 主程序
- bass.dll - 音频引擎库
- cleo\ - 存放CLEO脚本的文件夹
- cleo.config\enums.json - Opcode参数的枚举文件
- cleo.config\sa.json - Opcode信息文件
- cleo\cleo_plugins\SA.Audio.cleo - 由bass.dll库提供支持的音频播放Opcode插件
- cleo\cleo_plugins\SA.DebugUtils.cleo – 用于脚本调试的Opcode插件
- cleo\cleo_plugins\SA.FileSystemOperations.cleo - 文件操作相关功能的Opcode插件
- cleo\cleo_plugins\SA.GameEntities.cleo – 与cars/peds/objects/pickups相关的Opcode插件
- cleo\cleo_plugins\SA.IniFiles.cleo - 用于处理配置.ini文件的Opcode插件
- cleo\cleo_plugins\SA.Input.cleo – 与键盘/鼠标输入相关的Opcode插件
- cleo\cleo_plugins\SA.Math.cleo – 用于实现更多数学运算功能的Opcode插件
- cleo\cleo_plugins\SA.MemoryOperations.cleo – 用于处理内存相关和.dll库的Opcode插件
- cleo\cleo_plugins\SA.Text.cleo – 用于文本处理和屏幕绘制的Opcode插件
- cleo\cleo_saves\ - CLEO保存文件的存放目录
- cleo\cleo_text\ - CLEO文本文件.fxt的存放目录
- cleo\cleo_modules\ - CLEO模块目录
- cleo_readme\ - 存放说明文件的文件夹，无需安装
所有插件都是可选的，不过某些CLEO脚本可能会要求使用这些插件。
只要在游戏主菜单的左下角能看到新出现的文字，那就说明CLEO库安装成功了。从最终玩家的角度来看，CLEO库本身并不会对游戏玩法进行任何修改或扩展，因此也不存在所谓的“CLEO菜单”。新的功能都是通过其它作者编写的CLEO脚本来实现的。
使用
安装好CLEO库后，你可以将任何你从其它地方下载的各种CLEO脚本放入 cleo\ 文件夹中，打开游戏读条完毕后CLEO脚本就会生效。（详情请查看各CLEO脚本的使用说明）
兼容模式
CLEO库会随着时间的推移不断进行改进和升级。在极少数情况下，新的版本可能会破坏一些旧版本的脚本功能。为了解决这个问题，CLEO提供了 兼容模式 ，该模式可以模拟旧版本的行为，从而确保旧脚本的稳定性不受影响。
若想让CLEO脚本以 CLEO 4 兼容，请将脚本的后缀名从 .cs 改为 .cs4 。
若想让CLEO脚本以 CLEO 3 兼容，请将脚本的后缀名从 .cs 改为 .cs3 。
关于
历史
最初，《圣安地列斯》的CLEO库由 Seemann（x87） 在2007年创建，他也是CLEO脚本编写工具 Sanny Builder 的作者，毫无疑问，伟大的 Seemann 是当之无愧的 CLEO 之父 。Seemann 陆续编写并发布了 CLEO 1 、 CLEO 2 、 CLEO 3 ，在社区取得了巨大反响，CLEO因此开始流行。令人震惊的是，最初的 CLEO 1 只是一个 main.scm 脚本，但它的实现非常复杂且低级。而 CLEO 2 和 CLEO 3 则使用 Pascal 语言编写，也正式标志着CLEO库开始由高级的现代编程语言开发。之后 Seemann 因为个人原因暂时退出圈子，CLEO库的更新暂时停止。但随着GTA MOD越来越热门，越来越多玩家前赴后继学习、制作各种类型的MOD，又一位伟大的GTA MOD大佬 Dk22pac 在此时发布了GTA游戏的逆向工程项目 plugin sdk ，帮助了越来越多的人学会制作MOD。于是在2013年前后，社区的 Alien 和 Deji 两位大佬在 CLEO3 的基础上，基于 plugin sdk 项目使用 C++ 语言从头编写并发布了第四代版本的CLEO库，也就是我们熟知的 CLEO 4 。CLEO 4 也是流行时间最长、最稳定、最火热的一个CLEO版本，无数CLEO脚本因此诞生，很多玩家开始学习编写CLEO脚本，各种CLEO脚本编写教程和各种功能的CLEO脚本发布，CLEO几乎成为玩家必装的玩法和实用性MOD，它已经在MOD社区掀起了一个巅峰的热潮。但2017年以后，GTA MOD开始热度降低，各种玩家也开始逐渐退出，一个时代终将落幕，CLEO 4 的更新同样因此停滞不前，但随着CLEO最初的作者 Seemann 的回归，CLEO 4 也在此时开源。2020年以后，在 JuniorDjjr 和 Miran 等人的短暂维护更新后，到2023年8月，CLEO 4 的最后一个版本 4.4.4 发布，第四代CLEO库划上了一个完美的句号，陪伴无数人的 CLEO 4 终于彻底停止更新。但 Seemann 此时也宣布，第五代CLEO诞生，并在一年后发布了 CLEO 5 的第一个 beta 版，在 Seemann 和 Miran 等开发组众人的努力下，没过多久，正式版的 CLEO 5 终于问世。而随着 Sanny Builder 4 工具和 Sanny Builder Library 的更新，时至今日，CLEO仍然在面向更强大、更稳定、更现代的道路上前进......
本人贺兰娆娆（XMDS）已经加入CLEO库的开发团队，能够为CLEO库项目进行维护和更新，如有任何安装和使用问题请在评论区留言。想参与维护者或者bug反馈、功能支持请移步到 github 。
哈哈，这也算是“官方”转载吧......
支持
开源：https://github.com/cleolibrary/CLEO5
CLEO官网：https://cleo.li/
Sanny Builder官网：https://sannybuilder.com/
SBL：https://library.sannybuilder.com/
