查看“Ballance Mod Loader Gamepiaynmo版（第一版）”的源代码

{{Appbox
|language=zh

|name=Ballance Mod Loader
|author=Gamepiaynmo
|suit=Ballance
|link=[https://tieba.baidu.com/p/3855589369 Ballance吧]
|dependency=

|dateYear=2015
|dateMonth=6
|dateDay=27
}}

== 功能 ==

为Ballance提供更多内容加载的框架。此Ballance Mod Loader之于Ballance，就像Forge之于Minecraft。

可以加载外置插件，自制机关。

== 下载 ==

* [http://gcba.ml GCBA] (工具下载区/Ballance游戏修改/BallanceModLoader.zip，下载解压缩得到BallanceModLoader-Gamepiaynmo.msi)
* [https://mega.nz/#F!CV5SyapR!LbduTW51xmkDO4EDxMfH9w Mega] (Plugin/BallanceModLoader-Gamepiaynmo.msi)

== 相关视频 ==

* [https://v.youku.com/v_show/id_XMTI2NTM4MDIwMA==.html Youku - gamepiaynmo - 基本功能演示]
* [https://www.youtube.com/watch?v=JsCf_dkcfTc Youtube - LucaS - 大部分命令与Debug Mode演示]

== 安装方法 ==

此Ballance Mod Loader配置有安装器(msi文件)，在安装过程中选择Ballance根目录即可自动安装。

如果您需要手动安装或配置某些文件请参考文件修改记录

安装完成打开游戏，如果看到13关(Twilight Zone)有速度、力量、能力3个选项，说明安装成功。

== 文件修改记录 ==

{{FileTree|language=zh}}

<pre style="word-wrap: break-long; overflow-x: auto">
 +-- Ballance
     +-- 3D Entities
     |   +-- PH
     |       +-- [N] P_Ball_Water.nmo -
     |       +-- [N] P_Iron_Box.nmo -
     |       +-- [N] P_Rope_Board.nmo -
     |       +-- [N] P_Rotboard_Wood.nmo -
     +-- Plugins
     |   +-- [N] BallanceModLoader.dll -
     +-- [N] ModLoader
         +-- [N] InsertBallance.dll -
         +-- [N] ModLoader.nmo -
         +-- [N] Mods
         |   +-- [N] Ball_Stone_Creater.nmo -
         |   +-- [N] Extra_Sector.NMO -
         |   +-- [N] GPIAY_New_Moduls.nmo -
         |   +-- [N] MenulevelPlugin.nmo -
         |   +-- [N] TestMod.nmo -
         |   +-- [N] Travel_Cam.nmo -
         +-- [N] Samples
             +-- [N] NewModuls
                 +-- [N] P_Ball_Water
                 |   +-- [N] Level_03.NMO -
                 +-- [N] P_Iron_Box
                 |   +-- [N] Level_03.NMO -
                 +-- [N] P_Rope_Board
                 |   +-- [N] Level_03.NMO -
                 +-- [N] P_Rotboard_Wood
                     +-- [N] Level_03.NMO -
</pre>

注意事项：

* 本列表仅仅展示了安装程序配置的文件。
* Debug_Mode.nmo由于作弊性太强，并未包含在标准安装包中，如若需要安装，请将其放置于：Ballance\ModLoader\Mods即可。
* Debug_Mode.nmo的文件信息为：{{FileProperty|hashName=SHA256|hashData=89514A820259BF195C96081CFDDCA3CB81AC709C11F32022D2DCD92B83C6AE88}}
* 刚安装完时进入游戏点击力量或能力是会卡死的，需要像安装自制地图一样，在Ballance\3D Entities\Level文件夹中添加Level_14.nmo和Level_15.nmo，然后就能进入相应关卡。

== 兼容性 ==

使用CK2插件加载InsertBallance.dll并注入Ballance。由于使用的加载方式不涉及修改MenuLevel.nmo，因此兼容目前所有插件。

此游戏插件有一定几率导致游戏崩溃（尤其集中在退出游戏时）

== 使用方法 ==

此Ballance Mod Loader由一系列Mod组成，Ballance Mod Loader实际上只是个框架，在后文中将描述自带Mod的使用方法。

Ballance Mod Loader可以进行命令输入，执行某些Mod的特殊操作。

=== 命令输入方法 ===

在游戏中按下C键，窗口左上角出现白色竖条后，即可输入命令，输入完成按回车执行，未知命令会有提示。

=== 命令格式 ===

''Mod名_命令_命令参数(可选)''，必须使用下划线，例如启用漫游摄影机：<code>TravelCam_TravelCam_TRUE</code>

== Mod 列表 ==

=== MenulevelPlugin ===

显示速度、力量、能力3个选项，并可点击进入14、15关。

14、15关没有排行榜记录。

=== Extra_Sector ===

2jjy制作的多小节地图加载，可以加载小节数超过8的地图，如1-13连体关卡。在功能上替代[[999小节加载器]]

=== Travel_Cam ===

地图游览摄影机，让玩家视角可自由在关卡里移动

漫游摄影机开启时，可以按WSAD自由移动，移动鼠标可转换视角，空格上升，Ctrl下降，类似CS。。

彩蛋视角开启时，按W/S键可以使视角上升/下降。

==== 命令列表 ====
* <code>TravelCam_TravelCam</code>：参数加TRUE/FALSE来开启/关闭漫游摄影机。
* <code>TravelCam_EasterEggCam</code>：参数加TRUE/FALSE来开启/关闭彩蛋视角。

=== Ball_Stone_Creater ===

游戏中按下Ctrl+B组合键能向当前视角方向发射一颗石球，可用于娱乐或者内测地图时测试辅助球。注意生成的石球除非结束游戏是不会被删除的，所以谨慎使用。

可能是由于制作原因，再退出关卡进入新关卡后，生成的石球仍然会存在幻影（能看到但无碰撞，无任何物理属性）。

=== GPIAY_New_Moduls ===

可以让自己的关卡加载新机关，添加方法和原版机关一样，在自制图中创建一个相应机关名字的组，将任意物体归入这个组即能添加相应的机关，需要加小节组。想在自己图中加入的可以参考Ballance\ModLoader\Samples里的实例（关卡文件，内含自制机关，像自制地图那样安装即可体验）。已有的机关如下：

* <code>P_Ball_Water</code>：一个改了物理属性的道具球。
* <code>P_Iron_Box</code>：一个改了物理属性的箱子。
* <code>P_Rope_Board</code>：一根绳子吊着的木板，纸球、木球能过，石球会掉下去。
* <code>P_Rotboard_Wood</code>：一个木板，限制90度旋转范围，难以解释清楚。。可参考样例关卡，用在某些交叉路口可增加游戏益智性。。

=== TestMod ===

没有任何作用。作者表示''这是内测时用的，懒得删了''

=== Debug_Mode ===

一个对内测地图、练习捷径很有帮助的Mod，使用时游戏上方有Using Debug Mode字样。

游戏中按F1能给球一个向上的力，使球上升。

游戏中按F2能给球一个向下的力，使球下降加快。

==== 命令列表 ====
* <code>Debug_SetResetPosition</code>：设置球死亡的出生点为当前球的位置。
* <code>Debug_LevelWin</code>：直接通关。
* <code>Debug_AddLife</code>：加一条命。
* <code>Debug_KillBall</code>：自杀。
* <code>Debug_ChangeBallSpeed</code>：更改球速，参数是浮点数，为球速倍数，不会立即生效，变球、死亡、重来等之后生效。例：<code>Debug_ChangeBallSpeed_1.75</code> 改球速为1.75倍速
* <code>Debug_AddPoint</code>：加分，参数是所加分值，例：<code>Debug_AddPoint_100</code> 加100分。
* <code>Debug_LevelInformShow</code>：显示关卡信息，参数是TRUE/FALSE表示开启/关闭显示。

== 另请参阅 ==

* [[Ballance Mod Loader_2jjy/zh|Ballance Mod Loader 2jjy版]]：旧版本的Ballance Mod Loader

[[Category:游戏补丁]]