传奇M2引擎自定义输入框脚本教程 新旧NPC界面兼容设置
摘要：本文详解传奇M2引擎自定义输入框脚本使用方法，说明新旧NPC界面兼容规则、M2引擎前置配置步骤，解析Input标签全部参数功能，提供可直接运行的成品脚本案例，汇总常见报错避坑要点，帮助传奇服主快速配置NPC录入功能。…
一、前置核心兼容说明
传奇M2引擎自定义输入框功能支持新NPC界面与传统老写法界面双模式兼容，核心运行原则为单个NPC界面仅可使用一种写法，禁止同一界面混合新旧面板代码，混用会导致界面加载报错、输入功能失效、脚本不执行等问题。
启用自定义输入框功能前，必须完成引擎基础配置：登录M2服务端，依次打开【客户端控制】-【页面显示】，勾选启用新NPC面板写法，未勾选该选项时，所有自定义输入框脚本将无法正常渲染显示。
二、自定义输入框基础标签详解
自定义输入框核心调用标签为Input标签，是传奇NPC界面实现玩家文本、数字、密码录入的核心脚本指令，完整基础格式如下：
<Input|inputid=xx|type=xx|width=xx|height=xx|color=xx|size=xx|mincount=xx|maxcount=xx|errortips=xx>
2.1 全部参数功能释义
Input标签内置多项可配置参数，覆盖输入样式、内容限制、提示反馈等全维度设置，所有参数释义及取值规范如下：
inputid：输入框唯一ID，取值范围1-9，用于脚本识别、调取对应输入数据，是数据提交的核心标识
type：输入内容类型，限定玩家录入数据格式，取值规范：0=任意文本、1=纯数字、2=密码模式（内容隐藏）、3=净化数字（前置0自动过滤，如输入09自动显示为9）
place：输入框空白占位提示文本，输入框未录入内容时展示，无需求时可留空
placecolor：占位提示文本颜色，填写传奇引擎专属色值代码
width：输入框展示宽度，根据NPC界面布局自定义像素数值
height：输入框展示高度，适配界面排版调整像素数值
color：玩家录入文本的显示颜色，调用引擎标准色值
size：录入文本字体大小，数值越大字体显示越醒目
mincount：最小录入字符数，限制玩家最少输入长度，防止空提交或短字符提交
maxcount：最大录入字符数，限制玩家最多输入长度，避免数据溢出
errortips：输入格式错误提示，玩家录入内容不符合type、字符数量规则时弹窗展示
onlyCh：中文输入限制，取值1=仅允许输入中文，留空或0=不限制输入语种
submitInput：绑定提交的输入框ID，支持多框联合提交，多ID用英文逗号分隔（示例：submitInput=3,4,5）
bgtype：背景框显示开关，取值0=隐藏背景框、1=显示背景框，优化界面视觉效果
2.2 输入数据调取常量
脚本中调取玩家输入内容需使用专属字符常量，固定格式为<$NPCINPUT(X)>，其中X对应Input标签中设置的inputid（1-9），通过该常量可在跳转脚本、弹窗提示、数据判定中调用玩家录入的信息。
三、完整可直接运行脚本案例
以下为传奇服务端可直接导入的自定义输入框成品脚本，包含界面布局、输入框配置、提交反馈全流程，适配新NPC面板写法，复制后可直接写入NPC文本使用。
;自定义输入框触发入口
[@自定义输入框]
#IF
#ACT
#SAY
;界面底层布局与弹窗框架配置
<Img|children={1,2,3,4,5,6,7,8,9,10,11,12}|show=4|bg=1|esc=1|move=1|wil=对话框|pcimg=112|reset=1|scale9l=10|scale9r=10|scale9t=10|scale9b=10>
<Layout|id=1|children={a1}|x=790|y=60|width=50|height=50|color=x|link=@exit>
<Button|id=a1|a=4|percentx=50|percenty=50|wil=对话框|pcnimg=113|pcmimg=113|pcpimg=114|link=@exit>
;核心自定义输入框配置
<Input|x=20|y=40|width=145|height=25|size=18|place=请输入|placecolor=251|errortips=输入不对|mincount=3|color=250|maxcount=15|inputid=1|type=0>
;提交按钮绑定指定输入框ID
<Img|x=80|y=240|wil=对话框|submitInput=1|pcimg=115|grey=1|link=@提交>
;提交后数据反馈逻辑
[@提交]
#IF
#ACT
;向玩家客户端推送录入数据提示
sendmsg 7 本次输入的值：<$NPCINPUT(1)>
四、常见报错避坑要点
第一，界面混用报错，同一NPC脚本内不能同时写入新面板Input标签和传统NPC写法指令，必须统一制式；第二，ID取值报错，inputid与NPCINPUT常量的X值仅限1-9，超出范围无法读取数据；第三，配置漏勾报错，未勾选M2客户端控制中的新NPC面板启用选项，所有自定义输入框将无法加载。
