一、前期准备（工具+核心信息确认）
1. 必备工具（新手易上手）
核心需数据库编辑工具、文本编辑器与服务端备份工具。数据库工具优先选用Navicat或SQL Server Management Studio，支持可视化编辑NPC数据表，避免手动输入命令出错；文本编辑器选用Notepad、Sublime Text，用于编写传送脚本，支持语法高亮，提升编辑效率。
备份工具需提前准备，操作前完整备份服务端核心文件（尤其是Mirserver文件夹下的Mud2/DB数据库目录与NPC脚本目录），若修改出错可快速恢复，避免影响服务端正常运行。所有工具从正规开发者论坛获取，确保与单机传奇版本适配，无需额外插件，基础工具即可完成全部操作。
2. 核心信息确认（必懂基础）
土城（盟重省）核心参数：传奇单机版中，土城地图编号常规为3（部分版本为10），安全区坐标默认330,330（可根据版本微调），需提前确认自身版本的地图编号与坐标，避免传送位置异常。可通过服务端“地图配置文件”（MapInfo.txt）查询，打开文件后搜索“盟重”或“土城”，即可获取对应地图编号与安全区坐标。
NPC核心数据表：单机传奇的NPC信息存储在物品数据库（通常为HERODB）的NPC数据表中，表名多为NPC或NPCData，该表包含NPC名称、坐标、脚本关联等核心字段，添加土城传送NPC需先在该表中创建NPC基础信息。
二、核心操作：添加土城传送NPC（分三步完成）
1. 数据库创建NPC基础信息（第一步）
打开数据库编辑工具（以Navicat为例），连接单机传奇数据库（IP默认127.0.0.1，端口3306或1433，账号密码为安装服务端时设置），找到HERODB数据库，双击打开NPC数据表（如NPC表），点击“新增行”，按以下规范填写核心字段：
1. NPC名称（Name）：填写“土城传送员”（或自定义名称，如“盟重传送师”），便于玩家识别。
2. 地图编号（Map）：填写土城对应地图编号，常规为3，若版本不同则按查询结果填写，确保NPC生成在目标地图。
3. 坐标（X/Y）：填写土城安全区坐标，默认330,330，可微调至328,332等安全位置，避免NPC生成在地图边缘或障碍物处。
4. 脚本标识（Script）：填写脚本关联名称，如“TuchengTeleport”，后续编写传送脚本时需与该标识一致，实现对话触发传送。
5. 外观编号（LookFace）：填写NPC外观对应的数字，常规传送员外观编号为15（可自行查询外观列表调整），确保NPC显示正常。
6. 其他字段：等级（Level）设为0，血量（HP）设为1000（避免被怪物攻击死亡），其余字段按默认值填写即可。填写完成后按Ctrl+S保存，关闭数据表但保持数据库连接。
2. 编写土城传送脚本（核心步骤）
打开文本编辑器，新建文本文件，命名为“TuchengTeleport.txt”（需与数据库中脚本标识一致），脚本存放路径为服务端“NPCScript”或“QuestDiary”文件夹，按以下格式编写传送逻辑，支持多地图传送至土城：
// 土城传送员脚本（传送至土城安全区）
(@TuchengTeleport)#IF#SAY 欢迎使用土城传送服务！\n点击即可传送至土城安全区～#ACT mapmove 3 330 330 #SAY 传送中...已到达土城安全区！\n
// 支持从土城传送至其他地图（可选添加）
(@ToBiqi)#IF#SAY 是否传送至比奇城安全区？#ACT mapmove 0 327 272 #SAY 已传送至比奇城！#ELSEACT#SAY 请确认操作！
脚本解析：以(@TuchengTeleport)为核心触发标签，与数据库脚本标识关联，玩家与NPC对话即可触发；#SAY为对话提示内容，\n用于换行，提升可读性；mapmove为传送命令，参数依次为地图编号、X坐标、Y坐标，3 330 330即对应土城安全区；可选添加反向传送脚本，支持从土城传送至比奇（地图编号0）等其他地图。
若需添加传送条件（如消耗金币），可修改脚本为：#IF checkgold 1000 #SAY 是否消耗1000金币，传送至土城安全区？#ACT mapmove 3 330 330 take gold 1000 #SAY 传送成功！扣除1000金币～#ELSEACT#SAY 金币不足1000，无法传送！
编写完成后保存脚本，将文件放入对应NPC脚本文件夹，确保文件名与脚本标识一致，无多余后缀（如.txt需保留）。
3. 配置生效与验证（关键一步）
重启单机传奇服务端：关闭服务端所有进程，重新启动引擎控制器（Engine.exe），等待所有服务启动完成（显示“启动成功”）。登录游戏后，使用GM命令@reloadnpc all重载NPC脚本，确保传送脚本生效。
进入土城地图（可通过其他传送方式或GM命令@move 3 330 330快速到达），找到“土城传送员”NPC，点击对话后触发传送，验证是否能正常传送至土城安全区；若添加了反向传送功能，可测试从土城传送至其他地图，确认传送无异常。
三、补充操作：多场景传送配置（可选）
1. 定点地图传送至土城
若需在特定地图（如蜈蚣洞、猪洞）添加土城传送NPC，可重复第一步数据库操作，在目标地图创建NPC，脚本关联“TuchengTeleport”，无需重新编写脚本，直接复用现有传送逻辑，实现多地图统一传送至土城。
例如在蜈蚣洞（地图编号2）创建NPC，坐标设为200,200，脚本标识仍为“TuchengTeleport”，玩家在蜈蚣洞点击该NPC，即可直接传送至土城安全区，提升游戏便利性。
2. 传送触发条件扩展
除消耗金币外，可添加等级限制、物品限制等传送条件。例如设置等级≥10级方可传送：#IF checklevel 10 #SAY 等级达标，可传送至土城！#ACT mapmove 3 330 330 #ELSEACT#SAY 需达到10级方可使用传送服务！
添加物品限制（如需携带传送卷轴）：#IF checkitem 传送卷轴 1 #SAY 是否消耗1个传送卷轴，传送至土城？#ACT mapmove 3 330 330 take 传送卷轴 1 #SAY 传送成功！#ELSEACT#SAY 未携带传送卷轴，无法传送！
四、客户端同步配置（避免NPC异常）
若NPC显示异常（如名称错乱、外观缺失），需同步调整客户端配置。打开客户端“Data”文件夹，找到“NPC.txt”（NPC显示配置文件），新增一行配置：“土城传送员 15 3 330 330”，参数依次为NPC名称、外观编号、地图编号、坐标，与数据库中信息一致。
若传送后地图显示错乱，检查客户端“MapInfo.txt”文件，确认土城地图编号（3）对应的地图名称与路径正确，缺失则补充地图配置，重启客户端后即可正常显示。
五、常见问题排查（避坑指南）
1. 找不到添加的土城传送NPC？
核心原因：数据库字段填写错误或未重启服务端。先核对NPC数据表中的地图编号、坐标是否正确，确保与土城地图匹配；重启服务端，执行@reloadnpc all重载NPC；若仍未找到，检查NPC外观编号是否正确，避免外观隐藏导致无法识别。
2. 点击NPC无响应或无法传送？
原因：脚本标识不匹配、脚本语法错误或传送参数错误。核对数据库脚本标识与脚本文件名一致，无错别字；检查脚本命令格式，确保#IF、#SAY、#ACT等命令无遗漏，mapmove参数（地图编号、坐标）正确；执行@reloadnpc all重载脚本，重新测试传送。
3. 传送后出现黑屏或卡在地图？
多为地图编号错误或坐标无效导致。打开MapInfo.txt，确认土城地图编号（常规3）正确，坐标在地图有效范围内（避免超出地图边界）；调整传送坐标至安全区（如330,330），重启服务端与客户端，即可恢复正常传送。
4. NPC被怪物攻击死亡？
未设置NPC血量或等级过低。打开NPC数据表，将HP字段设为10000（足够抵御怪物攻击），Level字段设为999，同时添加“无敌”属性（部分版本支持#ACT setimmortal 1命令，在脚本中添加可让NPC永久无敌），避免被怪物击杀。
六、实用技巧（提升传送NPC实用性）
1. 脚本中添加多选项传送，支持玩家选择传送至土城不同区域（如土城药店、仓库），坐标分别设为325,320（药店）、335,335（仓库），提升便利性；2. 为NPC添加自动回复功能，脚本中添加#ACT sendmsg 6 土城传送员：传送服务正常开放！，让玩家快速知晓NPC功能；3. 定期备份NPC脚本与数据库，若后续修改出错，可快速恢复原始配置；4. 调整NPC外观与名称，结合版本风格自定义（如“盟重传送大使”），提升游戏代入感；5. 限制单角色每日传送次数（如每日5次免费传送），脚本中添加#IF checkdaycount 5 #SAY 今日免费传送次数已用完！，增加游戏设定合理性。
6. 若服务端为DBC2000数据库，添加NPC后需打开DBC2000控制器，刷新HERODB数据库，确保NPC信息同步；7. 新手可先在单机测试服添加NPC与脚本，验证无异常后再应用到正式单机服，降低操作风险。
