一、NPC基础配置代码 核心参数解析
传奇NPC基础配置核心文件为NPC.txt（路径通常为MirServer\Mir200\Envir\NPC），所有NPC需先配置基础信息才能生效，核心代码格式与参数如下，适配主流引擎（Blue/GOM/GEE等）：
基础配置代码格式：NPC名称 地图编号 X坐标 Y坐标 脚本标识 外观代码 性别 状态 其他参数
核心参数说明：
1. 地图编号：对应MapInfo.txt中的地图编号（如3为盟重、10为猪洞七层），需精准匹配否则NPC无法在目标地图显示；
2. 坐标：NPC在地图中的具体位置（如330 330为盟重安全区中心），需避开障碍物与其他NPC，避免重叠；
3. 脚本标识：关联QManage.txt等脚本文件中的触发标识（如@NPC_英雄使者），无标识则NPC仅显示无交互功能；
4. 外观代码：控制NPC显示形象（0-999区间，如81为武士外观、105为道士外观），不同引擎外观代码通用；
5. 状态参数：0为默认（可交互）、1为隐藏（仅特定条件显示）、2为固定朝向，按需设置即可。
示例配置（盟重英雄使者）：英雄使者 3 379 304 @NPC_英雄使者 81 0 0 0，配置后NPC将在盟重379 304坐标显示，点击触发@NPC_英雄使者脚本。
二、NPC常用功能代码 实操示例
（一）对话交互功能 基础代码
对话功能为NPC核心基础功能，通过#SAY命令实现文字交互，支持换行、选项跳转，适配所有需要玩家交互的NPC（如任务NPC、商店NPC）。
核心代码格式（脚本文件中编写）：
[@NPC_对话示例] // 与NPC.txt中脚本标识一致
#SAY
欢迎来到传奇世界！// 对话内容
1. 了解新手任务 @新手任务 // 选项1，跳转至@新手任务标识
2. 领取新手装备 @领装备 // 选项2，跳转至@领装备标识
3. 退出对话 @EXIT // 退出交互
拓展代码：支持变量调用（如显示玩家等级、元宝数量），示例：#SAY 尊敬的%USERNAME（%LEVEL%级），您当前拥有%YuanBao%元宝！，其中%USERNAME为玩家名称变量、%LEVEL%为等级变量、%YuanBao%为元宝变量，引擎自动识别替换。
注意：对话内容每行不超过30字符，避免显示不全；选项跳转标识需唯一，不可与其他脚本重复。
（二）物品发放/回收功能 代码
物品发放（如新手装备、任务奖励）与回收（如装备回收换元宝）为高频功能，核心通过GIVE、TAKE命令实现，支持指定物品ID与数量。
1. 物品发放代码示例（新手装备领取）：
[@领装备]
#IF
LEVEL < 20 // 条件：玩家等级低于20级
#ACT
GIVE 新手剑 1 // 发放新手剑1把（物品ID对应StdItems.DB）
GIVE 布衣 1 // 发放布衣1件
SAY 新手装备已发放，请查收！
#ELSE
#SAY 您等级已超过20级，无法领取新手装备！// 条件不满足提示
2. 物品回收代码示例（沃玛装备回收）：
[@装备回收]
#SAY
请选择要回收的装备：
1. 沃玛头盔（回收得5000金币） @回收_沃玛头盔
2. 沃玛手镯（回收得4000金币） @回收_沃玛手镯
[@回收_沃玛头盔]
#IF
CHECKITEM 沃玛头盔 1 // 检查玩家是否拥有1个沃玛头盔
#ACT
TAKE 沃玛头盔 1 // 扣除1个沃玛头盔
GIVE 金币 5000 // 发放5000金币
#SAY 沃玛头盔回收成功，获得5000金币！
#ELSE
#SAY 您未拥有沃玛头盔，无法回收！
物品ID查询：打开StdItems.DB文件（用DBC2000查看），对应物品的“IDX”字段即为物品ID，发放/回收时需精准填写。
（三）地图传送功能 代码
传送NPC（如老兵、传送员）核心通过MAPMOVE命令实现，支持定点传送、条件传送（如等级限制、费用扣除），适配所有跨地图场景。
核心代码示例：
[@NPC_传送员]
#SAY
请选择传送目的地：
1. 盟重安全区（免费） @传盟重
2. 猪洞五层（需10级） @传猪五
3. 赤月峡谷（需35级+1000金币） @传赤月
[@传盟重]
#ACT
MAPMOVE 3 330 330 // 传送至3号地图（盟重）330 330坐标
#SAY 传送成功，祝您游戏愉快！
[@传猪五]
#IF
LEVEL >= 10 // 条件：等级≥10级
#ACT
MAPMOVE 17 120 130 // 传送至17号地图（猪洞五层）
#SAY 传送至猪洞五层，注意安全！
#ELSE
#SAY 您等级不足10级，无法传送至猪洞五层！
[@传赤月]
#IF
LEVEL >= 35 AND CHECKGOLD 1000 // 等级≥35级且拥有1000金币
#ACT
TAKEGOLD 1000 // 扣除1000金币
MAPMOVE 20 80 80 // 传送至20号地图（赤月峡谷）
#SAY 扣除1000金币，传送至赤月峡谷！
#ELSE
#SAY 您等级不足35级或金币不足1000，无法传送！
拓展：支持随机传送，代码为MAPMOVERAND 地图编号 最小X 最大X 最小Y 最大Y，示例：MAPMOVERAND 3 300 350 300 350（随机传送至盟重300-350坐标区间）。
（四）任务接取/提交功能 代码
任务NPC核心通过变量记录任务进度，配合CHECKVAR（检查变量）、SETVAR（设置变量）命令实现接取、提交流程，适配主线、支线等各类任务。
核心代码示例（击杀10只稻草人任务）：
[@NPC_任务使者]
#SAY
您好！我这里有个新手任务，需要您击杀10只稻草人，完成可获得丰厚奖励！
1. 接取任务 @接稻草任务
2. 提交任务 @交稻草任务
[@接稻草任务]
#IF
CHECKVAR HERO 稻草任务 = 0 // 检查任务变量是否为0（未接取）
#ACT
SETVAR HERO 稻草任务 1 // 设置任务变量为1（已接取）
SETVAR HERO 稻草击杀数 0 // 初始化击杀计数为0
#SAY 任务已接取！请前往新手村击杀10只稻草人，完成后回来提交！
#ELSE
#SAY 您已接取该任务，无需重复接取！
[@交稻草任务]
#IF
CHECKVAR HERO 稻草任务 = 1 // 已接取任务
AND CHECKVAR HERO 稻草击杀数 >= 10 // 击杀数≥10
#ACT
SETVAR HERO 稻草任务 2 // 设置任务变量为2（已完成）
GIVE 金币 10000 1 // 发放奖励：10000金币
GIVE 小药包 5 1 // 发放5个小药包
#SAY 任务完成！奖励已发放，继续加油！
#ELSEIF
CHECKVAR HERO 稻草任务 = 1 // 已接取但未完成
#SAY 您当前已击杀%HERO.稻草击杀数%只稻草人，还需击杀%[10-%HERO.稻草击杀数%]%只！
#ELSE
#SAY 您未接取该任务，无法提交！
击杀计数触发：需在怪物死亡脚本中添加计数代码，示例：#IF CHECKVAR HERO 稻草任务 = 1 #ACT INC HERO 稻草击杀数 1（击杀稻草人时计数+1）。
（五）称号授予/移除功能 代码
称号NPC通过ADDTITLE、DELTITLE命令实现称号授予与移除，支持条件授予（如完成任务、达到等级），适配称号系统相关NPC。
核心代码示例：
[@NPC_称号使者]
#SAY
请选择操作：
1. 领取“新手勇士”称号（需15级） @领新手称号
2. 移除称号 @删称号
[@领新手称号]
#IF
LEVEL >= 15 // 条件：等级≥15级
AND CHECKVAR HERO 新手称号 = 0 // 未领取过该称号
#ACT
ADDTITLE 新手勇士 // 授予“新手勇士”称号
SETVAR HERO 新手称号 1 // 标记为已领取
#SAY 恭喜您获得“新手勇士”称号！
#ELSE
#SAY 您等级不足15级或已领取该称号，无法重复领取！
[@删称号]
#IF
HAVETITLE 新手勇士 // 检查是否拥有该称号
#ACT
DELTITLE 新手勇士 // 移除称号
#SAY “新手勇士”称号已移除！
#ELSE
#SAY 您未拥有该称号，无法移除！
注意：称号名称需与Title.ini中的称号名称完全一致，否则授予失败；部分引擎支持称号属性加成，授予后自动生效。
三、NPC高级功能代码 特色玩法适配
（一）装备强化功能 代码
强化NPC通过CHECKITEM（检查材料）、UPGRADEITEM（强化装备）命令实现，支持强化成功率设置、强化失败惩罚，适配特色玩法中的强化系统。
核心代码示例（装备强化+3）：
[@NPC_强化使者]
#SAY
装备强化（+3）：需1件基础装备+5个强化石+10000金币
请放入要强化的装备，点击强化！
1. 开始强化 @装备强化
[@装备强化]
#IF
CHECKITEM 强化石 5 // 拥有5个强化石
AND CHECKGOLD 10000 // 拥有10000金币
AND CHECKITEM 新手剑 1 // 拥有1件新手剑（可替换为其他装备）
#ACT
TAKE 强化石 5 // 扣除强化石
TAKEGOLD 10000 // 扣除金币
TAKE 新手剑 1 // 扣除装备
UPGRADEITEM 新手剑+3 1 // 生成+3新手剑（装备名称需与StdItems.DB一致）
#SAY 强化成功！获得新手剑+3！
#ELSE
#SAY 您的材料、金币或装备不足，无法强化！
拓展：添加强化失败逻辑，示例：#IF RANDOM 10 < 3 // 30%成功率 #ACT （成功逻辑） #ELSE （失败逻辑：扣除材料，装备不变），RANDOM 10表示0-9随机数，按需调整成功率。
（二）NPC隐藏显示功能 代码
隐藏NPC需通过状态参数与脚本配合，仅特定条件（如完成任务、拥有指定物品）显示，适配隐藏任务、专属NPC等场景。
核心配置与代码：
1. NPC.txt配置（状态设为1，隐藏）：隐藏NPC 3 350 350 @NPC_隐藏 90 0 1 0；
2. 显示触发代码（脚本中编写）：
[@触发隐藏NPC]
#IF
HAVETITLE 终极战神 // 条件：拥有“终极战神”称号
#ACT
SETNPCSTATUS 隐藏NPC 0 // 设置NPC状态为0（显示）
#SAY 隐藏NPC已激活，可前往盟重350 350坐标查看！
#ELSE
#SAY 您未满足激活条件，无法显示隐藏NPC！
注意：SETNPCSTATUS命令中NPC名称需与NPC.txt中完全一致，否则状态修改失败。
四、NPC代码调试与常见问题排查
1. NPC无交互功能：检查NPC.txt中脚本标识是否与脚本文件中的触发标识一致，无标识则添加对应标识，确保格式统一（如@NPC_XXX）；
2. 功能触发报错：查看Log日志文件（路径MirServer\Log），日志中会提示错误代码（如变量未定义、物品ID错误），针对性修正参数；
3. NPC不显示：确认地图编号、坐标是否正确，状态参数是否为1（隐藏），若为隐藏需触发显示条件，或直接将状态改为0测试；
4. 物品发放/扣除失败：检查物品ID是否正确、玩家背包是否有足够空间（发放时）、是否拥有对应物品（扣除时），修正物品ID或提示玩家清理背包；
5. 脚本冲突：若多个NPC使用同一触发标识，会导致功能紊乱，需确保每个NPC的脚本标识唯一，避免重复。
五、代码编写注意事项 规避失误
1. 代码格式规范：脚本标识需以@开头，命令（如#IF、#ACT、#SAY）需大写，参数之间用空格分隔，避免语法错误；
2. 变量使用规范：变量前缀（如HERO、USER）需统一，避免变量重复定义，修改变量后需添加SAVEVAR命令保存数据；
3. 引擎适配：不同引擎核心代码通用，但部分高级命令（如UPGRADEITEM）需确认引擎支持，避免使用不兼容命令；
4. 备份配置：修改NPC.txt或脚本文件前，提前备份原文件，避免误操作导致功能失效，后续可通过备份恢复；
5. 测试验证：编写完成后，登录游戏测试NPC所有功能，确认交互、发放、传送等功能正常，再正式投入使用。
