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

{{Appbox/zh

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

|date=2015年6月27日 {{Resize|({{年月差异|2015|6|27}}前)}}
}}
Ballance Mod Loader Gamepiaynmo，即'''Gamepiaynmo为Ballance开发的Mod加载器'''，可以为Ballance提供更多内容加载的框架：加载外置插件，或是自制机关等。Ballance Mod Loader之于Ballance，就像Forge之于Minecraft。

虽然此Mod的开发状态目前长期''（甚至可能永久）''停滞，但其功能已经很强大，可以满足大多数人的需求。

== 下载 ==

* '''[[:File:BML-Gamepiaynmo.ZIP|从本Wiki下载]]'''
* [http://gcba.ml/dl/ZIP/BML-Gamepiaynmo GCBA] (下载解压缩得到BML，请认真查看说明以便操作)
* [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个选项，说明安装成功。

== 兼容性 ==

使用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 ===

Twilight zone中追加力量与能力选项，并可点击进入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组合键能向当前视角方向发射一颗石球，可用于娱乐或者内测地图时测试辅助球。

注意：生成的石球除非退出关卡否则不会被删除，请谨慎使用。而退出关卡后再次进入任一关卡，在发射出的石球所在位置仍然会存在石球幻影，能看到但无碰撞体积和物理属性。这或许是作者遗留的插件BUG。

=== 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表示开启/关闭显示。

'''由于Debug_Mode插件的功能基本上宣布了玩家球无敌，且可能被人破解后用于作弊，因此关于它的讨论有极大争议。尽量不要在任何公开场合谈论这个插件。'''

== 文件修改记录 ==

{{FileTree|language=zh}}

<pre style="overflow-x: auto; font-size: 15px">
 +-- Ballance
     +-- 3D Entities
     |   +-- PH
     |       +-- [N] P_Ball_Water.nmo - 78FBA56405C169B3FF63A50AE6407C289ADCF22FE4021354CF00DA888B228AFF
     |       +-- [N] P_Iron_Box.nmo - 3D51782D3F4B9BD43CEF35F2B71C761917CCCC9C687410BA24AD576B8C80E503
     |       +-- [N] P_Rope_Board.nmo - D41275571ACF13271AB229DAC06B87613980150587772FB3B60B1D31E266C1B8
     |       +-- [N] P_Rotboard_Wood.nmo - 7B096AF1602D6EC56FA6FB9A6FD28009950FE6A850F031183103FD99E04A3204
     +-- Plugins
     |   +-- [N] BallanceModLoader.dll - E1AD3655994BD280C1A644088C1F1D0DC206C4E03F5167342830AF92B29B3595
     +-- [N] ModLoader
         +-- [N] InsertBallance.dll - F90823B5F997A6126DBB61F51EB571628A46FF6F69244AC09C2A3A443AA6B103
         +-- [N] ModLoader.nmo - 2EA305FB735B9777E062CC6FB16E880D88A15EE8F68AF4312F1A476B757B654A
         +-- [N] Mods
         |   +-- [N] Ball_Stone_Creater.nmo - 22A92ECC71E4A1CC0E8A519A4A59AF81AAB660059DA13B07A8A001E44F8DA593
         |   +-- [N] Extra_Sector.NMO - 42CBDF2D3C897F9D0018D165ACDEFF78459461F5F862A0660481B34A52BC0AA2
         |   +-- [N] GPIAY_New_Moduls.nmo - 817C72F30297D1AC21942646B2E182FB7696B339380D561C4A370769D785B9FE
         |   +-- [N] MenulevelPlugin.nmo - 0C8A36ADB46B1908FFC0CC8CA9234E6D279DDDB612FE2B91C3B79FD08C6F8E30
         |   +-- [N] TestMod.nmo - D7B42BF50C2D968A159552A0D28902EFBCAB5B7197736818F4EB805C713E63EE
         |   +-- [N] Travel_Cam.nmo - 7F7C1762D4E92F005EC239FDE9D56AD24BCD1B9657A5714570CE610E899E7C8F
         +-- [N] Samples
             +-- [N] NewModuls
                 +-- [N] P_Ball_Water
                 |   +-- [N] Level_03.NMO - 82FA26DF54A7EA5B6CA2555C2E288D9E21DA0F5235D4005E9DB502FD0F299583
                 +-- [N] P_Iron_Box
                 |   +-- [N] Level_03.NMO - 87A2E8B2DCF75390688009A000025CBDBB50C97B9DBC41F868651C94F4477EF4
                 +-- [N] P_Rope_Board
                 |   +-- [N] Level_03.NMO - 493B0648D90B8C3B941BD68F7789E92557948A738A8DD8669B9787E8194159AA
                 +-- [N] P_Rotboard_Wood
                     +-- [N] Level_03.NMO - B4104FEC4E0778C66C58A53C414AA3A032D2767C5A3ECF9BBB5505E4FE2C812C
</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，然后就能进入相应关卡。

== 另请参阅 ==

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

[[Category:游戏补丁]]