一、人物升级触发脚本（等级提升触发逻辑）
升级触发脚本核心通过@LevelUp标识触发，适配等级达标奖励、属性加成、称号解锁等场景，依托等级检测、变量控制实现逻辑闭环，支持全职业通用。
（一）核心命令与触发机制
1. 触发标识：@LevelUp，人物等级提升时自动触发，无需手动调用，是升级脚本的核心入口。
2. 等级检测：checklevel 数值，精准检测当前等级，用于分阶触发不同逻辑（如10级、30级、50级分别触发奖励）。
3. 核心功能命令：ChangeHumanAttr（永久属性加成）、give（道具奖励）、SETRANKLEVELNAME（称号设置）、sendmsg（提示反馈）。
（二）实操脚本示例
场景：等级提升至指定阶段，发放奖励、加成属性、解锁称号，避免重复触发。
(@LevelUp) ；升级自动触发段
#IF
checklevel 10 ；检测是否升至10级
check (10) 0 ；检测是否未领取过10级奖励
#ACT
give 新手武器 1 ；发放新手武器
givegold 5000 ；发放5000金币
ChangeHumanAttr 攻击 2 ；永久+2攻击
set (10) 1 ；标记已领取奖励
sendmsg 5 恭喜升至10级，获得新手福利与属性加成！
#IF
checklevel 30
check (30) 0
#ACT
givebind 技能书 1 ；发放绑定技能书
SETRANKLEVELNAME 江湖小虾 ；解锁称号
ChangeHumanAttr 防御 3 ；永久+3防御
set (30) 1
sendmsg 5 恭喜升至30级，解锁称号与专属技能书！
#IF
checklevel 50
check (50) 0
#ACT
GAMEGOLD + 20 ；发放20元宝
give 沃玛装备 1 ；发放沃玛级装备
SETRANKLEVELNAME 江湖高手
set (50) 1
sendmsg 0 玩家[<$USERNAME>]成功升至50级，成为江湖高手！ ；全服提示
二、杀人触发脚本（击杀玩家/怪物触发逻辑）
分击杀玩家（PK）、击杀怪物两类场景，核心实现掉落加成、称号升级、仇恨标记等功能，依托对应触发标识与检测命令搭建。
（一）击杀怪物触发脚本
1. 触发标识：@KillMonster，击杀任意怪物后自动触发，可搭配怪物名称检测精准适配。
2. 核心命令：checkmonname（怪物名称检测）、random（掉落概率加成）、give（额外掉落）、inc（变量计数）。
脚本示例（击杀BOSS额外掉落）：
(@KillMonster)
#IF
checkmonname 祖玛教主 ；检测是否击杀祖玛教主
random 3 ；33%概率触发额外掉落
#ACT
give 黑铁矿石 10 ；额外发放黑铁矿石
sendmsg 5 击杀祖玛教主，获得额外奖励！
（二）击杀玩家（PK）触发脚本
1. 触发标识：@KillHuman，击杀其他玩家后触发，适配PK奖励、红名标记、称号升级场景。
2. 核心命令：CheckPkPoint（红名值检测）、inc（击杀计数）、SETRANKLEVELNAME（PK称号）、ALLOWDROP（掉落控制）。
脚本示例（PK击杀计数与称号升级）：
(@KillHuman)
#ACT
inc D0 1 ；D0记录击杀次数
sendmsg 5 成功击杀玩家，当前击杀数：$str(D0)
#IF
large D0 10 ；击杀数超过10次
#ACT
SETRANKLEVELNAME 杀戮者 ；解锁PK称号
ChangeHumanAttr 准确 2 ；永久+2准确
#IF
large D0 50
#ACT
SETRANKLEVELNAME 修罗战神
sendmsg 0 玩家[<$USERNAME>]击杀数突破50，化身修罗战神！
三、使用物品触发脚本（双击/使用物品触发逻辑）
依托物品StdMode编号绑定触发脚本，实现使用物品后释放技能、添加buff、传送地图、触发任务等功能，核心解决物品使用后的逻辑衔接。
（一）核心触发机制与命令
1. 触发标识：[@StdModeFuncXX]，XX为物品数据库中的StdMode编号（如药品12、特殊道具133），双击物品自动触发。
2. 核心命令：UseSkill（释放技能）、BuffAdd（添加临时buff）、MapMove（传送地图）、give（道具转换）、take（物品消耗）。
（二）实操脚本示例
场景1：使用传送卷轴，消耗卷轴并传送至指定地图。
[@StdModeFunc133] ；传送卷轴StdMode编号133
#IF
checkitem 传送卷轴 1 ；检测是否拥有卷轴
#ACT
take 传送卷轴 1 ；消耗卷轴
MapMove 安全区 320 330 ；传送至安全区
sendmsg 5 传送成功，已抵达安全区！
#ELSESAY
你已无传送卷轴，无法使用此功能。
场景2：使用增益道具，添加临时属性buff。
[@StdModeFunc140] ；增益药水StdMode编号140
#ACT
take 增益药水 1
BuffAdd 1 1800 3 ；添加编号1的buff，持续1800秒，等级3
sendmsg 5 饮用增益药水，获得3级属性加成，持续30分钟！
四、游戏命令触发脚本（输入命令触发逻辑）
通过玩家手动输入指定命令（如@回收、@福利、@加点）触发对应功能，适配快捷操作、福利领取、属性加点等场景，核心依托自定义命令标识搭建。
（一）核心触发机制与命令
1. 触发标识：@自定义命令（如@回收、@领取福利、@自动加点），玩家在聊天框输入命令即可触发。
2. 核心命令：ISADMIN（管理员权限检测）、checkday（每日限制）、RecycleItem（自动回收）、ChangeHumanAttr（属性加点）。
（二）实操脚本示例
场景1：输入@回收命令，自动回收背包垃圾装备。
(@回收) ；输入@回收触发
#ACT
RecycleItem 垃圾矿石 1 ；回收垃圾矿石，每块兑换金币
RecycleItem 低级装备 1
givegold 100 ；每回收1件装备兑换100金币
sendmsg 5 自动回收完成，获得对应金币奖励！
场景2：输入@领取福利，每日领取一次福利，限制次数。
(@领取福利)
#IF
checkday 1 ；检测今日是否已领取
#SAY
你今日已领取福利，明日再来！
#ELSEACT
give 疗伤药 20
GAMEGOLD + 5
setday 1 ；标记今日已领取
sendmsg 5 每日福利领取成功，请注意查收背包！
场景3：管理员命令@全服发奖，仅管理员可触发。
(@全服发奖)
#IF
ISADMIN ；检测是否为管理员
#ACT
MapAllUser give 超级疗伤药 5 ；全服发放道具
MapAllUser givegold 10000
sendmsg 0 全服福利发放完毕，所有玩家请注意查收！
#ELSESAY
你无权限执行此命令！
五、四类脚本核心编写规范
1. 触发标识精准：升级用@LevelUp、杀怪用@KillMonster、杀人用@KillHuman、物品用[@StdModeFuncXX]，不可混用，避免触发异常。
2. 防重复触发：分阶奖励、每日福利场景，需用变量（set/check）或checkday命令限制，避免多次触发导致资源异常。
3. 权限与检测前置：管理员命令必须添加ISADMIN检测，物品使用、奖励发放前需检测道具数量、背包空格，降低异常风险。
4. 提示反馈完整：每类触发逻辑均需添加sendmsg或#SAY提示，让玩家清晰知晓触发结果，提升体验。
5. 变量及时重置：击杀计数、等级标记等变量，需根据需求重置（如每日凌晨重置领取标记），避免逻辑错乱。
六、常见问题排查
1. 脚本不触发：检查触发标识是否正确（如StdMode编号与物品匹配），命令语法是否有误，重启服务端测试。
2. 重复触发奖励：遗漏变量标记或checkday检测，补充对应命令，确保触发一次后标记状态。
3. 物品使用后无效果：核对take命令与物品名称是否一致，检测功能命令是否适配（如BuffAdd编号是否正确）。
4. 权限命令失效：管理员账号权限未配置正确，检查账号权限等级，确保ISADMIN命令生效。
5. 触发后无提示：遗漏sendmsg命令，或提示参数错误（如sendmsg后未加数值与文本），补充完整提示逻辑。
