传奇新老NPC界面兼容教程 富文本脚本参数详解
本文详解传奇新老NPC界面兼容规则，讲解Text基础文本、RText富文本标签的脚本写法与全参数属性，标注M2服务端必填配置及开发避坑要点，助力传奇开发者快速完成NPC界面定制。…
一、传奇NPC界面核心兼容规则
在传奇版本定制与脚本开发中，NPC界面排版错乱、脚本报错是常见问题，核心诱因多为新老面板写法混用。为保障客户端正常加载、界面显示无异常，开发者需严格遵循官方兼容规范配置面板。
1.1 强制兼容原则
单NPC界面仅可采用一种面板写法，新NPC面板写法与老式界面写法禁止在同一界面内混用，否则会直接导致界面黑屏、按钮失效、脚本不执行等故障。
1.2 服务端必填配置项
使用全新NPC富文本面板功能前，必须完成M2服务端核心配置：依次打开M2→客户端控制→页面显示，勾选启用新NPC面板写法，该配置是所有新脚本指令生效的前置条件。
二、基础Text文本标签脚本用法
Text标签为NPC界面基础文本展示指令，主要用于普通文字展示、点击事件挂载，支持颜色、字号、提示弹窗等基础属性配置，是传奇NPC脚本中使用率最高的基础标签。
2.1 基础调用示例
--<Text|color=xx|size=12|text=测试文本|link=@脚本命令>
--<Text|color=255|size=18|text=测试文本>
--<Text|color=255,254,253|size=12|text=测试文本>
2.2 全参数属性详解
text：界面展示的自定义文本内容，支持常规中文、数字、符号录入
color：文本颜色属性，支持单色与闪烁两种模式；单数值为固定颜色，三色组合格式{255,254,253}可实现文字闪烁，默认闪烁间隔1秒
size：字体尺寸，系统限定仅支持14、16、18、20四个固定数值，自定义数值无效
outline、outlinecolor：分别控制文本描边宽度与描边颜色，用于强化文字视觉层次感
tips：鼠标悬停时展示的备注提示文字，用于功能说明、道具注释等场景
tipsx、tipsy：提示文本的X轴、Y轴偏移量，用于微调弹窗提示的展示位置，避免遮挡界面元素
link：文本单击触发的脚本命令，该参数必须放置在标签所有属性的最后一位
simplenum：数值简化功能，填写1时生效，超大数值自动换算单位（超万显示万、超亿显示亿），适配战力、金额等数据展示
scrollWidth、scrollHeight：文本滚动区域的宽度与高度，限定滚动内容的展示范围
scrollWay：文字滚动方向，0代表从右至左，1代表从下至上
scrollTime：滚动动画时长，单位为秒，数值越大滚动速度越慢
三、高级RText富文本标签脚本用法
RText富文本标签是新NPC面板的核心高级功能，支持单段文字多色渐变、精准坐标定位，可实现炫酷标题、渐变公告、高亮数据展示，仅在启用新NPC面板写法后可正常使用。
3.1 富文本调用示例
--<RText|x=140|y=75|color=70|size=20|text=<我是/FCOLOR=250><富文本/FCOLOR=251><996/FCOLOR=253>>
3.2 核心参数说明
x、y：富文本在NPC界面的精准坐标，用于自定义文字摆放位置，摆脱默认排版限制
text：富文本内容，内置/FCOLOR参数可实现同文本多颜色分段渐变效果
size、color：基础字体大小与全局底色，字号遵循通用规则，仅支持指定固定数值
scroll系列参数：包含滚动区域宽高、滚动方向、滚动时长，功能与Text标签一致，用于制作滚动公告、动态提示文本
tipsx、tipsy、tips：鼠标悬停提示配置，功能同基础文本标签，适配富文本元素的注释需求
四、开发常见避坑要点
第一，确认M2配置生效后再编写富文本脚本，未勾选启用新NPC面板写法时，RText标签会直接被客户端忽略；
第二，所有link点击参数必须置于标签末尾，参数顺序错误会导致点击事件失效；
第三，字体size严格按照系统指定数值填写，非规范数值会被客户端强制重置为默认字号；
第四，三色闪烁颜色格式必须使用英文逗号分隔，中文标点会造成脚本解析失败。
