传奇ADDGUILDLIST脚本教程 - 添加人物行会名至列表
摘要：本文为996引擎专属ADDGUILDLIST脚本实操教程，主打将人物行会名添加至列表的功能，完整提供标准脚本代码、参数释义、多引擎适配情况，手把手讲解脚本添加、参数修改、生效触发步骤，汇总高频报错问题与修复方法，整理新手实操避坑要点及高频问答，全程干货无废话，适合传奇新手GM零基础搭建使用。…
本文详解996引擎专属ADDGUILDLIST行会列表添加脚本，可快速将玩家所属行会名写入指定文本列表，解决新手GM不会批量收录行会信息、自定义行会名单统计的实操问题。
一、脚本完整命令与语法详解
本脚本为传奇996引擎专属行会信息录入指令，核心作用是触发命令后，自动读取当前执行玩家的行会名称，并将其写入预设的文本文件，是制作行会统计、专属行会权限名单、行会活动筛选名单的核心脚本。
标准完整可用脚本代码
[@addguildList]
#if
#act
ADDGUILDLIST guildlist.txt
核心命令参数详解
该脚本仅包含一个核心实操参数，参数配置简单、无复杂嵌套，新手可直接修改使用，具体参数释义如下：
| 参数内容 | 参数释义 | 使用用法 |
|---|---|---|
| guildlist.txt | 行会名单存储文本文件，为脚本生成的数据源文件，用于存放所有成功触发脚本的玩家行会名称，文件自动生成无需手动创建 | 可自定义文件名及后缀，支持txt、ini等文本格式，文件默认生成在引擎根目录，修改名称后需全程统一调用 |
二、多引擎适配说明
适配引擎：996引擎
该脚本为996引擎原生支持指令，语法原生兼容、无指令报错、功能无缺失，可直接在996引擎所有版本中使用。
不适配引擎及差异说明
HERO、BLUE、LEGEND等主流老版本引擎不兼容ADDGUILDLIST指令，此类引擎无专属行会名单写入命令，直接粘贴脚本会出现指令不识别、功能不生效问题，需替换对应引擎专属的行会信息读取写入语法。
适配注意事项
仅996引擎可直接照搬使用，其他引擎禁止直接套用；跨引擎使用需重构命令逻辑，不可仅修改文件名适配。
三、分步实操使用教程
全程手把手教学，新手GM可直接照搬步骤操作，快速实现行会名列表录入功能。
步骤1：打开脚本编辑文件
打开996引擎服务端文件夹，进入Mir200\Envir\Market_Def目录，选择需要挂载功能的NPC脚本文件，或新建自定义NPC脚本文件。
步骤2：粘贴完整脚本代码
将上方完整的[@addguildList]脚本代码复制，粘贴到脚本文件空白位置，保证代码无缺行、无字符遗漏、无多余空格。
步骤3：自定义修改参数（可选）
如需分类统计不同行会名单，可修改guildlist.txt文件名，比如改为activeguild.txt、topguild.txt，方便区分不同场景的行会数据。
步骤4：保存脚本文件
修改完成后，直接Ctrl+S保存文件，关闭脚本编辑窗口，无需额外配置文件权限。
步骤5：功能生效触发
回到传奇游戏服务端，重启NPC脚本加载（无需重启整个服务端），游戏内玩家点击对应NPC，即可触发脚本，自动将自身行会名写入指定文本文件。
四、高频报错与排错方案
汇总新手实操中该脚本最常见的不生效、无数据、报错问题，精准定位成因并给出修复方案。
问题1：触发脚本后，文本文件无行会数据、功能不生效
成因：玩家未加入任何行会，无行会名称可读取；脚本代码存在多余空格、换行错乱；未正确加载NPC脚本。
修复方案：让已加入行会的玩家重新触发功能；核对脚本代码格式，删除多余空格与空行；重新加载服务端NPC脚本。
问题2：服务端提示未知指令报错
成因：服务端并非996引擎，引擎不兼容该指令；指令单词拼写错误（如少写字母、大小写错误）。
修复方案：确认引擎版本为996专属；核对ADDGUILDLIST指令拼写，严格使用大写标准指令，传奇脚本指令区分大小写。
问题3：生成的文本文件乱码
成因：服务端编码格式不匹配，系统默认编码与脚本编码冲突。
修复方案：右键打开文本文件，选择另存为，编码选择ANSI格式保存，重新触发脚本即可正常显示行会名称。
五、新手实操避坑注意事项
1. 空行会过滤注意：无行会的玩家触发脚本不会生成任何数据，属于正常现象，无需修改脚本，可自行添加行会判断脚本搭配使用。
2. 文件存储路径禁忌：禁止自定义文件存储路径，996引擎该指令仅支持默认根目录存储，填写路径会直接导致功能失效。
3. 指令格式禁忌：ADDGUILDLIST必须为大写格式，小写、大小写混搭会被引擎判定为未知指令，严格遵循标准代码格式。
4. 版本适配限制：996引擎轻量版、完整版均可使用该脚本，破解版、修改版引擎可能存在指令阉割，大概率无法正常生效。
5. 数据重复问题：脚本无自动去重功能，玩家多次触发会重复写入行会名，如需去重需搭配自定义去重脚本二次优化。
六、高频FAQ问答
Q1：脚本会自动重复录入相同行会名称吗？
A：会的，同一行会多名玩家触发、同一玩家多次触发，都会重复录入，需要手动清理文本文件或搭配去重脚本使用。
Q2：可以将文件保存到指定文件夹内吗？
A：996引擎原生不支持，该指令仅支持引擎根目录保存，无法自定义子文件夹路径。
Q3：为什么所有设置都正确，依旧没有生成文本文件？
A：大概率是未触发脚本功能，或服务端拦截了文件写入权限，重新加载NPC脚本、以管理员身份运行服务端即可解决。
Q4：能否搭配行会等级、行会人数筛选录入？
A：原生脚本无筛选功能，可叠加#if条件判断语句，实现指定等级、指定人数的行会精准录入。
七、全文总结
本文详细讲解了996引擎ADDGUILDLIST添加人物行会名至列表脚本的完整用法，包含标准代码、参数解析、引擎适配、实操步骤、报错排错及避坑要点，新手GM可直接套用脚本实现行会名称批量收录功能，快速完成游戏内行会数据统计、专属名单制作等实操需求。
