自定义脚本 / CLEO / SA - GTAMODX开发文档

sa · 扩展 CLEO · 需 CLEO

启动 / 结束自定义脚本、CLEO_CALL、共享变量。

写法见 Lua / Redux。

启动自定义脚本

STREAM_CUSTOM_SCRIPT · 0A92

加载指定路径编译 SCM，启动一条自定义脚本。可跟变长参数。

0A92 STREAM_CUSTOM_SCRIPT
in: scriptFileName, args...

TERMINATE_THIS_CUSTOM_SCRIPT · 0A93

结束当前自定义脚本。

0A93 TERMINATE_THIS_CUSTOM_SCRIPT

LOAD_AND_LAUNCH_CUSTOM_MISSION · 0A94

加载并启动 CLEO 自定义任务（.cm）。成功则条件为真。

0A94 LOAD_AND_LAUNCH_CUSTOM_MISSION
in: scriptFileName, args...

SAVE_THIS_CUSTOM_SCRIPT · 0A95

标记本脚本随存档保存；读档后从保存点继续。

0A95 SAVE_THIS_CUSTOM_SCRIPT

TERMINATE_ALL_CUSTOM_SCRIPTS_WITH_THIS_NAME · 0ABA

结束所有指定名字的自定义脚本并释放内存。

0ABA TERMINATE_ALL_CUSTOM_SCRIPTS_WITH_THIS_NAME
in: name

CLEO_CALL · 0AB1

调用 SCM 子程序并传参；可用 0AB2 / 2002 / 2003 返回。

0AB1 CLEO_CALL
in: label, numArgs, args...

CLEO_RETURN · 0AB2

从 CLEO_CALL 返回，可带回返回值。

0AB2 CLEO_RETURN
in: numRet, retParams...

SET_CLEO_SHARED_VAR · 0AB3

写全局共享变量，全脚本可见。index 0–1023。

0AB3 SET_CLEO_SHARED_VAR
in: index, value

GET_CLEO_SHARED_VAR · 0AB4

读全局共享变量（0–1023）。

0AB4 GET_CLEO_SHARED_VAR
in: index
out: result

GET_CLEO_ARG_COUNT · 2000

当前 CLEO_CALL 实际传入参数个数。

2000 GET_CLEO_ARG_COUNT
out: count

CLEO_RETURN_WITH · 2002

从 0AB1 返回并强制设置条件结果。

2002 CLEO_RETURN_WITH
in: conditionResult, retArgs...

CLEO_RETURN_FAIL · 2003

返回且条件为假，并跳过调用侧接收返回值的变量。

2003 CLEO_RETURN_FAIL
in: args...

GOSUB_IF_FALSE · 0AA0

条件为假时 GOSUB 进子程序。

0AA0 GOSUB_IF_FALSE
in: label

RETURN_IF_FALSE · 0AA1

条件为假时从当前子程序返回。

0AA1 RETURN_IF_FALSE