传奇引擎SetStringBlank字符串空格填充功能使用教程

在传奇脚本编写过程中，字符串格式规整、排版优化是脚本调试、界面展示、消息输出的核心基础。SetStringBlank 是传奇引擎中专用的字符串空格填充指令，主要用于给目标字符串前后自动补充指定数量空格，统一文本格式、优化脚本展示效果，是传奇脚本制作中高频实用的基础功能。本文将详细讲解该功能的参数格式…

在传奇脚本编写过程中，字符串格式规整、排版优化是脚本调试、界面展示、消息输出的核心基础。SetStringBlank 是传奇引擎中专用的字符串空格填充指令，主要用于给目标字符串前后自动补充指定数量空格，统一文本格式、优化脚本展示效果，是传奇脚本制作中高频实用的基础功能。本文将详细讲解该功能的参数格式、使用规则、字节计算方式及实操案例，助力传奇脚本开发者快速上手运用。

一、SetStringBlank功能核心作用

该功能核心用于给字符串前端或后端自动增加指定个数空格，无需手动输入空格，可精准控制整体字符串长度，解决传奇脚本中文本排版错乱、长度不统一、消息展示参差不齐等问题，广泛应用于传奇游戏消息推送、界面文本排版、变量格式统一等各类脚本场景。

二、SetStringBlank标准格式

SetStringBlank 变量(S,A) 长度(1-100) 格式(0, 1)

三、功能参数详细说明

1. 变量参数

支持两种变量类型，适配传奇脚本常规变量逻辑，分别为人物S变量、全局A变量，可根据脚本场景灵活选用，兼容性覆盖绝大多数传奇引擎版本。

2. 长度参数（1-100）

长度参数为增加空格后整个字符串的最终总长度，并非需要补充的空格数量，这是该指令最核心的使用要点。系统会自动对比原字符串长度与设定目标长度，差值部分自动补充对应数量空格。参数取值范围为1-100，满足传奇脚本绝大多数文本排版需求。

3. 格式参数（0,1）

格式参数控制空格填充位置，仅两个可选值，规则简单清晰：0代表在字符串前端补充空格，1代表在字符串后端补充空格。

四、字节长度计算规则

传奇引擎对字符串字节占用有明确判定标准，精准掌握该规则，才能精准把控空格填充效果，避免排版偏差：

1. 英文字母、数字：单个字符占用1个字节长度；

2. 汉字：单个汉字占用2个字节长度。

实操示例：“gameofmir引擎”字符串原生总长度为13，若将长度参数设置为20，系统会自动计算差值，为字符串补充7个空格，完美适配设定的目标总长。

五、传奇脚本实操案例

以下为可直接复制使用的完整脚本代码，分别演示字符串前端空格填充、后端空格填充两种场景，适配全系传奇引擎，可直接测试运行。

[@Test]

#IF

#ACT

MOV S10 gameofmir引擎

SetStringBlank <$STR(S10)> 20 0

SendMsg 5 <$STR(S10)>

MOV S10 gameofmir引擎

SetStringBlank <$STR(S10)> 20 1

SendMsg 5 <$STR(S10)>

案例解析：两段脚本均以“gameofmir引擎”为基础字符串，设定目标总长度20。第一段格式参数为0，在字符串前端补满空格；第二段格式参数为1，在字符串后端补满空格，最终通过SendMsg指令输出规整统一的文本内容。

六、功能使用注意要点

1. 长度参数严格限定1-100区间，超出区间会导致指令失效，脚本无法正常执行；

2. 区分中英文、数字字节占用差异，切勿统一按单字节计算，避免长度设置偏差；

3. 人物变量与全局变量可自由适配，批量排版场景优先使用全局变量，单人物文本排版使用人物变量。