传奇脚本输入指令编写规范与自定义标题配置教程
在传奇私服开发、插件定制与脚本调试过程中，输入指令编写是基础核心模块，涵盖数字输入、字符录入、消息过滤、自定义标题设置等核心功能。规范编写脚本指令，能够提升传奇服务端运行稳定性，减少插件报错问题，同时助力开发者快速完成交互逻辑配置，是传奇技术从业者必备的基础技能。本文结合常用脚本语法，详解传奇输入指…
在传奇私服开发、插件定制与脚本调试过程中，输入指令编写是基础核心模块，涵盖数字输入、字符录入、消息过滤、自定义标题设置等核心功能。规范编写脚本指令，能够提升传奇服务端运行稳定性，减少插件报错问题，同时助力开发者快速完成交互逻辑配置，是传奇技术从业者必备的基础技能。本文结合常用脚本语法，详解传奇输入指令的编写格式、参数配置与避坑要点。
一、传奇脚本基础输入模块分类
传奇服务端脚本中，用户交互输入模块主要分为整数输入与字符串输入两大类型，两类模块语法结构相近，但参数校验逻辑、适用场景存在明确区分，适配不同的游戏功能配置需求。
1.1 整数输入模块
整数输入模块专属用于接收玩家或后台输入的纯数字参数，常见于等级设置、元宝数量、坐标参数、权限编号等数值类配置，核心标识为InPutInteger，脚本调用格式固定，无多余字符冗余。
基础调用语法：请输入数字X<输入/@@InPutIntegerX>，其中末尾数字为自定义编号，用于区分多个整数输入端口，服务端可通过编号识别不同数值参数。
1.2 字符串输入模块
字符串输入模块用于接收文字、符号、混合字符类参数，适配角色名称、公告文案、权限备注、自定义文本等场景，核心标识为InPutString，支持中英文、特殊符号组合录入。
基础调用语法：请输入字符X<输入/@@InPutStringX>，该模块无数值范围限制，仅受插件内置字符长度规则约束，灵活性高于整数输入模块。
二、输入指令回显语法标准写法
回显指令是传奇脚本的关键组成，作用是将用户输入的内容反馈至后台或游戏界面，确认录入信息生效，所有输入模块均需搭配#SAY指令完成内容输出，语法统一规整。
2.1 整数输入回显配置
针对InPutInteger整数输入端口，需单独配置对应回显节点，通过STR函数调取录入数值，完整可直接复用的脚本代码如下：
[@InPutInteger1]
#SAY
你输入的数字1是<$STR(N1)>\
[@InPutInteger2]
#SAY
你输入的数字2是<$STR(N2)>\
上述代码中，N1、N2为整数参数变量，与输入端口编号一一对应，反斜杠为脚本换行标识，不可省略，否则会造成后台排版错乱。
2.2 字符串输入回显配置
字符串输入回显逻辑与整数一致，仅变量标识替换为S系列，适配文本内容调取，标准脚本代码如下：
[@InPutString1]
#SAY
你输入的字符1是<$STR(S1)>\
[@InPutString2]
#SAY
你输入的字符2是<$STR(S2)>\
字符串变量S1、S2可直接调取含特殊符号的录入内容，无需额外转义，适配传奇公告、角色备注等自定义文本场景。
三、插件消息过滤模块配置
传奇插件内置消息过滤机制，用于拦截违规字符、敏感词汇输入，规避游戏违规内容传播、脚本报错等问题，[@MsgFilter]为专属过滤触发节点，是商用脚本必备防护模块。
3.1 过滤模块触发逻辑
当用户录入的字符内容命中插件内置敏感词列表、非法符号库时，脚本自动跳转至该节点，终止参数录入并推送提示信息，阻断违规内容写入服务端配置文件。
3.2 标准过滤脚本代码
[@MsgFilter] ;如果用户输入的信息在插件消息过滤列表中就会调转到这个字段
#SAY
输入的字符非法
开发者可自定义修改#SAY后的提示文案，比如替换为含违禁字符、禁止输入敏感词等，适配不同版本传奇的风控需求。
四、脚本自定义标题配置技巧
自定义标题用于修改输入弹窗、后台展示栏目的显示名称，优化玩家操作体验与后台管理辨识度，无需新增脚本节点，直接在基础输入指令后追加Title参数即可实现。
4.1 标题参数语法规则
Title参数直接挂载在输入指令尾部，通过等号关联自定义文本，仅支持常规中文、数字组合，无需添加特殊分隔符号，语法简洁不易报错。
4.2 可复用自定义标题脚本
自定义标题：
请输入数字1<输入/@@InPutInteger1|Title=我是标题>
该配置生效后，游戏内输入弹窗将不再显示默认提示文字，替换为设置的自定义标题，适合定制化版本传奇的界面优化需求。
五、传奇脚本编写核心注意事项
5.1 所有脚本节点标识必须唯一，[@]包裹的节点名称不可重复，避免服务端读取脚本时出现跳转错乱、指令失效问题。
5.2 换行标识反斜杠需精准添加在#SAY指令末尾，遗漏后会导致多行内容合并显示，影响后台与游戏界面的排版观感。
5.3 消息过滤列表需定期更新，结合传奇行业合规要求添加新增敏感词汇，降低服务器风控处罚风险。
5.4 自定义标题文本长度建议控制在2-7个汉字之间，适配弹窗显示尺寸，避免文字溢出导致界面错位。
