一、添加NPC核心前提
1. 确认Hero传奇引擎服务端正常运行，获取服务端文件夹的操作权限，避免文件编辑后无法保存。
2. 备份服务端关键文件，重点备份Envir目录下的merchant.txt、npcs.txt文件及market_def、npc_def文件夹，防止操作失误导致原有NPC数据丢失。
3. 准备基础编辑工具，推荐使用记事本或专业文本编辑器，确保编辑时保持文件编码为ANSI，避免出现乱码问题。
二、NPC分类与对应配置文件说明
Hero引擎中NPC主要分为两类，对应不同配置文件与存放路径，具体区别如下：
1. 对话型NPC：信息记录在npcs.txt文件中，对应脚本存放于Envir/npc_def文件夹，添加后无法通过游戏内命令刷新，需重启引擎生效。
2. 交易/任务型NPC：信息记录在merchant.txt文件中，对应脚本存放于Envir/market_def文件夹，支持游戏内使用@reloadnpc命令刷新，无需重启引擎，实操中更常用。
注：两类NPC可互换存放路径，无严格限制，但建议按功能分类存放，便于后续管理与修改。
三、添加NPC详细实操步骤
步骤1：确定NPC基础信息
提前明确新增NPC的核心参数，避免配置时遗漏关键信息，参数如下：
1. 基础属性：NPC名称（如“比奇传送员”“超级商人”）、对应地图（如比奇省、盟重省）、地图坐标（X轴与Y轴，如330:330）。
2. 外观与刷新：NPC外观代码（共46种基础外观，如73对应传送员形象、8对应比齐丞相形象）、刷新时间（单位为秒，0表示永久存在）、活动范围（0表示固定位置）。
3. 功能定位：明确NPC为对话型、交易型还是任务型，以此确定存放于对应配置文件与脚本文件夹。
补充：地图编号查询方法，以管理员身份进入游戏，在聊天框输入命令@map，回车后即可显示当前地图的编号（如比奇省编号为0，盟重省编号为3）。
步骤2：创建NPC脚本文件
以添加交易/任务型NPC为例，脚本创建流程如下：
1. 打开服务端路径Envir/market_def，新建文本文档，文件命名格式为“NPC名称-地图编号.txt”（如“比奇传送员-0.txt”），其中地图编号需与NPC要出现的地图一致，横线为英文状态下输入。
2. 编辑脚本内容，脚本以@main作为主体开头，后续可添加对话内容、功能触发命令等，基础脚本示例如下：
(@main)
#say
欢迎来到比奇省！
我可以为你传送至各大地图~
(@传送庄园) 前往庄园
(@传送盟重) 前往盟重省
(@传送庄园)
#act
mapmove 3 326 326
sendmsg 0 已为你传送至庄园，请注意周围环境！
break
(@传送盟重)
#act
mapmove 3 330 330
sendmsg 0 已为你传送至盟重省，祝你游戏愉快！
break
脚本说明：@main后为NPC对话内容，()内为功能选项，@后为触发命令，#act后为执行动作，mapmove后依次为地图编号、X坐标、Y坐标，sendmsg用于发送系统提示。
3. 对话型NPC脚本创建方法一致，仅需将脚本文件保存至Envir/npc_def文件夹，命名格式相同，脚本内容可参考上述示例调整。
步骤3：配置merchant.txt/npcs.txt文件
1. 打开对应配置文件（交易/任务型NPC打开merchant.txt，对话型打开npcs.txt），在文件末尾添加NPC信息，格式如下：
基础格式：NPC脚本文件名 地图编号 坐标X 坐标Y 活动范围 外观代码 刷新时间
示例1（交易型NPC）：超级商人-0 0 330 330 0 5 0
说明：对应脚本文件为“超级商人-0.txt”，地图编号0（比奇省），坐标330:330，活动范围0，外观代码5，刷新时间0（永久存在）。
示例2（传送型NPC）：比奇传送员-0 0 329 266 0 73 0
说明：对应脚本文件为“比奇传送员-0.txt”，地图编号0（比奇省），坐标329:266，外观代码73（传送员形象），永久存在。
2. 配置参数补充：参数之间用空格分隔，空格数量无限制，以;开头的行视为注释，不会被引擎编译，可用于标注NPC功能。
3. 进阶配置：可添加变色参数，格式为“NPC信息 变色模式 变色间隔 颜色类型”，示例：百晓生 0 333 333 百晓生 0 8 1 0 0 1 2000 0，其中1为名字+身体变色，2000为间隔毫秒，0为随机颜色。
步骤4：NPC生效操作方法
1. 交易/任务型NPC（merchant.txt配置）：保存文件后，进入游戏以管理员身份在聊天框输入@reloadnpc，回车即可刷新，切换地图或小退重新进入，即可看到新增NPC。
2. 对话型NPC（npcs.txt配置）：保存文件后，关闭服务端引擎，重新启动引擎与游戏，进入对应地图即可看到新增NPC。
3. 批量添加生效：若同时添加多个NPC，可通过M2引擎控制器操作，路径为M2>控制>重新加载>所有NPC，一次性完成所有新增NPC的生效刷新。
四、NPC外观代码对照表（常用）
以下为常用NPC外观代码及对应形象，便于快速选择，完整代码可参考引擎自带说明文档：
0-铁匠（手持铁锤形象）、1-长者（戴帽长须，整理帽子动作）、3-猎人（背黄色斗笠，腰间挂绿布袋）、4-厨师（扎头巾，穿紫色长裙）、5-妇人（黑色马尾辫，穿紫色长裙）、8-比齐丞相（白褂持扇，不时扇动）、9-老翁（躬腰戴长帽，揉眼动作）、11-屠夫（经典屠夫形象）、15-武师（绿甲绿马尾，擦拭佩剑）、16-巡捕（肩扛木棍，遮阳眺望）、17-茶楼老板（持茶壶竹扁，相互敲打）、20-法师（手持道具，右手晃动）、22-毒药师（持册子药瓶，查看动作）、25-店小二（扎黄色布巾，双手垂胸）、26-马商（肌肉发达，摆弄肱二头肌）、73-传送员（标准传送员形象）。
五、常见问题排查与解决
1. 新增NPC不显示：优先检查脚本文件名与配置文件中填写的名称一致，地图编号与目标地图匹配；其次确认脚本文件存放路径正确，交易型NPC需在market_def文件夹；最后检查外观代码是否有效，无效代码会导致NPC不显示。
2. 刷新后NPC功能失效：检查脚本语法，确保@main、#say、#act等命令书写正确，无遗漏符号；确认脚本编码为ANSI，乱码会导致引擎无法识别脚本内容。
3. 变色参数不生效：检查变色参数格式是否正确，变色模式（1-3）、间隔（毫秒）、颜色类型（1-7，0为随机）需依次填写，不可遗漏或错位。
4. 刷新NPC后原有NPC消失：大概率是编辑配置文件时误删原有内容，恢复备份的merchant.txt或npcs.txt文件即可恢复。
六、后续管理与修改技巧
1. NPC修改：直接编辑对应脚本文件，修改对话内容或功能命令后，按对应生效方式刷新即可；若修改NPC位置或外观，需同步修改配置文件中的坐标或外观代码。
2. NPC隐藏/删除：隐藏只需在配置文件中对应NPC信息前添加;（英文分号），注释该条信息即可；删除则直接删除配置文件中的对应行及脚本文件夹中的脚本文件。
3. 脚本优化：复杂功能NPC可拆分脚本，通过#CALL命令调用其他脚本文件，减少主脚本篇幅，便于后期维护；常用功能脚本可保存为模板，后续添加同类NPC直接修改参数即可。
七、核心注意事项总结
1. 所有文件编辑时需关闭引擎控制器，避免文件被占用导致无法保存，编辑完成后再开启生效。
2. 脚本中不可使用特殊字符，对话内容如需换行，需使用换行标记，避免显示异常。
3. 新增NPC坐标需避开地图障碍物，确保玩家可正常点击交互，坐标可在游戏内通过管理员命令查看。
4. 批量添加NPC时，建议按地图分类创建脚本文件夹，将同一地图的NPC脚本集中存放，提升管理效率。
