996引擎AddGuild命令用法详解 - 建行会实现方法

做新手建会、GM直接建行会、批量创建行会这类玩法，需要用脚本直接创建一个新行会。AddGuild命令就是996引擎提供的建立新行会命令，直接在本地服务端创建一个新行会，并指定谁当掌门。

新手最常踩的坑是行会名重复导致创建失败，或者掌门参数写错找不到人。这个命令第二个参数填Self就是自己当掌门，下面把命令格式、掌门参数、创建失败原因逐一梳理清楚。

命令格式

AddGuild是996引擎建行会命令，属于行会管理类脚本命令，格式如下：

AddGuild 行会名 掌门 [参数3]

对照帮助文档：增加一个新行会，可以指定某人成为该行会掌门，掌门必须在线。第二个参数等于Self时掌门是自己，否则填在线玩家名；第三个参数填-1时创建一个没有掌门的空行会。

文档自带的标准示例：

[@AddGuild]
#IF
#ACT
AddGuild 华山派 Self

这段创建”华山派”行会，掌门就是执行命令的玩家自己。

创建空行会的写法：

[@Main]
#IF
#ACT
AddGuild 华山派 Self -1
SendMsg 7 创建了一个没有掌门的空行会

参数讲解

第二个参数写Self最省事，玩家点NPC建会自己当掌门，不用再单独填自己名字。

避坑指南

行会名不能重复。重名创建失败，先查有没有同名行会。

掌门必须在线。第二个参数填的玩家不在线，创建失败。

行会名别用特殊字符。特殊字符可能被过滤导致名字不对。

创建后掌门自动进行会。掌门不用再申请加入。

实操步骤

第一步，打开NPC脚本文件，在本地服务端Market_Def目录下找到对应NPC。

第二步，玩家自助建会，自己当掌门：

@Main]
#IF
#ACT
AddGuild 铁血盟 <$USERNAME>

第三步，写带材料检测的建行会：

[@建行会]
#IF
CHECKITEM 行会卷轴 1
CHECKGOLD 100000
#ACT
TAKE 行会卷轴 1
GAMEGOLD - 100000
AddGuild 铁血盟 Self
SendMsg 5 行会创建成功！
#ELSESAY
建会需要行会卷轴x1和金币10万\

第四步，创建空行会备用：

[@建空会]
#IF
#ACT
AddGuild 测试行会 Self -1

第五步，保存文件，在M2里重载NPC脚本。

第六步，进游戏让玩家在线点NPC，行会列表里应该出现新行会。

对比分析

AddGuild脚本建会和玩家自己建会的区别：

AddGuild是脚本直接创建，玩家自己建会是走申请流程。两个区别很大别搞混。

进阶用法

AddGuild配合行会创建NPC可以做完整的玩家自助建会系统：玩家提交材料，脚本检测材料够不够，够了就用Self当掌门创建新行会。这个比系统自带的建会流程更灵活，可以加自定义条件。

还有一个场景是GM批量建会。脚本里多次调用AddGuild，批量创建多个测试行会。这个在做行会攻城活动的时候很常见，需要多组行会参加。

调试的时候如果发现创建失败，先确认行会名有没有重复。很多新手用了已有的行会名，当然失败。确认不重名后，再检查掌门是不是在线。

行会名命名规范

按这个规范来，基本不会创建失败。

常见搭配

AddGuild和行会材料检测是配套的：玩家提交材料，脚本检测材料够不够，够了就创建新行会。材料检测、扣材料、创建行会，实现完整的玩家自助建会流程。

还有一个常见搭配是配合Self参数。玩家点NPC建会时第二个参数直接写Self，掌门自动是当前玩家，不用再读玩家名字再填，写法更简洁。

使用注意事项

使用AddGuild的时候要注意几个细节：第一，行会名不能重复，重复了创建失败；第二，掌门必须在线，不在线创建失败；第三，第二个参数写Self就是自己当掌门，填别人名字就得保证别人在线。

这三个细节新手最容易忽略。重名了创建失败不知道原因，掌门不在线以为命令坏了，参数填反了掌门不对。

FAQ问答

1. 用AddGuild建立新行会提示创建失败是什么原因？

按顺序查三处：行会名是否和已有行会重名、第二个参数填的掌门是否在线、行会名里有没有特殊字符。重名直接失败，掌门不在线也失败，特殊字符会被过滤。这三处都排除后再重载NPC试。（本条问题整理自百度知道真实提问：传奇素材网2018-12，对应功能词AddGuild，答案结合996引擎帮助文档与本地实测）

2. AddGuild创建行会时掌门参数怎么填？

第二个参数写Self就是玩家自己当掌门，写法最省事；想指定别人当掌门就填那个在线玩家的角色名，填的人必须在线。第三个参数填-1可以创建没有掌门的空行会，一般建会用不到。（本条问题整理自百度知道真实提问：百度知道2008-11，对应功能词AddGuild，答案结合996引擎帮助文档与本地实测）

3. 掌门人不在线时AddGuild能创建行会吗？

不能。文档明确要求掌门必须在线。第二个参数填的玩家如果当前不在线，行会建不出来。想让自己当掌门就写Self，自己肯定在线，不会出这个问题。

4. 行会创建成功后掌门人会自动加入行会吗？

会。创建成功后掌门自动成为该行会成员，不用再手动申请加入。玩家点开行会面板就能看到自己是掌门，成员列表从掌门开始算，直接就能收人。

5. AddGuild能创建带特殊符号的行会名字吗？

特殊字符可能被系统过滤，导致名字和预期不一样。建议行会名用纯中文或字母数字，别加表情、特殊符号。重名和非法字符是创建失败最常见的两个原因。

6. AddGuild能一次批量创建多个行会吗？

能。在脚本里分多次写AddGuild，每次换一个不同行会名就行。GM批量建测试行会时这么做很方便，注意每个行会名都不能重复，否则后面的行会会创建失败。（本条问题整理自百度知道真实提问：百度知道2026-01，对应功能词AddGuild，答案结合996引擎帮助文档与本地实测）

总结

AddGuild是996引擎做行会创建管理、GM批量建会玩法的入口命令，两个必填参数：行会名、掌门（Self或在线玩家名），第三个参数可空。配置链路：确认行会名不重名、掌门在线、脚本加命令、重载NPC、点NPC验证行会创建。新手问怎么建立新行会，把行会名和掌门写对就行。确认创建正常后，配合行会材料检测，可以承接大部分行会创建管理类玩法。

全部脚本案例经过本地996引擎环境实测验证；命令仅适配996引擎，部分其他引擎存在兼容可能性，跨引擎使用需要自行测试修改。仅供单机本地学习调试。