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

{{DISPLAYTITLE:Ballance Mod Loader_Gamepiaynmo{{Resize|/zh|50%}}}}
{{Cquote|yyc12345|Ballance Mod Loader之于Ballance，就像Forge之于[[Wikipedia:zh-cn:Minecraft|Minecraft]]。}}
{{Appbox/zh
|screenshot=Ballance Mod Loader_Gamepiaynmo.jpg
|screenshotDesc= Gamepiaynmo 版 Ballance Mod Loader （同时有开启 [[Debug Mode]]）显示的 [[Twilight zone]]，除了第13关“速度”外还有[[Ballance吧]]传言中的[[力量与能力关卡]]。
|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/zh|Ballance]]开发的Mod加载器'''，可以为Ballance提供更多内容加载的框架：加载外置插件，或是自制[[机关]]等。

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

2020年3月17日，yyc12345通过使用[[Virtools Script Deobfuscation/zh|Virtools Script Deobfuscation]]进行逆向工程反推出Ballance Mod Loader的原生Mod的编写方式<ref>贴吧公布帖：https://tieba.baidu.com/p/6557306200</ref>，结束了自发布以来没有任何针对此Mod加载器的新Mod的局面。

== 下载 ==

* '''从[[Ballance Wiki|本Wiki]]下载: [[File:BML-Gamepiaynmo.ZIP]]'''
* [http://gcba.ml/dl/ZIP/BML-Gamepiaynmo GCBA] (下载解压缩得到BML，请认真查看说明以便操作)
* [https://mega.nz/#F!CV5SyapR!LbduTW51xmkDO4EDxMfH9w Mega] (Plugin/BallanceModLoader-Gamepiaynmo.msi)

Gamepiaynmo 版的 Ballance Mod Loader 无需替换任何游戏原有文件。

== 相关视频 ==

* [https://v.youku.com/v_show/id_XMTI2NTM4MDIwMA==.html Youku - gamepiaynmo - 基本功能演示]
* [https://www.youtube.com/watch?v=JsCf_dkcfTc Youtube - LucaS - 大部分命令与Debug Mode演示]
* [https://www.bilibili.com/video/av96757285/ yyc12345 - 原生Mod开发的简要教程]

== 安装方法 ==
此Ballance Mod Loader配置有安装器（msi文件），在安装过程中选择Ballance根目录即可自动安装。如果您需要手动安装或配置某些文件，请参考文件修改记录。

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

== 兼容性 ==

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

此游戏插件有一定几率导致游戏崩溃（尤其集中在退出游戏时），但经大量测试，'''问题不是很严重，可以放心使用'''。一部分[[自制地图]]无法在开启 Ballance Mod Loader 的条件下使用（加载时游戏崩溃），目前原因未知。

如果安装有 [[Ballance Mod Loader 2jjy/zh|2jjy 版的 Mod Loader]]，在使用 [[#Debug Mode]] 的功能时会导致卡顿。可行的解决方法是直接将之卸载，因为目前的 Gamepiaynmo 版已经涵盖其全部功能。

== 使用方法 ==
此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关没有排行榜记录（虽然的确会像其他关卡一样将所得纪录写入记录排行榜的 {{zh|Database.tdb}} 文件）。

=== Extra Sector ===

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

=== TravelCam ===

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

漫游摄影机开启时，可以按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 ===

{{Cquote|Gamepiaynmo|这是内测时用的，懒得删了}}
没有任何作用。

=== Debug Mode ===

{{Note|{{Orange|{{Resize|'''由于Debug_Mode插件的功能基本上宣布了玩家球无敌，且可能被人破解后用于作弊，因此关于它的讨论有极大争议。请尽量不要在任何公开场合过多谈论这个插件的功能。'''|1.12em}}}}}}
中文名也称作“调试模式”。一个对内测地图、练习[[捷径]]很有帮助的Mod，使用时游戏上方有 <code>Using Debug Mode</code> 字样。

* 按 {{kbd|F1}} 能给球一个向上的力，使球上升。
* 按 {{kbd|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安装器所部署的文件进行描述，将不会描述任何第三方Mod的结构。

{{FileTree/zh}}
{{FileChanges/zh|content= +-- 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}}

注意事项：

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

== 第三方 Mod ==

自Ballance Mod Loader的Mod编写方式公布之后，有以下Mod可在Ballance Mod Loader下加载并运行。
<!-- 用列表列，具体信息在对应词条里写，不要写在这-->

* [[HSSR Counter]] - 9826HZg
* [[Life Up]] - 9826HZg
* [[Ball Speed Changer]] - 9826HZg
== 另请参阅 ==

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

== 注释 ==

<references />

[[Category:游戏补丁]]