传奇自定义NPC头顶按钮设置教程

一、功能核心作用

传奇游戏中经常出现玩家扎堆站立、故意遮挡NPC的情况，会让其他玩家无法正常点击NPC交互，严重影响整体游戏体验。而ESP插件自定义NPC头顶按钮功能，就能完美解决这一问题。

该功能的核心逻辑十分简单，当游戏角色移动至NPC4格及以内范围时，系统会自动弹出提前设置好的NPC头顶按钮，玩家点击按钮即可触发对应的NPC交互效果，操作等同于直接点击NPC人物，彻底规避NPC被遮挡无法点击的问题。

二、功能使用前提

自定义NPC头顶按钮功能为ESP插件专属功能，必须搭配集成登录器使用，未适配对应登录器的情况下，该功能无法正常生效，这是功能搭建的基础条件。

三、文件存放路径与编码要求

想要启用NPC头顶自定义按钮功能，需要在指定目录配置专属文本文件，具体存放路径分为通用路径和实操示例路径，方便各位直接套用。
通用存放路径：登录器路径\data\ESP_Npc_Button.txt
实操示例路径：D:\ABC\data\ESP_Npc_Button.txt
文件编码重点要求：新建或修改的ESP_Npc_Button.txt文件，必须将文本编码设置为ANSI格式。若编码格式错误，插件无法读取文件内容，会导致所有NPC头顶按钮设置失效。

四、完整参数详解（可直接套用）

该功能配置文本共包含7个核心参数，参数之间统一使用竖线符号进行分割，多个NPC的配置内容可直接回车换行编写，互不冲突，参数顺序固定，不可颠倒修改。
固定参数格式：NPC名字或通用识别符|wil序号|微调x|微调Y|正常按钮图片序号|点燃按钮图片序号|按下按钮图片序号
各参数详细说明
1、NPC名字或通用识别符：可填写具体NPC名称，精准针对单个NPC生效；填写星号则为全局通用设置，适配地图内所有NPC。
2、wil序号：对应按钮素材文件序号，填写-1时，默认调用esp-b.pak、esp-b1.pak素材文件。
3、微调x：按钮横向位置微调数值，可根据界面显示效果自定义调整，优化按钮摆放位置。
4、微调Y：按钮纵向位置微调数值，搭配横向参数调整，让NPC头顶按钮位置居中美观、不偏移。
5、正常按钮图片序号：NPC未触发悬浮状态时，默认显示的按钮图片素材序号。
6、点燃按钮图片序号：鼠标悬浮在按钮上方时，高亮显示的按钮图片素材序号。
7、按下按钮图片序号：鼠标点击按钮瞬间，触发的按压状态图片素材序号。

五、可直接复制的脚本案例

为方便大家快速搭建功能，整理了通用全局配置和单个NPC专属配置两套可直接套用的脚本，下载修改编码后即可直接使用。
案例1：全地图所有NPC通用配置
*|-1|0|5|1|2|3
释义：适配全部NPC，调用默认素材包，纵向微调5像素，分别对应普通、悬浮、点击三种状态的按钮图片素材。
案例2：单个专属NPC配置（以土城老兵为例）
土城老兵|-1|2|6|4|5|6
释义：仅对土城老兵NPC生效，默认调用插件素材，横向微调2像素、纵向微调6像素，适配专属三套按钮状态图片。

六、配置注意事项

1、所有参数必须严格按照顺序填写，不得缺失、调换顺序，否则配置无法生效。
2、多行配置直接回车换行即可，无需添加多余符号，避免文件解析出错。
3、每次修改文本文件后，需重新保存并确认编码为ANSI，建议重启登录器生效。
4、图片序号需对应自身素材库序号，填写错误会导致按钮显示异常或不显示。