一、传奇脚本核心逻辑：#IF与#ACT的基础框架
传奇脚本的执行核心围绕“条件判断-动作触发”展开，#IF（条件判断标识）与#ACT（动作执行标识）是构建脚本的基础指令对。#IF后紧跟具体检测条件，如角色等级、货币数量等；当条件满足时，#ACT后的代码块将自动执行；条件不满足时，可通过#ELSE定义备用操作，形成完整逻辑闭环。
基础框架示例：
#IF//条件判断开始
CheckGameGold>99//检测元宝数量大于99个
#ACT//条件满足时执行
GiveItem(强效金疮药10)//发放10个强效金疮药
ReduceGameGold100//扣除100个元宝
SystemMsg(消耗100元宝，兑换10个强效金疮药成功)
#ELSE//条件不满足时执行
SystemMsg(元宝不足100，无法兑换)
BREAK//终止脚本执行
上述代码实现“元宝兑换药品”的基础功能，通过明确的条件与动作对应，确保脚本逻辑清晰可执行，是所有复杂脚本的编写基础。
二、高频核心命令分类：检测条件与执行动作大全
脚本命令按功能可分为“检测类”与“执行类”，检测类命令用于#IF后判断触发条件，执行类命令用于#ACT后实现具体功能，以下为开发中最常用的命令集合。
1.货币检测与操作命令：经济系统核心
货币相关命令用于付费功能、道具兑换等场景，支持“大于、小于、等于”等逻辑判断，适配元宝与金币两种核心货币。
-元宝检测（CheckGameGold）：判断角色持有元宝数量，语法为“CheckGameGold比较符数值”，比较符支持>、<、=、>=、<=。
示例：#IFCheckGameGold>=500//检测元宝数量≥500个
-金币检测（CheckGold）：判断角色持有金币数量，语法与元宝检测一致，金币单位为“个”，10000金币等同于1元宝。
示例：#IFCheckGold>100000//检测金币数量大于10万
-元宝操作（ReduceGameGold/AddGameGold）：分别对应扣除与增加元宝，语法为“命令数值”。
示例：ReduceGameGold500//扣除500元宝；AddGameGold100//增加100元宝
-金币操作（ReduceGold/AddGold）：分别对应扣除与增加金币，语法为“命令数值”。
示例：ReduceGold100000//扣除10万金币；AddGold50000//增加5万金币
2.物品检测与操作命令：道具系统核心
物品相关命令涵盖背包持有、装备佩戴、数量判断等场景，是任务提交、装备合成、套装特效的核心实现工具。
-背包物品检测（CheckItem）：判断背包内指定物品数量，语法为“CheckItem物品名称/ID比较符数量”，不写数量默认检测是否持有。
示例：#IFCheckItem沃玛号角=1//检测背包内有1个沃玛号角
-装备佩戴检测（CheckItemW）：判断角色是否佩戴指定装备，“W”代表Wear（佩戴），语法为“CheckItemW装备名称/ID”。
示例：#IFCheckItemW圣战头盔//检测是否佩戴圣战头盔
-物品数量范围检测（CheckItemCount）：判断物品数量是否在指定区间，语法为“CheckItemCount物品ID最小数量最大数量”。
示例：#IFCheckItemCount祝福油310//检测祝福油数量在3-10之间
-物品操作（GiveItem/ReduceItem）：分别对应发放与扣除物品，语法为“命令物品名称/ID数量”。
示例：GiveItem屠龙刀1//发放1把屠龙刀；ReduceItem祝福油3//扣除3个祝福油
-物品合成（SynthesisItem）：实现多材料合成目标物品，语法为“SynthesisItem目标物品数量”。
示例：SynthesisItem超级祝福油1//合成1个超级祝福油
3.角色属性检测与操作命令：角色系统核心
针对职业、等级、转生等基础属性的命令，用于实现职业专属功能、等级门槛限制、转生福利等个性化需求。
-职业检测（Job）：判断角色职业，语法为“Job职业名称”，支持战士、法师、道士三类基础职业。
示例：#IFJob法师//仅法师职业可触发后续动作
-等级检测（Level）：判断角色等级，语法为“Level比较符等级数值”。
示例：#IFLevel>=35//检测角色等级≥35级
-转生检测（CheckReborn）：判断角色转生次数，语法为“CheckReborn比较符转次数值”，无转生为0。
示例：#IFCheckReborn>=2//检测转生次数≥2次
-属性操作（AddAttr/AddExp）：AddAttr用于增加角色属性，语法为“AddAttr属性名称数值”；AddExp用于增加经验，语法为“AddExp经验值”。
示例：AddAttr攻击5//攻击属性+5；AddExp50000//增加5万经验
-技能解锁（UnlockSkill）：为角色解锁指定技能，语法为“UnlockSkill技能名称”。
示例：UnlockSkill冰咆哮//为法师解锁冰咆哮技能
4.任务与状态检测命令：场景化触发核心
用于检测任务进度、会员身份、自定义状态等，实现脚本的场景化精准触发，提升交互体验。
-任务状态检测（CheckTaskStatus）：判断任务所处阶段，语法为“CheckTaskStatus任务名称状态”，状态支持未接、已接、完成。
示例：#IFCheckTaskStatus击败沃玛教主完成//检测任务已完成
-会员身份检测（CheckMem）：判断会员等级，语法为“CheckMem会员等级”，0为非会员，1及以上为对应VIP等级。
示例：#IFCheckMem1//检测角色为VIP1会员
-状态标记检测与设置（CheckFlag/SetFlag）：用于自定义状态判断与标记，语法分别为“CheckFlag标记名称标记值”“SetFlag标记名称标记值”。
示例：#IFCheckFlag新手引导0//检测新手引导未完成；SetFlag新手引导1//标记引导已完成
5.场景与交互命令：体验优化核心
用于实现地图传送、消息提示、功能开启等交互功能，提升脚本的实用性与玩家体验。
-地图传送（MapMove）：将角色传送至指定地图坐标，语法为“MapMove地图名称X坐标Y坐标”。
示例：MapMove转生地图100100//传送至转生地图（100100）坐标
-系统消息（SystemMsg）：向角色发送系统提示，语法为“SystemMsg提示内容”。
示例：SystemMsg转生等级达标，已传送至专属地图
-功能开启（OpenGuildCreate/OpenGuide）：分别对应开启创建行会功能与新手引导，语法为“命令引导步骤（可选）”。
示例：OpenGuildCreate//开启创建行会功能；OpenGuide1//开启第一步新手引导
-对话输出（#SAY）：向角色展示对话内容并提供功能按钮，语法为“#SAY对话内容\<按钮文本/@功能标识\>”。
示例：#SAY元宝不足，无法兑换！\<返回/@main\>
三、实战脚本案例：命令组合应用示范
脚本编写的核心是命令的灵活组合，以下通过两个高频场景案例，展示命令的实际应用逻辑。
案例1：元宝兑换经验（付费功能场景）
需求：角色消耗200元宝兑换100万经验，元宝不足或每日兑换次数用尽时提示对应信息，每日限1次。
(@元宝换经验)
#IF
CheckGameGold>=200//检测元宝≥200个
CheckFlag元宝换经验0//检测今日未兑换（标记值0）
#ACT
ReduceGameGold200//扣除200元宝
AddExp1000000//增加100万经验
SetFlag元宝换经验1//标记今日已兑换
SystemMsg(200元宝兑换100万经验成功，今日兑换已完成)
#ELSE
#IF
CheckFlag元宝换经验1//检测今日已兑换
#SAY
今日元宝兑换经验次数已用完，明日再来尝试吧！\
<返回/@main>
#ELSE
#SAY
元宝不足200，无法兑换100万经验。\
请先充值或通过其他途径获取元宝。\
<返回/@main>
BREAK
逻辑拆解：通过“元宝检测+每日标记检测”实现兑换限制，#ELSE分支细分两种失败场景，用#SAY提供清晰引导，提升交互体验。
案例2：装备合成（材料组合场景）
需求：3个金矿+1个银矿+50万金币合成1个金砖，缺少材料时精准提示缺失项。
(@合成金砖)
#IF
CheckItem金矿=3//检测3个金矿
CheckItem银矿=1//检测1个银矿
CheckGold>=500000//检测50万金币
#ACT
ReduceItem金矿3//扣除3个金矿
ReduceItem银矿1//扣除1个银矿
ReduceGold500000//扣除50万金币
GiveItem金砖1//发放1个金砖
SystemMsg(材料充足，合成金砖成功！)
#ELSE
#IF
CheckItem金矿<3
#SAY
合成金砖需3个金矿，当前数量不足，请补充。\
<返回/@main>
#ELSEIF
CheckItem银矿<1
#SAY
合成金砖需1个银矿，当前数量不足，请补充。\
<返回/@main>
#ELSE
#SAY
合成金砖需50万金币，当前数量不足，请补充。\
<返回/@main>
BREAK
逻辑拆解：采用多条件并行检测，#ELSEIF分支精准定位缺失材料，避免模糊提示，让角色快速明确补充方向。
四、脚本学习技巧：快速上手的核心方法
1.牢记核心框架：所有脚本均以“#IF-#ACT”为基础，复杂逻辑只是多条件与多动作的组合，先掌握单条件脚本再逐步叠加。
2.命令分类记忆：按“货币、物品、角色、任务”四大类整理命令，结合具体场景记忆，如想到兑换功能就关联CheckGameGold与GiveItem。
3.模仿与修改：从简单案例入手，将现有脚本中的物品、数值替换为其他内容，观察执行效果，逐步理解命令作用。
4.注重细节：脚本对语法格式敏感，命令与数值间需空格，特殊符号如“//”用于注释不影响执行，可清晰标注代码用途。
传奇脚本的核心是用命令实现角色与系统的交互，掌握常用命令的组合规律后，即可根据需求编写各类功能脚本，从简单兑换到复杂任务系统均可逐步实现。
传奇脚本的执行核心围绕“条件判断-动作触发”展开，#IF（条件判断标识）与#ACT（动作执行标识）是构建脚本的基础指令对。#IF后紧跟具体检测条件，如角色等级、货币数量等；当条件满足时，#ACT后的代码块将自动执行；条件不满足时，可通过#ELSE定义备用操作，形成完整逻辑闭环。
基础框架示例：
#IF//条件判断开始
CheckGameGold>99//检测元宝数量大于99个
#ACT//条件满足时执行
GiveItem(强效金疮药10)//发放10个强效金疮药
ReduceGameGold100//扣除100个元宝
SystemMsg(消耗100元宝，兑换10个强效金疮药成功)
#ELSE//条件不满足时执行
SystemMsg(元宝不足100，无法兑换)
BREAK//终止脚本执行
上述代码实现“元宝兑换药品”的基础功能，通过明确的条件与动作对应，确保脚本逻辑清晰可执行，是所有复杂脚本的编写基础。
二、高频核心命令分类：检测条件与执行动作大全
脚本命令按功能可分为“检测类”与“执行类”，检测类命令用于#IF后判断触发条件，执行类命令用于#ACT后实现具体功能，以下为开发中最常用的命令集合。
1.货币检测与操作命令：经济系统核心
货币相关命令用于付费功能、道具兑换等场景，支持“大于、小于、等于”等逻辑判断，适配元宝与金币两种核心货币。
-元宝检测（CheckGameGold）：判断角色持有元宝数量，语法为“CheckGameGold比较符数值”，比较符支持>、<、=、>=、<=。
示例：#IFCheckGameGold>=500//检测元宝数量≥500个
-金币检测（CheckGold）：判断角色持有金币数量，语法与元宝检测一致，金币单位为“个”，10000金币等同于1元宝。
示例：#IFCheckGold>100000//检测金币数量大于10万
-元宝操作（ReduceGameGold/AddGameGold）：分别对应扣除与增加元宝，语法为“命令数值”。
示例：ReduceGameGold500//扣除500元宝；AddGameGold100//增加100元宝
-金币操作（ReduceGold/AddGold）：分别对应扣除与增加金币，语法为“命令数值”。
示例：ReduceGold100000//扣除10万金币；AddGold50000//增加5万金币
2.物品检测与操作命令：道具系统核心
物品相关命令涵盖背包持有、装备佩戴、数量判断等场景，是任务提交、装备合成、套装特效的核心实现工具。
-背包物品检测（CheckItem）：判断背包内指定物品数量，语法为“CheckItem物品名称/ID比较符数量”，不写数量默认检测是否持有。
示例：#IFCheckItem沃玛号角=1//检测背包内有1个沃玛号角
-装备佩戴检测（CheckItemW）：判断角色是否佩戴指定装备，“W”代表Wear（佩戴），语法为“CheckItemW装备名称/ID”。
示例：#IFCheckItemW圣战头盔//检测是否佩戴圣战头盔
-物品数量范围检测（CheckItemCount）：判断物品数量是否在指定区间，语法为“CheckItemCount物品ID最小数量最大数量”。
示例：#IFCheckItemCount祝福油310//检测祝福油数量在3-10之间
-物品操作（GiveItem/ReduceItem）：分别对应发放与扣除物品，语法为“命令物品名称/ID数量”。
示例：GiveItem屠龙刀1//发放1把屠龙刀；ReduceItem祝福油3//扣除3个祝福油
-物品合成（SynthesisItem）：实现多材料合成目标物品，语法为“SynthesisItem目标物品数量”。
示例：SynthesisItem超级祝福油1//合成1个超级祝福油
3.角色属性检测与操作命令：角色系统核心
针对职业、等级、转生等基础属性的命令，用于实现职业专属功能、等级门槛限制、转生福利等个性化需求。
-职业检测（Job）：判断角色职业，语法为“Job职业名称”，支持战士、法师、道士三类基础职业。
示例：#IFJob法师//仅法师职业可触发后续动作
-等级检测（Level）：判断角色等级，语法为“Level比较符等级数值”。
示例：#IFLevel>=35//检测角色等级≥35级
-转生检测（CheckReborn）：判断角色转生次数，语法为“CheckReborn比较符转次数值”，无转生为0。
示例：#IFCheckReborn>=2//检测转生次数≥2次
-属性操作（AddAttr/AddExp）：AddAttr用于增加角色属性，语法为“AddAttr属性名称数值”；AddExp用于增加经验，语法为“AddExp经验值”。
示例：AddAttr攻击5//攻击属性+5；AddExp50000//增加5万经验
-技能解锁（UnlockSkill）：为角色解锁指定技能，语法为“UnlockSkill技能名称”。
示例：UnlockSkill冰咆哮//为法师解锁冰咆哮技能
4.任务与状态检测命令：场景化触发核心
用于检测任务进度、会员身份、自定义状态等，实现脚本的场景化精准触发，提升交互体验。
-任务状态检测（CheckTaskStatus）：判断任务所处阶段，语法为“CheckTaskStatus任务名称状态”，状态支持未接、已接、完成。
示例：#IFCheckTaskStatus击败沃玛教主完成//检测任务已完成
-会员身份检测（CheckMem）：判断会员等级，语法为“CheckMem会员等级”，0为非会员，1及以上为对应VIP等级。
示例：#IFCheckMem1//检测角色为VIP1会员
-状态标记检测与设置（CheckFlag/SetFlag）：用于自定义状态判断与标记，语法分别为“CheckFlag标记名称标记值”“SetFlag标记名称标记值”。
示例：#IFCheckFlag新手引导0//检测新手引导未完成；SetFlag新手引导1//标记引导已完成
5.场景与交互命令：体验优化核心
用于实现地图传送、消息提示、功能开启等交互功能，提升脚本的实用性与玩家体验。
-地图传送（MapMove）：将角色传送至指定地图坐标，语法为“MapMove地图名称X坐标Y坐标”。
示例：MapMove转生地图100100//传送至转生地图（100100）坐标
-系统消息（SystemMsg）：向角色发送系统提示，语法为“SystemMsg提示内容”。
示例：SystemMsg转生等级达标，已传送至专属地图
-功能开启（OpenGuildCreate/OpenGuide）：分别对应开启创建行会功能与新手引导，语法为“命令引导步骤（可选）”。
示例：OpenGuildCreate//开启创建行会功能；OpenGuide1//开启第一步新手引导
-对话输出（#SAY）：向角色展示对话内容并提供功能按钮，语法为“#SAY对话内容\<按钮文本/@功能标识\>”。
示例：#SAY元宝不足，无法兑换！\<返回/@main\>
三、实战脚本案例：命令组合应用示范
脚本编写的核心是命令的灵活组合，以下通过两个高频场景案例，展示命令的实际应用逻辑。
案例1：元宝兑换经验（付费功能场景）
需求：角色消耗200元宝兑换100万经验，元宝不足或每日兑换次数用尽时提示对应信息，每日限1次。
(@元宝换经验)
#IF
CheckGameGold>=200//检测元宝≥200个
CheckFlag元宝换经验0//检测今日未兑换（标记值0）
#ACT
ReduceGameGold200//扣除200元宝
AddExp1000000//增加100万经验
SetFlag元宝换经验1//标记今日已兑换
SystemMsg(200元宝兑换100万经验成功，今日兑换已完成)
#ELSE
#IF
CheckFlag元宝换经验1//检测今日已兑换
#SAY
今日元宝兑换经验次数已用完，明日再来尝试吧！\
<返回/@main>
#ELSE
#SAY
元宝不足200，无法兑换100万经验。\
请先充值或通过其他途径获取元宝。\
<返回/@main>
BREAK
逻辑拆解：通过“元宝检测+每日标记检测”实现兑换限制，#ELSE分支细分两种失败场景，用#SAY提供清晰引导，提升交互体验。
案例2：装备合成（材料组合场景）
需求：3个金矿+1个银矿+50万金币合成1个金砖，缺少材料时精准提示缺失项。
(@合成金砖)
#IF
CheckItem金矿=3//检测3个金矿
CheckItem银矿=1//检测1个银矿
CheckGold>=500000//检测50万金币
#ACT
ReduceItem金矿3//扣除3个金矿
ReduceItem银矿1//扣除1个银矿
ReduceGold500000//扣除50万金币
GiveItem金砖1//发放1个金砖
SystemMsg(材料充足，合成金砖成功！)
#ELSE
#IF
CheckItem金矿<3
#SAY
合成金砖需3个金矿，当前数量不足，请补充。\
<返回/@main>
#ELSEIF
CheckItem银矿<1
#SAY
合成金砖需1个银矿，当前数量不足，请补充。\
<返回/@main>
#ELSE
#SAY
合成金砖需50万金币，当前数量不足，请补充。\
<返回/@main>
BREAK
逻辑拆解：采用多条件并行检测，#ELSEIF分支精准定位缺失材料，避免模糊提示，让角色快速明确补充方向。
四、脚本学习技巧：快速上手的核心方法
1.牢记核心框架：所有脚本均以“#IF-#ACT”为基础，复杂逻辑只是多条件与多动作的组合，先掌握单条件脚本再逐步叠加。
2.命令分类记忆：按“货币、物品、角色、任务”四大类整理命令，结合具体场景记忆，如想到兑换功能就关联CheckGameGold与GiveItem。
3.模仿与修改：从简单案例入手，将现有脚本中的物品、数值替换为其他内容，观察执行效果，逐步理解命令作用。
4.注重细节：脚本对语法格式敏感，命令与数值间需空格，特殊符号如“//”用于注释不影响执行，可清晰标注代码用途。
传奇脚本的核心是用命令实现角色与系统的交互，掌握常用命令的组合规律后，即可根据需求编写各类功能脚本，从简单兑换到复杂任务系统均可逐步实现。