查看“NPC教导框架”的源代码

{{攻略戳
|文章上级页面=MOD
|时间=20230513
|作者=TierneyJohn
|是否原创=是
|来源=
|原文地址=
}}
<!--这个东西叫做注释,删不删掉都不会影响文章内容!,是灰色高亮,很好辨别.-->
<!-- 此处为编辑模式下的备注信息，不会显示，无需修改，可删除
下方为填写格式示例和备注
{{攻略戳
|文章上级页面=（这里也是自动归类列表使用的分类标签。可自行规定填写范围）
|时间=20200903（文章的创建时间/最后修改时间，用于自动归类文章列表展示）[一定要按照格式来!不要写2021年之类的]
|作者=你的名字（无，则不填）
|是否原创=是（是/否）
|来源=BWIKI（无，则不填）
|原文地址=https://wiki.biligame.com/mcs/ （无，则不填）
}}
-->
__TOC__

==简介==
<br/>
本文是觅长生创意工坊Mod 《NPC教导框架》的使用说明，Mod目前提供了一系列NPC功法神通数据的修改操作。可以方便的定制NPC的装备栏功法神通，请教栏功法神通等。（修改NPC装备栏的功法神通后，NPC打架的时候也会自己释放新增神通哦！）<br/><br/>
另外，这个Mod不会止步于此，还会再后续版本提供更多NPC相关的功能，例如：对NPC行为进行增强、让NPC更加灵活（更像个人）、更多的NPC行为、更多的NPC与玩家的交互等等...但是精力是有限的，开发是漫长的，还请诸位耐心等待后续版本。<br/><br/>
目前文章提供了'''Mod使用方法'''、'''相关指令参数及用法'''的相关内容介绍，以及还会在后续版本添加'''功能定制'''等更多功能的介绍。<br/><br/>
文章本身'''不提供Mod的下载方式'''，相关Mod订阅请移步steam创意工坊：[https://steamcommunity.com/sharedfiles/filedetails/?id=2975033056 创意工坊地址]<br/><br/>

当前文章对应版本为'''v1.1.0'''<br/>

==Mod 相关使用教程==
<br/>
===玩家使用教程===
<br/>
作为游戏玩家，仅需要在创意工坊中订阅该Mod，同时确保在游戏中同时启用了当前Mod和Next前置Mod，即可获得相关的功能。只不过，Mod目前版本尚未提供游戏内置得教导NPC功能，该部分内容正在抓紧制作中。<br/><br/>
如果您希望在目前版本也能够自定义修改NPC的功法神通的话，可以使用Next编辑器提供的游戏内置工具，通过调用指令来完成相关修改操作。但是由于目前仅仅是早期版本，相关数据处理的优化还不到位，所以还请尽量避免对同一个NPC数据进行反复变更操作，以防出现游戏性能下降问题。<br/><br/>
当然，您也可以查找其他使用了该Mod作为前置的其他Mod，要相信其他的Mod作者能制作出更加贴合故事剧情设定的，Npc教导玩法。<br/><br/>
如果您有更多的契合"NPC教导框架"设计初衷的新奇的创意、功能、玩法，也请可以随时向我反馈，我会在精力以及个人能力的范围内，尽量满足大家的需求的。<br/>
<br/><br/>
===Mod制作者使用教程===
<br/>
作为Mod制作者，相信您已经有了一定的Mod制作经验了。当前"NPC教导框架"为了方便广大作者使用，封装了一系列的Next指令方便进行功能调用，您可以在本文的"Next指令扩展"中，查找满足您需求的指令来丰富您自己的Mod内容。<br/><br/>
另外，Mod后续版本会将Next相关功能扩展进行分离（对于使用上是没有区别的，不会产生任何影响），届时将不再硬性依赖Next框架，而是当检测到Next前置存在时进行相关功能增强。这样可以对于一些特殊的场景提供更加高性能的处理。<br/><br/>
如果您是一个熟练Mod作者,也可以直接通过C#访问"NPC教导框架"内提供的相关'''Manager'''方法，来实现一些定制化的操作。甚至可以基于"NPC教导框架"进行一定的魔改（但要注意不要影响其他人使用），以实现一些特殊的效果。<br/><br/>
但是如果您希望在Lua或者JavaScript中使用CS对象进行访问的话，可能会因为某些原因导致部分方法无法正常调用，后续版本中计划提供专门的API接口，方便直接引用提供的C#方法。<br/><br/>
当然，如果您有更多的契合"NPC教导框架"设计初衷的指令需求、功能需求、玩法需求，也可以随时向我反馈，我也会及时进行相关内容填充的。<br/>

==Next 指令扩展==

===Next Event 指令扩展===

{| class="wikitable col-fold" style="width:100%;margin-top:5px;font-size:12px"
|+ Next Event 指令指令扩展 [蓝色指令为 Lua 或 JavaScript 中的使用方式]
|-
! style=width:35% | Event指令
! style=width:30% | 参数说明
! style=width:35% | 指令说明
|-
| NpcChangeSex*NPC编号#性别类型<br/><br/><font color=blue>runner.NpcChangeSex(NPC编号, 性别类型)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''性别类型:'''&nbsp;根据觅长生原版设定，总共有三种对应的类型<br/><br/>1:&nbsp;男<br/>2:&nbsp;女<br/>3:&nbsp;未知<br/><br/>
| '''修改指定NPC的性别'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的性别类型还请输入正确的数据，如若输入错误也会有相应的提示日志。<br/><br/>
|-
| NpcChangeSkill*NPC编号#执行模式#神通编号一#神通编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeSkill(NPC编号, 执行模式, 神通编号一, 神通编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加神通编号一中的数据<br/>DELETE:&nbsp;移除NPC神通编号一中的数据<br/>CHANGE:&nbsp;将npc神通装备栏中，神通编号一中的数据替换为神通编号二中的数据<br/><br/>'''神通编号一:'''&nbsp;神通唯一编号<br/><br/>'''神通编号二:'''&nbsp;神通唯一编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的装备栏中的神通数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>神通编号需要传入神通唯一编号，因为官方设定神通会根据对应NPC等级进行调整，所以需要使用唯一编号。<br/><br/>神通编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| NpcChangeStaticSkill*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeStaticSkill(NPC编号, 执行模式, 功法编号一, 功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc功法装备栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法固定编号<br/><br/>'''功法编号二:'''&nbsp;功法固定编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的装备栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令需要输入功法的固定编号，因为官方设定功法是不会随NPC等级自动改变的，所以只能指定特定的功法编号才行。包括移除和修改操作，也要确认原本的具体编号是多少才能正确执行<br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| NpcChangeAutoStaticSkill*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeAutoStaticSkill(NPC编号, 执行模式, 功法编号一, 功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc功法装备栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法编号<br/><br/>'''功法编号二:'''&nbsp;功法编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的装备栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令使用时较为特殊，因为官方设定功法是不会随NPC等级自动改变的，所以如果希望添加符合NPC境界的功法的话，需要做一些额外处理，因此提供了这个功能和'''NpcChangeStaticSkill'''相似的指令，可以通过输入功法唯一编号给NPC添加符合其对应境界的功法数据。但由于进行了模式匹配的简化，所以在数据输入时需要注意。<br/>对于ADD模式，可以通过在'''功法编号一'''中输入功法唯一编号进行动态添加<br/>对于DELETE模式，则只能可以通过在'''功法编号一'''中输入相应的功法固定编号进行删除(后续会提供动态删除操作)<br/>对于CHANGE模式，则需要在'''功法编号一'''中输入相应的功法固定编号（后续会提供动态查询）并在'''功法编号二'''中输入功法唯一编号，才能执行动态功法添加操作<br/><br/><font color=green>相对来说，目前提供的AUTO指令使用起来非常复杂，强烈建议配合其他查询指令，先获取对应的数据后，再进行相应的数据修改操作</font><br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| NpcChangeAskSkill*NPC编号#执行模式#神通编号一#神通编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeAskSkill(NPC编号, 执行模式, 神通编号一, 神通编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加神通编号一中的数据<br/>DELETE:&nbsp;移除NPC神通编号一中的数据<br/>CHANGE:&nbsp;将npc请教神通栏中，神通编号一中的数据替换为神通编号二中的数据<br/><br/>'''神通编号一:'''&nbsp;神通唯一编号<br/><br/>'''神通编号二:'''&nbsp;神通唯一编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的请教神通栏中的神通数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>神通编号需要传入神通唯一编号，因为官方设定神通会根据对应NPC等级进行调整，所以需要使用唯一编号。<br/><br/>神通编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| NpcChangeAskStaticSkill*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeAskStaticSkill(NPC编号, 执行模式, 功法编号一, 功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc请教功法栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法固定编号<br/><br/>'''功法编号二:'''&nbsp;功法固定编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的请教功法栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令需要输入功法的固定编号，因为官方设定功法是不会随NPC等级自动改变的，所以只能指定特定的功法编号才行。包括移除和修改操作，也要确认原本的具体编号是多少才能正确执行<br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| NpcChangeAutoAskStaticSkill*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.NpcChangeAutoAskStaticSkill(NPC编号, 执行模式, 功法编号一, 功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc请教功法栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法编号<br/><br/>'''功法编号二:'''&nbsp;功法编号，若当前执行模式不是change，则可以省略不写
| '''修改指定NPC的请教功法栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令使用时较为特殊，因为官方设定功法是不会随NPC等级自动改变的，所以如果希望添加符合NPC境界的功法的话，需要做一些额外处理，因此提供了这个功能和'''NpcChangeAskStaticSkill'''相似的指令，可以通过输入功法唯一编号给NPC添加符合其对应境界的功法数据。但由于进行了模式匹配的简化，所以在数据输入时需要注意。<br/>对于ADD模式，可以通过在'''功法编号一'''中输入功法唯一编号进行动态添加<br/>对于DELETE模式，则只能可以通过在'''功法编号一'''中输入相应的功法固定编号进行删除(后续会提供动态删除操作)<br/>对于CHANGE模式，则需要在'''功法编号一'''中输入相应的功法固定编号（后续会提供动态查询）并在'''功法编号二'''中输入功法唯一编号，才能执行动态功法添加操作<br/><br/><font color=green>相对来说，目前提供的AUTO指令使用起来非常复杂，强烈建议配合其他查询指令，先获取对应的数据后，再进行相应的数据修改操作</font><br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| ClearNpcOperate*NPC编号<br/><br/><font color=blue>runner.ClearNpcOperate(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>
| '''清空指定NPC的操作指令集'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>目前所有的NPC数据修改操作，都会记录在对应的指令集中，以便在数据变动时可以及时更新数据，改指令可以清空先前缓存的操作指令<br/><br/>建议在复杂的数据操作之前，或者Mod更新时，进行一定的指令清空操作，以防数据更新后可能导致的老存档数据混乱问题<br/><br/>
|-
| ClearAllOperate*<br/><br/><font color=blue>runner.ClearNpcOperate()</font>
| 
| '''清空所有操作指令集'''<br/><br/>改指令会清空所有的缓存操作指令，且该操作不可逆，使用时请多加注意<br/><br/>目前所有的NPC数据修改操作，都会记录在对应的指令集中，以便在数据变动时可以及时更新数据，改指令可以清空先前缓存的操作指令<br/><br/>建议在复杂的数据操作之前，或者Mod更新时，进行一定的指令清空操作，以防数据更新后可能导致的老存档数据混乱问题<br/><br/>
|-
| Npc性别修改*NPC编号#性别类型<br/><br/><font color=blue>runner.NpcChangeSex(NPC编号, 性别类型)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''性别类型:'''&nbsp;根据觅长生原版设定，总共有三种对应的类型<br/><br/>1:&nbsp;男<br/>2:&nbsp;女<br/>3:&nbsp;未知<br/><br/>
| '''该方法同 NpcChangeSex'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的性别'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的性别类型还请输入正确的数据，如若输入错误也会有相应的提示日志。<br/><br/>
|-
| Npc神通修改*NPC编号#执行模式#神通编号一#神通编号二(可省略)<br/><br/><font color=blue>runner.Npc神通修改(NPC编号, 执行模式, 神通编号一,神通编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加神通编号一中的数据<br/>DELETE:&nbsp;移除NPC神通编号一中的数据<br/>CHANGE:&nbsp;将npc神通装备栏中，神通编号一中的数据替换为神通编号二中的数据<br/><br/>'''神通编号一:'''&nbsp;神通唯一编号<br/><br/>'''神通编号二:'''&nbsp;神通唯一编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的装备栏中的神通数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>神通编号需要传入神通唯一编号，因为官方设定神通会根据对应NPC等级进行调整，所以需要使用唯一编号。<br/><br/>神通编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| Npc功法修改*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.Npc功法修改(NPC编号, 执行模式, 功法编号一,功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc功法装备栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法固定编号<br/><br/>'''功法编号二:'''&nbsp;功法固定编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeStaticSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的装备栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令需要输入功法的固定编号，因为官方设定功法是不会随NPC等级自动改变的，所以只能指定特定的功法编号才行。包括移除和修改操作，也要确认原本的具体编号是多少才能正确执行<br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| Npc功法修改自动版*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.Npc功法修改自动版(NPC编号, 执行模式, 功法编号一,功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc功法装备栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法编号<br/><br/>'''功法编号二:'''&nbsp;功法编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeAutoStaticSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的装备栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令使用时较为特殊，因为官方设定功法是不会随NPC等级自动改变的，所以如果希望添加符合NPC境界的功法的话，需要做一些额外处理，因此提供了这个功能和'''NpcChangeStaticSkill'''相似的指令，可以通过输入功法唯一编号给NPC添加符合其对应境界的功法数据。但由于进行了模式匹配的简化，所以在数据输入时需要注意。<br/>对于ADD模式，可以通过在'''功法编号一'''中输入功法唯一编号进行动态添加<br/>对于DELETE模式，则只能可以通过在'''功法编号一'''中输入相应的功法固定编号进行删除(后续会提供动态删除操作)<br/>对于CHANGE模式，则需要在'''功法编号一'''中输入相应的功法固定编号（后续会提供动态查询）并在'''功法编号二'''中输入功法唯一编号，才能执行动态功法添加操作<br/><br/><font color=green>相对来说，目前提供的AUTO指令使用起来非常复杂，强烈建议配合其他查询指令，先获取对应的数据后，再进行相应的数据修改操作</font><br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| Npc请教神通修改*NPC编号#执行模式#神通编号一#神通编号二(可省略)<br/><br/><font color=blue>runner.Npc请教神通修改(NPC编号, 执行模式, 神通编号一,神通编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加神通编号一中的数据<br/>DELETE:&nbsp;移除NPC神通编号一中的数据<br/>CHANGE:&nbsp;将npc请教神通栏中，神通编号一中的数据替换为神通编号二中的数据<br/><br/>'''神通编号一:'''&nbsp;神通唯一编号<br/><br/>'''神通编号二:'''&nbsp;神通唯一编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeAutoStaticSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的请教神通栏中的神通数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>神通编号需要传入神通唯一编号，因为官方设定神通会根据对应NPC等级进行调整，所以需要使用唯一编号。<br/><br/>神通编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| Npc请教功法修改*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.Npc请教功法修改(NPC编号, 执行模式, 功法编号一,功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc请教功法栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法固定编号<br/><br/>'''功法编号二:'''&nbsp;功法固定编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeAutoStaticSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的请教功法栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令需要输入功法的固定编号，因为官方设定功法是不会随NPC等级自动改变的，所以只能指定特定的功法编号才行。包括移除和修改操作，也要确认原本的具体编号是多少才能正确执行<br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| Npc请教功法修改自动版*NPC编号#执行模式#功法编号一#功法编号二(可省略)<br/><br/><font color=blue>runner.Npc请教功法修改自动版(NPC编号, 执行模式, 功法编号一,功法编号二(可省略))</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''执行模式:'''&nbsp;目前提供有三种模式，可以根据输入决定实现的效果<br/><br/>ADD:&nbsp;给NPC添加功法编号一中的数据<br/>DELETE:&nbsp;移除NPC功法编号一中的数据<br/>CHANGE:&nbsp;将npc请教功法栏中，功法编号一中的数据替换为功法编号二中的数据<br/><br/>'''功法编号一:'''&nbsp;功法编号<br/><br/>'''功法编号二:'''&nbsp;功法编号，若当前执行模式不是change，则可以省略不写
| '''该方法同 NpcChangeAutoStaticSkill'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''修改指定NPC的请教功法栏中的功法数据'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>其中的操作模式输入大小写均可，如若模式输入错误也会有相应的提示日志。<br/><br/>该指令使用时较为特殊，因为官方设定功法是不会随NPC等级自动改变的，所以如果希望添加符合NPC境界的功法的话，需要做一些额外处理，因此提供了这个功能和'''NpcChangeAskStaticSkill'''相似的指令，可以通过输入功法唯一编号给NPC添加符合其对应境界的功法数据。但由于进行了模式匹配的简化，所以在数据输入时需要注意。<br/>对于ADD模式，可以通过在'''功法编号一'''中输入功法唯一编号进行动态添加<br/>对于DELETE模式，则只能可以通过在'''功法编号一'''中输入相应的功法固定编号进行删除(后续会提供动态删除操作)<br/>对于CHANGE模式，则需要在'''功法编号一'''中输入相应的功法固定编号（后续会提供动态查询）并在'''功法编号二'''中输入功法唯一编号，才能执行动态功法添加操作<br/><br/><font color=green>相对来说，目前提供的AUTO指令使用起来非常复杂，强烈建议配合其他查询指令，先获取对应的数据后，再进行相应的数据修改操作</font><br/><br/>功法编号二中的数据在ADD模式和DELETE模式下是会被忽略的，不论是否传递数据都不会造成影响，但仍然建议不要传入对应数据，以免在优化指令组数据时造成影响。
|-
| 清空Npc指令*NPC编号<br/><br/><font color=blue>runner.ClearNpcOperate(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>
| '''该方法同 ClearNpcOperate'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''清空指定NPC的操作指令集'''<br/><br/>关于NPC编号，如果要修改固定NPC的数据的话，还是建议直接输入NPC的固定编号。这样不仅可以省去查找对应实例编号是多少，也能同步修改固定数据和实例数据，以免出现其他问题。<br/><br/>目前所有的NPC数据修改操作，都会记录在对应的指令集中，以便在数据变动时可以及时更新数据，改指令可以清空先前缓存的操作指令<br/><br/>建议在复杂的数据操作之前，或者Mod更新时，进行一定的指令清空操作，以防数据更新后可能导致的老存档数据混乱问题<br/><br/>
|-
| 清空所有指令*<br/><br/><font color=blue>runner.ClearNpcOperate()</font>
| 
| '''该方法同 ClearAllOperate'''<br/><font color=red>虽然有提供对应的中文指令，但仍然建议使用原指令进行操作</font><br/><br/>'''清空所有操作指令集'''<br/><br/>改指令会清空所有的缓存操作指令，且该操作不可逆，使用时请多加注意<br/><br/>目前所有的NPC数据修改操作，都会记录在对应的指令集中，以便在数据变动时可以及时更新数据，改指令可以清空先前缓存的操作指令<br/><br/>建议在复杂的数据操作之前，或者Mod更新时，进行一定的指令清空操作，以防数据更新后可能导致的老存档数据混乱问题<br/><br/>
|}

===Next Env 指令扩展===

{| class="wikitable col-fold" style="width:100%;margin-top:5px;font-size:12px"
|+ Next Env 指令指令扩展 [蓝色指令为 Lua 或 JavaScript 中的使用方式]
|-
! style=width:35% | Env指令
! style=width:30% | 参数说明
! style=width:35% | 指令说明
|-
| [&NpcDataInquire(NPC编号, 数据类型)&]<br/><br/><font color=blue>env:NpcDataInquire(NPC编号， 数据类型)</font>
| '''NPC编号:'''&nbsp;需要查询的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''数据类型:'''&nbsp;目前提供了一系列的数据可供查询，目前支持的数据列表如下<br/><br/>Name:&emsp;获取当前NPC的名称<br/>Title:&emsp;获取当前NPC的称号<br/>SexType:&emsp;获取当前NPC的性别<br/>Level:&emsp;获取当前NPC的等级（小境界等级）<br/>BigLevel:&emsp;获取当前NPC的等级(大境界等级)<br/>HP:&emsp;获取当前NPC的原始血量<br/>DunSu:&emsp;获取当前NPC的原始遁速<br/>ZiZhi:&emsp;获取当前NPC的原始资质<br/>WuXing:&emsp;获取当前NPC的原始悟性<br/>ShenShi:&emsp;获取当前NPC的原始神识<br/>ShouYuan:&emsp;获取当前NPC的原始寿元<br/>Age:&emsp;获取当前NPC的年龄<br/>Sect:&emsp;获取当前NPC的所在门派<br/>LiuPai:&emsp;获取当前NPC的流派编号<br/>LingGen:&emsp;获取当前NPC的灵根数据<br/>Skills:&emsp;获取当前NPC的装备栏中的所有神通数据<br/>StaticSkills:&emsp;获取当前NPC的装备栏中的所有功法数据<br/>AskSkills:&emsp;获取当前NPC的请教神通栏中的所有神通数据<br/>AskStaticSkills:&emsp;获取当前NPC的请教神通栏中的所有功法数据
| '''获取指定NPC的相关数据'''<br/><br/>关于数据类型的填写，只需要正确填写对应的文本即可查询，所有的数据文本均不区分大小写
|-
| [&GetNpcSkills(NPC编号)&]<br/><br/><font color=blue>env:GetNpcSkills(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可
| '''获取指定NPC的装备栏中的所有神通数据'''<br/><font color=red>该指令将在未来版本弃用，请使用 '''NpcDataInquire''' 指令</font>
|-
| [&GetNpcStaticSkills(NPC编号)&]<br/><br/><font color=blue>env:GetNpcStaticSkills(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可
| '''获取指定NPC的装备栏中的所有功法数据'''<br/><font color=red>该指令将在未来版本弃用，请使用 '''NpcDataInquire''' 指令</font>
|-
| [&GetNpcAskSkills(NPC编号)&]<br/><br/><font color=blue>env:GetNpcAskSkills(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可
| '''获取指定NPC的请教神通栏中的所有神通数据'''<br/><font color=red>该指令将在未来版本弃用，请使用 '''NpcDataInquire''' 指令</font>
|-
| [&GetNpcAskStaticSkills(NPC编号)&]<br/><br/><font color=blue>env:GetNpcAskStaticSkills(NPC编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可
| '''获取指定NPC的请教功法栏中的所有功法数据'''<br/><font color=red>该指令将在未来版本弃用，请使用 '''NpcDataInquire''' 指令</font>
|-
| [&NpcHasSkill(NPC编号, 神通编号)&]<br/><br/><font color=blue>env:NpcHasSkill(NPC编号, 神通编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''神通编号:'''&nbsp;神通唯一编号
| '''获取指定NPC的装备栏中的所有神通数据'''<br/><br/><font color=green>相关参数列表可能描述不准确，具体数据以'''GetNpcSkills'''指令获取到的数据为准</font>
|-
| [&NpcHasStaticSkill(NPC编号, 功法编号)&]<br/><br/><font color=blue>env:NpcHasStaticSkill(NPC编号, 功法编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''神通编号:'''&nbsp;功法固定编号
| '''获取指定NPC的装备栏中的所有功法数据'''<br/><br/><font color=green>相关参数列表可能描述不准确，具体数据以'''GetNpcStaticSkills'''指令获取到的数据为准</font>
|-
| [&NpcHasAskSkill(NPC编号, 神通编号)&]<br/><br/><font color=blue>env:NpcHasAskSkill(NPC编号, 神通编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''神通编号:'''&nbsp;神通唯一编号
| '''获取指定NPC的请教神通栏中的所有神通数据'''<br/><br/><font color=green>相关参数列表可能描述不准确，具体数据以'''GetNpcAskSkills'''指令获取到的数据为准</font>
|-
| [&NpcHasAskStaticSkill(NPC编号, 功法编号)&]<br/><br/><font color=blue>env:NpcHasAskStaticSkill(NPC编号, 功法编号)</font>
| '''NPC编号:'''&nbsp;需要修改的NPC的编号，传入NPC固定编号和NPC实例编号均可<br/><br/>'''神通编号:'''&nbsp;功法固定编号
| '''获取指定NPC的请教功法栏中的所有功法数据'''<br/><br/><font color=green>相关参数列表可能描述不准确，具体数据以'''GetNpcAskStaticSkills'''指令获取到的数据为准</font>
|}

==相关代码示例==
<br/>
在该板块我会选取几个常用的剧情指令编写代码示例，同时也会分别提供不同的环境下如何调用相关方法。受篇幅限制仅提供部分指令的示例，其余指令参考使用即可。
<br/>
===Json 文件中指令使用示例===
<syntaxhighlight lang="json" line="1">
[
    {
        "id": "Event事件名称",
        "character": {},
        "dialog": [
            "NpcChangeSex*20003#2",
            "NpcChangeSkill*20003#add#16",
            "NpcChangeSkill*20003#change#27#8",
            "Print*Info#[& NpcDataInquire(20003, \"skills\") &]",
            "Print*Info#[& NpcHasSkill(20003, 16) &]"
        ]
    }
]
</syntaxhighlight></code>

在上述代码中，我总共执行了5次操作，下面我根据所写代码逐行解释各个操作的意义:<br/><br/>
第一行:NpcChangeSex*20003#2 中<br/>
我调用了一个 Event 指令，将实例编号为 20003 的 NPC 的性别修改成女<br/><br/>
第二行:NpcChangeSkill*20003#add#16 中<br/>
我调用了一个 Event 指令，将实例编号为 20003 的 NPC 的装备神通进行了修改，给她添加了一个编号为 16 的神通<br/><br/>
第三行:NpcChangeSkill*20003#change#27#8 中<br/>
我调用了一个 Event 指令，将实例编号为 20003 的 NPC 的装备神通进行了修改，将她自身所装备的 27 号神通替换为 8号神通<br/><br/>
第四行:Print*Info#[&NpcDataInquire(20003, "skills")&] 中<br/>
我调用了一个 Env 指令去获取一个数据，并通过 Event 的 Print 指令将结果打印了出来<br/>
具体的数据内容是获取实例编号 20003 的 NPC 的所有装备神通数据<br/><br/>
第五行:Print*Info#[&NpcHasSkill(20003, 16)&] 中<br/>
我调用了一个 Env 指令去获取一个数据，并通过 Event 的 Print 指令将结果打印了出来<br/>
具体的数据内容是获取实例编号 20003 的 NPC 是否拥有编号为 16 的神通，它会返回一个 bool 类型结果<br/><br/>

===Lua 文件中指令使用示例===
<br/>

示例一、通过 Next 进行指令调用

<code Lua>
 function Test(runner, env)
   runner.NpcChangeSex(20003, 2)
   runner.NpcChangeSkill(20003, "add", 16)
   runner.NpcChangeSkill(20003, "change", 27, 8)
   local skills = env:NpcDataInquire(20003, "skills")
   runner.Print("Info", skills)
   local result = env:NpcHasSkill(20003, 16)
   runner.Print("Info", result)
 end
</code>

在上述代码中，我使用了 Lua 语言进行了相关指令的调用，具体的实现效果和 Json 中说明的是相同的<br/>
不过对于数据打印的操作，我这边并没有写到一起，同样的这里也建议大家尽量不要将多个指令复合然后写到一起<br/><br/>

===C# 文件中指令使用示例===
<br/>

示例一、通过 Next 进行指令调用

<code CSharp>
 public class DemoClass
 {
   public void TestMethod()
   {
     DialogAnalysis.StartTestDialogEvent("NpcChangeSex*20003#2");
     DialogAnalysis.StartTestDialogEvent("NpcChangeSkill*20003#add#16");
     DialogAnalysis.StartTestDialogEvent("NpcChangeSkill*20003#change#27#8");
     // 这里访问 Env 方法有可能会存在问题
     DialogAnalysis.StartTestDialogEvent("Print*Info#[&NpcDataInquire(20003, "skills")&]");
     // 这里访问 Env 方法有可能会存在问题
     DialogAnalysis.StartTestDialogEvent("Print*Info#[&NpcHasSkill(20003, 16)&]");
     
     // 对于 Env 的指令调用，是有另外的操作方式的，但由于稍显复杂所以这里进提供一种简单的实现方式
     // 这种实现方式在自定义的 Env 指令中会比较方便，把相关数据传入即可
     IDialogEnvQuery dialogEnvQuery = DialogAnalysis.GetEnvQuery("NpcDataInquire");
     dialogEnvQuery.Execute(new DialogEnvQueryContext(new DialogEnvironment(), new object[] { 20003, "skills" }));
   }
 }
</code>

上述代码中，使用了 Next 封装的 DialogAnalysis.StartTestDialogEvent 方法来处理一个字符串文本的指令，这种处理方式仅适用于少量且无需关注具体回调的方法。仅提供相关的代码作为演示，并不建议在实际的项目中这样处理指令。

如果你发现 IDE 提示找不到 DialogAnalysis.StartTestDialogEvent 方法，请注意要将 Next.dll 作为你的项目依赖添加进去。

同样的，对于不同的场景也有不同的处理方式，例如直接访问 Next 的指令数据集进行相关指令调用，或者在自己的自定义指令内去进行其他指令调用。针对不同的场景具体的代码实现也有所差异，需要根据实际使用场景去进行修改。因为这里变数过多并不适合全部展示出来。如果您有相关的设计需求可以在Mod制作群中联系我。

示例二、通过教导框架封装的 Manager 管理器调用

<code CSharp>
 public class DemoClass
 {
   public void TestMethod()
   {
     // 因为在 NPC 教导框架中，所有的 NPC 相关操作都是通过一个指令对象去执行的，因此这里需要先创建一个对应的指令对象
     // 这个指令对象中包含了所要执行的操作和相关的数据
     NpcOperateInfo operate1 = new NpcOperateInfo(20003, NpcChangeType.Update, NpcOperate.SexType, 2, 0);
     // 使用 NpcOperateManager 执行指令
     // 因为修改性别的操作只需要修改一次就能生效，所以调用 TryOnlyExecuteOnceOperate 方法
     NpcOperateManager.Inst.TryOnlyExecuteOnceOperate(operate1);
     
     // 同样的封装其余指令数据
     NpcOperateInfo operate2 = new NpcOperateInfo(20003, NpcChangeType.Add, NpcOperate.Skills, 16, 0);
     // 因为觅长生原版游戏的一些特性，对于功法神通数据的修改会在该Npc突破后被流派数据覆盖
     // 所以这里NPC教导框架做了一系列的指令存放、加载、自动执行的相关操作，具体的原理略显复杂，这里不详细展开说明了
     NpcOperateManager.Inst.TryAddAndExecuteOperate(operate2);
     
     // 这里封装了第三条指令，从这里可以看出所有的指令的数据结构是遵守一定的约定的，不同指令之间的变动很小，但却可以实现不同的操作
     NpcOperateInfo operate3 = new NpcOperateInfo(20003, NpcChangeType.Change, NpcOperate.Skills, 27, 8);
     NpcOperateManager.Inst.TryAddAndExecuteOperate(operate3);
     
     // 同样的对于 Env 相关的数据获取，也是通过指令实现的
     NpcOperateInfo operate4 = new NpcOperateInfo(20003, NpcChangeType.Select, NpcOperate.Skills, 0, 0);
     // 这里调用了查询相关的方法，要注意查询指令需要传递数据类型
     List<int> skills = NpcOperateManager.Inst.TryOnlyInquireOnceOperate<List<int>>(operate4);
     Console.WriteLine(skills);
     
     // 最终的查询指令
     NpcOperateInfo operate5 = new NpcOperateInfo(20003, NpcChangeType.Select, NpcOperate.Skills, 0, 0);
     // 这里调用了查询相关的方法，要注意查询指令需要传递数据类型
     List<int> skills = NpcOperateManager.Inst.TryOnlyInquireOnceOperate<List<int>>(operate4);
     Console.WriteLine(skills.Contains(16));
   }
 }
</code>

可以看到在上述代码中，Npc数据相关的操作非常简单，本质是都是通过 NpcOperateInfo 数据来执行的。而对于 NpcOperateManager 来说，内部也提供了很多指令执行模式，这些模式的差异以及 NpcOperateInfo 指令数据的差异，可以通过查看具体代码进行详细了解。这里就不再展开说明了。

如果你发现 IDE 提示找不到相关的类或方法，请注意要将 NPC 教导框架的 dll 作为你的项目依赖添加进去，同时在上传 Mod 是注意将其设置为前置 Mod。

另外，因为本质上所有的数据操作都是基于 NpcOperateInfo 指令数据实现的，因此实际也是有更简单的执行方式的，这部分代码我也同样不在这里详细列举了，相信能看到这里的
也有足够的能力自己进行代码优化处理，或者二次封装调用。