145
个编辑
更改
脚本
，无编辑摘要
'''脚本'''在 [[Ballance/zh|Ballance]] 方面是指[[游戏文件]]（可使用 [[Virtools/zh|Virtools]] 查看和修改）中的相关脚本，控制着游戏的加载和运行。
脚本可以被加密使得在 Virtools 中查看时仅显示 <code><nowiki>[Script Hidden]</nowiki></code>。查看具体脚本信息需要相应的解密工具，具体参见[[Virtools Script Deobfuscation/zh|Virtools Script Deobfuscation]]。。游戏内部nmo文件全部被加密，通过工具手段可以破解游戏内部的信息、运行机制与逻辑等，也可以将其中的[[脚本#Building Block|BB]]保存提取，放入自制图中使用，不过若需激活需特殊手段，详见下文。
目前常常利用脚本添加[[存档点]]的火苗、[[柱子]]的渐变、[[灯塔]]上灯的影子等。但因脚本控制着游戏的加载和运行，可实现的功能远不止于此。
第一张使用脚本的[[自制地图]]是[[完美思维3之场景版]]；
第一张大量应用脚本的自制地图是[[镜花水月]]； 第一张使用脚本开发''“游戏本体以外的新玩法”''的自制地图是[[All-We-Know]]； 使用脚本完全脱离Ballance原有玩法的自制地图有：* [[Flappy Ball]]，其玩法致敬并模仿了经典游戏''[https://zh.wikipedia.org/wiki/Flappy_Bird Flappy_Bird]''。
== 运行原理 ==
一般替换入脚本内的机关为PH\PS_FourFlames.nmo（出生点盘点火），因为所有关卡都需要一个出生盘点火以保证关卡的正常加载。因此，将其解密后可作为脚本插入地图的通用模板使用。
游戏原本文件中包含了大量vt2.1才可使用的BB，所以此类BB在现有vt版本下无法正常运行。不过Ballance内部保留了vt2.1的加载器，可以运行这类BB。此类BB在高版本vt中表现为橙黄色，导入及复制时会有报错信息：
<code><nowiki>Building Block <XXX> is invalid (no prototype guid) (DLL not here / behavior's guid has changed from the last DLL)</nowiki></code>，其中XXX为BB的名称。
新版的[[制图素材包/飘逸冷星版|素材包]]内附有脚本插入模板的vt工程文件，梨栠的制图模板中自带有一个已经解密的出生盘点火。
== 常用[[BB]] 脚本构造单元 ==
下面列出了常用的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。
== 脚本实现框架 ==
值得注意的是，非物理物件的玩家球不受物理系统的控制，也就是说玩家球的速度会丢失，静止在反物理化时的位置，无法发生任何碰撞，且玩家无法直接控制玩家球运动。所以在进行操作之后，'''务必将玩家球重新物理化'''。重新物理化时需判断玩家球的种类，再根据种类读取Balls.nmo内的相应参数，并使用对应球的物理化[[BB]]进行物理化。
通过此方法操作玩家球会不可避免地使其'''丢失当前速度'''，重新物理化后的玩家球速度为0。
