CLEO Library - CLEO 5 - 圣安地列斯 - GTAMODX
圣安地列斯•更新于 2026年5月25日
CLEO Library - CLEO 5
一个适用于GTASA的CLEO脚本库
描述
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 Library - CLEO 5
38 下载51 点赞
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 。
支持
SA.CLEO-v5.4.0.zip
Main记得先安装前置MOD
MD5: 2705380ceead95694e261fa231d402f4 SA.CLEO_SDK-v5.4.0.zip
Optional开发人员使用的SDK,可用于编写.cleo插件,玩家不要下载
MD5: fe4e798703886547d5c6e86682511f91 MD5: 1d96dc597fed10b5495d7da0883a2b50