145
个编辑
更改
脚本
，无编辑摘要
第一张使用脚本的[[自制地图]]是[[完美思维3之场景版]]；
第一张大量应用脚本的自制地图是[[镜花水月]]； 第一张使用脚本开发''“游戏本体以外的新玩法”''的自制地图是[[All-We-Know]]； 使用脚本完全脱离Ballance原有玩法的自制地图有：* [[Flappy Ball]]，其玩法致敬并模仿了经典游戏''[https://zh.wikipedia.org/wiki/Flappy_Bird Flappy_Bird]''。
== 运行原理 ==
== 脚本构造单元 ==
=== Building Block Blocks ===
指“构造单元”，交流时一般简称“BB”。（下文大量使用此术语遂均采用简写表达）
* 行为入口（Behavior In，简BI），每个BB至少有一个行为入口；
* 行为出口（Behavior Out，简BO）；
从BI可激活BB内部的功能，BB使用的外部变量从PI处获取，产生的新变量从PO引出，并存于PO指向的目标地址，BB执行完毕后按条件激活对应的BO，可使之后的BB激活。
没有目标地址的PO会将变量丢失。变量不一定需要一个目标地址，若产生的变量不必要，可以直接丢弃。
导入BB时若与vt版本不兼容，则会出现如下两种情况：
# BB所兼容版本低于vt版本，导入后Debug报错且BB外观显橙黄色。此类BB无法在vt中正常运行，但依旧可以正常用来构造脚本。从Ballance游戏目录下提取出的BB部分只兼容vt2.1，所以写出的脚本无法在vt中运行，却可以在Ballance中运行。
# BB所适用版本高于vt版本，无法正常导入，vt报错。例如：在vt3.5中导入[[vt2obj]]的脚本。
BB可以由[[SDK]]编译得到，这意味着用户可以自定义新BB的行为。不过SDK对应着vt的版本，由于缺少2.1版本的SDK，目前编译的第三方BB无法被Ballance读取使用。
==== 常用Building Blocks ====
* Set Physics Globals
除上面列出的BB以外，还需学会使用Parameter Operation，以对大部分变量进行的快速操作。其功能类似于OP，不过无需逻辑调用，在变量输出区被调用的时候自动执行。目前认为Parameter Operation（详见下文），以对大部分变量进行的快速操作。其功能类似于OP，不过无需逻辑调用，在变量输出被调用的时候自动执行。目前认为Parameter Operation的执行速度略优于OP（待考证）。
=== Parameters Operations ===
指“变量操作”，其功能是对各类变量进行操作，并得到新的变量。
Parameters Operations有两个输入口，一个输出口。右键选择Setting可以调整输入输出的变量类型及操作类型。
输入口可以只使用一个。由于其通过输出口调用的性质，输出口需要连接目标地址。若输出口没有目标地址，则此Parameters Operations无法执行。
由于Parameters Operations不需要行为输入来激活（不同于BB：OP），在其输出口的变量需要被调用时自动执行，因此使得Parameters Operations具有即时性，且可以缩短脚本执行时间（待考证）。
=== Behavior Graph ===
指“行为段”，简称BG。
其外部表现类似于BB，必有至少一个BI，可自行添加PI、PO、BI、BO。其内部由一个或一组BB及其他构造单元组成，相当于将一些构造单元打包封装进行执行。BG本身也属于构造单元，这意味着BG可以嵌套。
BG可以有效减少重复的构造单元段落，使脚本更加简洁明了。其名称可以随意改变，使用好的命名可以使得脚本可读性有较大提升。
=== Comment ===
即“注解”。
Comment不参与脚本的执行，不过它可以很好地标注脚本，增强可读性。当Comment与其他构造单元叠加时会被置于底层。
右键选择“Add Comment”可添加空白的Comment。
== 脚本实现框架 ==
