轩辕传奇各类辅助脚本分为客户端触发脚本、服务端事件脚本两大类，两类脚本存放路径、加载方式、触发逻辑完全不同，很多使用者拿到脚本后无法正常运行，大多是存放目录错误、编码格式不对、缺少对应触发标签或者权限配置没有调整到位。
先区分脚本类型，客户端脚本一般用于界面弹窗、快捷键、提示文字，文件后缀多为lua，服务端脚本负责任务判定、奖励发放、怪物行为、NPC交互，文件后缀常见为txt或者lua，不同版本的程序支持的脚本语言存在差异，下载脚本前需要确认脚本适配对应的程序版本，版本不匹配会直接出现加载失败，或者执行时无任何反应。
脚本存放目录是最容易出错的环节。服务端NPC交互脚本，需要放到服务端目录下的NPC脚本文件夹，放入之后要确认脚本文件名不要使用中文特殊符号，文件名过长也会导致读取失败。客户端脚本放置在客户端目录对应的script文件夹，部分版本需要新建子目录存放脚本文件，不能直接丢在根目录。文件复制完成之后，不要直接启动程序，需要检查文件编码，Windows记事本保存的文件默认ANSI编码，中文注释容易乱码，推荐使用notepad++打开脚本，将编码转为UTF-8无BOM格式，乱码会造成脚本中途停止执行。
脚本加载分为自动加载和手动加载两种方式。自动加载依靠配置文件，打开对应目录的加载列表文件，按照格式新增一行脚本路径和文件名，保存之后重启服务端，程序启动阶段会自动读取列表里所有脚本。手动加载适合临时测试脚本，在控制台输入加载指令，后面带上脚本完整文件名，回车即可载入，适合调试阶段反复修改脚本，不用每次重启整个程序。手动加载仅本次运行生效，程序关闭后再次启动，不会保留加载记录。
脚本基础使用步骤，第一步备份原有目录内全部脚本文件，防止新脚本代码冲突覆盖原有功能，出现异常后可以快速还原。第二步打开脚本文件通读代码，检查脚本内写好的触发标签，任务类脚本核对任务ID，NPC脚本核对NPC编号，确认编号和当前环境数据库内的编号保持一致，编号不匹配会出现点击NPC不触发脚本。第三步修改脚本内参数，包括奖励道具ID、数量、触发条件、冷却时间，按照当前环境物品数据库调整数值。第四步保存文件，处理编码格式。第五步加载脚本，自动加载方式需要重启服务端，手动加载直接控制台执行加载命令。第六步进入游戏内触发对应事件，观察控制台日志窗口，日志会输出脚本运行信息，报错内容会写明行数和错误类型。
脚本触发的常见问题，放置正确目录但是脚本不生效。优先查看控制台日志，日志提示找不到文件，代表文件名写错或者路径层级不对。日志提示语法错误，定位到报错行数，检查括号、引号、换行符号，代码缺少符号是高频问题。脚本加载成功，但是游戏内没有效果，一般是触发条件不满足，NPC编号、任务编号、道具检测条件和当前环境不匹配，需要核对数据库。部分脚本需要开启对应模块开关，模块未开启，脚本就算加载成功也不会执行代码。
调试脚本的实用方法，写脚本时可以在关键位置添加日志输出语句，触发脚本之后，对应文字会打印在控制台，用来判断代码执行到哪一段中断。不要一次性导入多个大型脚本，建议单个脚本单独测试，确认功能正常之后，再添加下一段脚本，多个脚本同时存在时，变量名称重复会互相干扰，造成功能异常。测试完成确认没有问题，再给到多人环境使用。
权限相关设置，部分脚本内置高等级奖励、传送、全局消息这类功能，脚本自带权限判断，只有指定角色权限等级达标才能执行。测试时可以把角色权限调整到脚本要求等级，测试完成后，根据需求修改脚本内权限判断代码，避免普通玩家调用高权限指令。
脚本卸载操作，自动加载脚本需要打开加载列表文件，删除对应脚本那一行内容，保存后重启服务端。手动加载脚本，控制台输入卸载指令加上脚本名称即可。删除脚本文件前，确认脚本没有被程序占用，程序正在读取脚本文件时删除，会引发程序异常退出。
不同类型脚本使用要点，NPC对话脚本，重点核对[@标签]，点击NPC时匹配标签名称，标签缺失或者名称不一致，脚本不会响应点击。任务脚本，绑定任务ID，完成任务、提交任务的触发点要对应，奖励发放代码写在任务提交成功分支。怪物行为脚本，绑定怪物模板ID，怪物刷新时读取脚本，用来控制怪物释放技能、呼叫支援、掉落额外物品。
日常使用注意事项，不要直接使用来源不明的完整脚本包，代码内可能包含异常指令，导入前逐行阅读代码。脚本修改完成，每次改动都要重新加载或者重启服务端。游戏客户端更新之后，部分客户端脚本文件会被覆盖，需要重新上传放置脚本文件。
