传奇新NPC界面文字按钮配置教程 新旧界面兼容规范

本文详解传奇新NPC界面与老界面兼容规则，提供通用文字按钮代码模板，全面解析按钮素材、文字、交互、提示等全部参数，标注配置避坑要点，帮助玩家和开发者快速完成传奇NPC界面按钮规范化配置。…

一、传奇NPC界面核心兼容规则

传奇服务端NPC界面存在新旧两种编写架构，核心兼容原则为单界面唯一性适配。单个NPC界面仅可采用新面板写法或老界面写法其中一种，严禁同一界面混合两种编写模式，否则会出现按钮失效、界面闪退、素材错位等BUG。

启用新NPC面板功能前置配置：登录M2服务端，依次进入客户端控制、页面显示设置板块，勾选启用新NPC面板写法选项，保存配置后重启服务端生效。未完成该配置时，所有新UI按钮代码将无法正常加载。

二、新NPC界面文字按钮基础代码模板

以下为传奇新UI专用文字按钮可直接复用的标准代码，适配NewopUI专属素材架构，参数可根据界面布局自定义修改：

<Button|wil=NewopUI|pcnimg=140|pcmimg=140|pcpimg=143|text=按钮文字|color=255|size=12|width=80|height=30|link=@触发>

三、按钮代码全参数详细解析

本段拆解新NPC界面Button按钮全部参数属性，精准适配传奇UI素材排版需求，所有参数区分大小写，填写时需严格规范格式：

3.1 素材定位参数

wil：指定按钮关联的素材文件名称，新NPC界面统一默认调用NewopUI素材包，不可替换为老界面素材文件名。

pcnimg：按钮常态显示素材序号，对应wil文件内默认状态图片ID。

pcmimg：鼠标悬停按钮素材序号，鼠标悬浮时切换显示的图片ID，用于区分交互状态。

pcpimg：鼠标按下按钮素材序号，点击按钮瞬间切换的图片ID，强化点击反馈效果。

3.2 文字样式参数

text：按钮展示的自定义文字内容，支持中文、数字及符号，无字符数量硬性限制，建议适配按钮宽度避免文字溢出。

color：按钮文字颜色代码，采用传奇标准色值编码，255为纯白色常用基础色。

size：文字字体大小，数值越大字体越醒目，常规界面推荐10-14区间数值。

outline、outlinecolor：分别对应文字描边宽度、描边颜色，用于强化文字对比度，适配深色背景界面。

3.3 状态与交互参数

grey：按钮显示状态控制参数，0为默认正常显示，1为强制灰色禁用状态，常用于未解锁功能按钮。

width、height：按钮控件整体宽高尺寸，单位适配传奇界面像素规范，需与素材尺寸匹配避免拉伸变形。

link：按钮触发指令，填写传奇内置脚本命令，实现点击跳转、功能调用、NPC对话等交互逻辑。

3.4 悬浮提示参数

tips：鼠标悬停时展示的提示备注文字，用于标注按钮功能说明，提升玩家交互体验。

tipsx：提示文本水平偏移数值，调整文字相对鼠标的横向位置，避免遮挡界面元素。

tipsy：提示文本垂直偏移数值，调整文字相对鼠标的纵向位置，优化提示框展示位置。

四、常见配置避坑要点

1、界面写法不可混用：单个NPC脚本内，所有按钮必须统一基于新面板或老面板编写，混用会导致素材加载冲突。

2、M2配置优先级最高：未勾选新NPC面板写法时，即使代码无误，新UI按钮也会直接失效，这是最常见的配置问题。

3、素材序号精准核对：pcnimg、pcmimg、pcpimg参数需匹配wil文件内实际图片ID，序号错误会出现按钮透明、显示错乱问题。

4、参数格式无空格：代码内参数分隔符、赋值位置禁止添加多余空格，否则会造成脚本解析失败。

五、总结

传奇新NPC界面文字按钮配置核心在于界面写法统一与M2前置配置，熟练掌握各参数功能后，可快速自定义界面按钮样式、交互逻辑。遵循本文规范编写脚本，能有效规避界面兼容、素材显示、按钮失效等常见问题，适配各类传奇版本NPC界面改版需求。