一、传奇脚本变量核心定义 一键端适配特性
传奇脚本变量是脚本中用于存储、调用动态数据的核心元素，本质是可变化的数值或字符串容器，能根据游戏行为实时更新数据，实现脚本逻辑的灵活触发。数字变量作为最常用类型，仅存储数值数据，广泛应用于计数、条件判定、属性关联等场景。
传奇一键端因集成预设配置，其脚本变量具有兼容性强、调用简洁的特性，无需手动配置数据库关联，多数变量可直接在脚本中定义使用，适配主流一键端引擎。变量核心作用是打破固定脚本逻辑，让同一脚本根据不同数据状态执行不同操作，例如记录击杀次数、统计任务进度、绑定角色属性等。
二、脚本变量核心分类 数字变量为主
2.1 按作用范围分类
局部变量：仅在当前脚本片段或触发事件中生效，脚本执行结束后数据自动清除，不残留记录。常见于单次任务、临时交互场景，例如拾取道具时的临时计数，格式多为$LOCAL(X)$（X为变量序号），一键端中无需额外声明，直接调用即可。
全局变量：全服务端通用，数据永久存储（直至手动清除或服务端重启），可跨脚本、跨角色调用。适合记录全服数据，如全服BOSS刷新次数、活动开启状态，格式常用$GLOBAL(X)$。一键端中全局变量需在指定配置文件中初始化，避免数据冲突。
角色变量：绑定单个角色，仅对该角色生效，角色下线后数据保留，重新登录可继续调用。核心用于记录角色专属数据，如个人任务进度、已使用道具次数、专属属性加成，格式为$HUMAN(变量名)$，是一键端中最常用的变量类型，适配角色成长、专属玩法场景。
2.2 数字变量的核心特性
数字变量仅支持整数数值存储，不可存储字符串、符号等内容，取值范围适配引擎设定，多数一键端支持0-999999的数值区间。其核心特性为可运算性，支持加减乘除等基础运算，可通过脚本命令实现数值增减、对比，是条件判定的核心依据。
补充：一键端中部分数字变量为系统预设，无需手动定义即可调用，如$HUMAN(LEVEL)$（角色等级）、$HUMAN(GOLD)$（角色金币数量），直接嵌入脚本即可实现等级、金币相关的条件判定。
三、数字变量在一键端脚本中的核心用法 实操案例
3.1 计数功能 记录行为次数
功能目标：记录角色击杀指定怪物次数，达到设定数值后给予奖励，适配一键端日常任务场景。
脚本代码示例：
#IF
CHECKMONSTERDEAD 半兽人（检测击杀半兽人）
#ACT
SETVAR HUMAN KillOrc $HUMAN(KillOrc)+1（击杀次数+1）
#IF
CHECKVAR HUMAN KillOrc >= 10（检测次数≥10）
#ACT
GIVE 金创药 5（给予奖励）
SETVAR HUMAN KillOrc 0（重置计数）
#MESSAGEBOX
击杀10只半兽人，获得奖励！
解析：通过SETVAR命令实现数字变量增减，CHECKVAR命令判定数值条件，完成计数与奖励发放的闭环。一键端中无需配置数据库，直接调用角色变量$HUMAN(KillOrc)$即可实现数据存储。
3.2 条件判定 关联数值触发逻辑
功能目标：角色金币数量达到指定数值，可兑换专属道具，通过数字变量实现金额校验。
脚本代码示例：
#IF
CHECKVAR HUMAN(GOLD) >= 1000（检测金币≥1000）
#SAY
消耗1000金币可兑换强化矿石1个，是否确认？
#ACT
GAMEGOLD - 1000（扣除金币）
GIVE 强化矿石 1
#MESSAGEBOX
兑换成功！
#ELSESAY
金币不足1000，无法兑换。
解析：调用系统预设数字变量$HUMAN(GOLD)$，通过数值对比判定是否满足兑换条件，无需手动定义变量，适配一键端快速配置需求。
3.3 属性关联 动态调整角色数值
功能目标：通过数字变量记录角色临时属性加成，持续指定时长后重置，适配buff类玩法。
脚本代码示例：
#ACT
SETVAR HUMAN AtkAdd 5（设置攻击加成+5）
MODIFYHUMANATTR 攻击 5（提升攻击）
@SetTimer 1 30000（设置30秒定时器）
#TIMER(1)
#ACT
MODIFYHUMANATTR 攻击 -5（取消加成）
SETVAR HUMAN AtkAdd 0（重置变量）
#MESSAGEBOX
临时攻击加成已失效。
解析：数字变量$HUMAN(AtkAdd)$记录加成数值，搭配定时器实现属性动态调整，脚本逻辑简洁，无需复杂配置，适配一键端快速搭建buff玩法。
四、一键端变量脚本编写 核心命令与注意事项
4.1 常用核心命令
变量赋值命令：SETVAR，格式为SETVAR 变量类型 变量名 数值/运算式，如SETVAR HUMAN Task 1（给角色变量Task赋值1）、SETVAR HUMAN Count $HUMAN(Count)+2（变量值+2）。
变量判定命令：CHECKVAR，格式为CHECKVAR 变量类型 变量名 判定符 数值，如CHECKVAR GLOBAL BossCount = 0（判定全局变量BossCount为0）。
变量清除命令：CLEARVAR，格式为CLEARVAR 变量类型 变量名，如CLEARVAR LOCAL Temp（清除局部变量Temp），一键端中局部变量可省略清除，脚本结束自动失效。
4.2 一键端适配要点
1. 变量命名规范：避免使用特殊符号、中文，优先用英文或数字组合，如$HUMAN(Task1)$，防止一键端引擎无法识别；2. 预设变量调用：优先使用一键端系统预设变量，无需手动定义，减少脚本错误，常见预设变量包括角色等级、金币、经验、背包容量等；3. 数据存储：角色变量、全局变量需确保服务端开启数据存储功能，避免角色下线或服务端重启后数据丢失。
五、常见问题排查 变量脚本运行异常
5.1 变量数值不更新
核心原因：1. 命令格式错误，如SETVAR命令遗漏变量类型，需明确标注HUMAN/GLOBAL/LOCAL；2. 变量名重复，同一角色变量不可重复命名，避免数据覆盖；3. 脚本未重载，修改变量脚本后需输入@reloadquest 脚本名，确保命令生效。
5.2 条件判定失效
多为判定符使用错误，如将“≥”误写为“>=”以外的符号，需严格遵循引擎命令格式；同时检查变量数值类型，数字变量仅支持整数对比，不可与字符串混合判定。一键端中可通过#MESSAGEBOX输出变量数值，排查数值是否符合预期。
5.3 变量跨脚本调用失败
仅全局变量支持跨脚本调用，角色变量、局部变量无法跨脚本使用，需更换变量类型；同时确保全局变量在配置文件中初始化，一键端中全局变量初始化文件通常位于Envir/QuestDiary文件夹下，按格式添加变量名与初始值即可。
六、通用用法提示 新手适配一键端
新手优先使用角色变量搭建基础脚本，熟悉赋值、判定命令后再尝试全局变量，降低操作难度。一键端中多数预设玩法已集成变量脚本，可直接参考自带脚本的变量用法，复制修改核心命令快速适配自定义需求。
编写变量脚本时，建议分步测试，先实现基础赋值与判定功能，再添加奖励、属性调整等复杂逻辑，避免一次性添加过多功能导致排查困难。同时备份脚本文件，若变量配置错误可快速恢复原始版本，确保游戏正常运行。
