GOM引擎MOV INC DEC脚本教程 - 角色变量读写与跨对象赋值调试

MOV、INC、DEC是GOM引擎核心变量操作命令，主要用于实现脚本内变量赋值、数值递增、数值递减，是搭建各类自定义玩法脚本的基础核心指令。

该系列命令完美适配全系GOM引擎版本，仅用于本地脚本技术研究、单机版本功能测试与变量调试学习场景，适配零基础脚本学习者落地实操。

熟练掌握这三组命令可解决脚本变量赋值失效、跨对象数据传递失败、数值增减异常等常见问题，快速完成各类自定义玩法的变量逻辑搭建，也是做好传奇脚本定制、玩法开发的核心基础能力。

命令原理

GOM引擎中MOV、INC、DEC三条命令各司其职，共同构成脚本变量数值的基础操控体系，所有操作均支持普通变量与当前对象专属变量。

MOV为赋值命令，核心作用是给指定变量赋予固定值或其他变量的数值，覆盖变量原有数据，是变量初始化、数据传递的核心指令。

INC为递增命令，用于对目标变量数值进行累加操作，无需重复赋值，简化数值叠加类脚本逻辑编写。

DEC为递减命令，用于对目标变量数值进行累减操作，适配数值消耗、次数扣除等功能场景。

同时引擎专属C.常量与CSTR变量机制，支持跨对象（攻击目标、当前选中对象）的数据读写，解决常规变量无法跨角色传值的痛点。

命令格式

三组变量操作命令拥有固定标准格式，零基础用户可直接套用，格式无自定义修改空间，严格遵循引擎语法规则。

1、MOV赋值标准格式：MOV 目标变量 赋值内容/源变量

2、INC递增标准格式：INC 目标变量 递增数值（默认+1，可省略数值）

3、DEC递减标准格式：DEC 目标变量 递减数值（默认-1，可省略数值）

4、跨对象变量操作格式：MOV <$CSTR(变量名)> <$STR(源变量名)>

完整合规实操示例（基础赋值）：

#ACT
MOV S1 100
INC S1 10
DEC S1 5
SENDMSG 6 变量S1最终数值为：<$STR(S1)>

参数详解与基础场景

本次核心参数分为基础变量参数、跨对象常量参数、跨对象变量参数三类，所有参数适配GOM引擎本地调试场景，具体释义与用法如下。

基础适用场景：角色数据初始化、单次数值增减、自身变量数据记录、目标对象属性读取展示，适配绝大多数版本调试与自定义功能开发场景。

三阶拓展案例

初级入门案例（零基础套用）

实现角色上线初始化变量，固定基础数值，新手直接复制即可完成本地测试。

[@Login]
#IF
#ACT
MOV S1 0
MOV N1 1
SENDMSG 6 上线变量初始化完成，S1=<$STR(S1)>，N1=<$STR(N1)>

案例说明：角色登录自动清空S1变量、初始化N1为1，完成基础变量初始化，适配所有新手入门调试。

中级优化案例（功能升级调试）

结合攻击触发，实现敌我变量双向传递，攻击目标同步读取自身变量数据，实现互动数据联动。

[@Attack]
#IF
CHECKCURRTARGETRACE = 0
#ACT
MOV <$CSTR(S1)> <$STR(S1)>
MOV <$STR(N1)> <$CSTR(N1)>
SENDMSG 6 已同步目标【<$C.USERNAME>】变量数据
BREAK

案例说明：攻击人物目标时，将自身S1变量传递给目标，同时读取目标N1变量到自身，完成双向数据同步。

高阶定制案例（自定义玩法修改）

通过SetCurrTarget指定对象，精准操控目标变量，实现指定角色数据赋值与数值增减，适配定制玩法开发。

[@main]
#IF
#ACT
MOV S1 测试人物
SetCurrTarget S1
#IF
CompareText <$C.USERNAME> S1
#ACT
MOV <$CSTR(S1)> <$STR(S1)>
INC <$CSTR(N1)> 5
SENDMSG 6 目标名称：<$C.USERNAME>，目标N1数值：<$CSTR(N1)>

案例说明：手动指定目标对象后，单独对目标变量进行赋值、递增操作，脱离固定触发场景，灵活定制玩法逻辑。

零基础实操步骤

本次实操全程零跳过，适配GOM引擎本地测试版本，新手照搬即可落地生效，所有操作仅限单机学习调试。

第一步：打开GOM引擎版本调试工具，找到脚本文件夹下的QFunction-0.txt全局功能脚本文件。

第二步：根据需求对应触发标签，将上述案例代码复制粘贴至对应触发段内，覆盖原有测试代码。

第三步：严格将脚本编码保存为ANSI格式，避免脚本乱码、命令失效问题，保存文件后关闭编辑器。

第四步：在引擎版本管理面板中，执行脚本重载操作，无需重启本地服务端，快速生效脚本逻辑。

第五步：进入本地测试版本，通过对应操作（登录、攻击、执行命令）测试变量赋值、增减、传值功能是否正常。

第六步：查看游戏聊天框输出数据，核对变量数值，完成功能调试与参数微调。

新手避坑指南

新手实操MOV、INC、DEC命令时，极易出现变量失效、传值错误、数值异常等问题，核心避坑要点如下。

1、严格区分CSTR变量与普通STR变量，CSTR仅用于当前目标对象，自身变量无需添加C前缀，混用会导致赋值失效。

2、INC、DEC命令省略数值时，默认单次增减1，如需大额数值修改，必须手动填写具体增减数值，避免数值偏差。

3、所有脚本文件必须保存为ANSI编码格式，UTF-8格式会直接导致引擎无法识别命令，出现脚本无响应、乱码问题。

4、跨对象操作必须依托有效触发场景（攻击、选中目标），无目标对象时使用CSTR、C.常量会出现空值报错。

5、MOV赋值会直接覆盖原有变量数据，如需保留原始数值，禁止直接覆盖，需通过中间变量过渡存储。

报错修复

问题现象一：变量赋值无反应，聊天框无输出数据

核心成因：脚本未重载、编码格式错误、触发标签不匹配，引擎未读取到最新脚本指令。

分步排查：首先检查脚本保存编码是否为ANSI，其次确认是否执行脚本重载，最后核对代码是否放入正确触发标签。

修复方案：重新保存脚本为ANSI格式，在版本管理面板重载全部脚本，将代码迁移至对应功能触发段内。

问题现象二：跨对象CSTR赋值失效，目标变量无变化

核心成因：无有效当前操作对象，未成功锁定目标，导致跨对象变量操作无执行载体。

分步排查：检查是否通过攻击、SetCurrTarget指令成功选中目标，核对CSTR变量名称与自定义变量名称一致。

修复方案：操作前添加目标检测语句，确保存在有效对象，再执行跨变量赋值、增减命令。

问题现象三：INC/DEC数值增减异常

核心成因：变量初始为空值，无基础数值，引擎无法对空值执行加减运算，导致命令失效。

分步排查：检测变量是否提前通过MOV完成初始化，查看变量是否存在数值覆盖、清空的前置操作。

修复方案：数值增减前，先用MOV命令给变量赋予初始值，确保变量存在有效数值后再执行运算。

FAQ高频问答

Q1：MOV命令赋值后变量不更新是什么原因？

A1：大概率是脚本未重载、编码错误或存在后置清空变量代码，优先重载脚本、核对ANSI编码，排查后续变量重置语句即可修复。

Q2：CSTR和普通STR变量的核心区别是什么？

A2：STR是当前自身角色变量，CSTR是当前选中/攻击目标对象的变量，专门用于跨角色数据传递，仅限目标对象操作场景使用。

Q3：INC、DEC不填写数值会生效吗？

A3：会生效，无数值参数时，引擎默认单次递增1、递减1，适合次数统计、简单数值叠加场景。

Q4：哪些触发场景支持C.常量和CSTR变量操作？

A4：攻击触发、被攻击触发、死亡触发、角色信息查看、自定义选中目标场景均支持，无目标场景无法使用。

Q5：跨对象传值失败，如何快速检测目标是否生效？

A5：添加【CompareText <$C.USERNAME> 空】检测语句，判断是否存在目标对象，结合SENDMSG输出提示排查问题。

Q6：变量数值被莫名清空该怎么排查？

A6：全局检索同名变量的MOV清空语句、角色登录重置脚本，多数为前置初始化代码覆盖了自定义数值。

全文总结

MOV、INC、DEC变量操作命令是GOM引擎脚本开发的基础核心指令，分别承担变量赋值、数值递增、数值递减的核心作用。

搭配引擎专属C.常量、CSTR跨对象变量机制，可实现自身变量操控与跨角色数据传递，适配绝大多数自定义玩法脚本开发。

本次教程所有代码、步骤均适配GOM引擎本地学习调试场景，零基础用户可直接照搬实操，规避变量赋值失效、传值异常等高频问题，快速掌握脚本变量核心操作逻辑。