查看“BallanceMMOClient/zh”的源代码

{{Languages|en|BallanceMMOClient}}

{{Appbox/zh
|name=BallanceMMOClient
|screenshot=bmmo.png
|screenshotDesc=由BallanceMMOClient实现的多球同时竞技的游戏界面。
|author=Swung0x48
|suit=Ballance
|link=[https://github.com/Swung0x48/BallanceMMO GitHub仓库]
|dependency=最新版本的[[Ballance Mod Loader Gamepiaynmo版（第二版）|BML]]
|status=active
|date=2021年4月19日（{{年月差异|2021|4|19}}前）
|latest=无
|license=
* v1：Apache许可证
* v2及v3：未知许可证
}}

{{Cquote|yyc12345|这是一款全新的、突破性的插件。联机插件为Ballance带来了新的生机。}}

BallanceMMOClient，又简称为BMMO，是由Swung0x48开发的一款具有跨时代意义的[[Ballance Mod Loader Gamepiaynmo版（第二版）|BML]]插件。它允许用户在插件的支持下通过中心服务器与其它Ballance玩家进行低延迟的游戏互联。同在游戏中的其它玩家将使用类似[[影子球]]的形式显示，并可以显示玩家名称，此外，插件还具有实施聊天框，显示作弊状态等功能。在插件的多次迭代中，BMMO已经变得足够稳定以支持一些比赛的举办。

== 下载 ==

* 加入[[QQ群|联机群]]，并在群文件中下载
* 加入Ballance [[Discord]]群组获得客户端
* 前往GitHub工程的Release页面下载（不推荐，因为更新不及时）
* 自行编译（不推荐，因为编译较为困难）

请注意各个服务器的版本要求，并下载正确的版本。'''下载最新版本'''通常'''是最正确的选择'''。在一些版本的升级后，服务器将不会允许旧版本的客户端连接。

== 客户端使用方法 ==

{{ambox|type=content
|issue='''字符编码警告'''
|info=由于Ballance的限制，BallanceMMOClient不允许您使用任何非ASCII字符，无论是在填写服务器地址，用户名，又或者是在发送消息时。这就意味着您使用的文本不能包含汉字，平假名，片假名，韩文，西里尔字母，希腊字母等。}}

=== 安装客户端 ===

首先您需要确保您安装了最新版本的BML。然后您需要将下载得到的zip压缩包'''不解压直接放在'''{{code|ModLoader/Mods}}下。如果您之前安装有旧版本的BMMO，'''请务必删除所有旧版本的BMMO。'''重启游戏后在Mod界面查看到BallanceMMOClient即为安装成功。

=== 配置服务器与用户名 ===

在您安装成功后，您有两种选择去设置您要连接的服务器和您的用户名。如果您正在寻找可用的服务器，可以查看下一章节以获取可用的服务器。<br />
您可以在游戏的Mod界面中，BallanceMMOClient设置项中的Remote和Player选项中分别设置您的服务器地址和用户名。如果您的地址或名称中包含复杂文本，您可以选择第二种方法。<br />
第二种方法则是可以编辑{{code|ModLoader/Config/BallanceMMOClient.cfg}}来修改服务器地址和用户名。

=== 基本操作 ===

以下操作非常常用，在您设置好相关内容后请熟悉以下内容。

* {{code|/mmo c}}或{{code|/mmo connect}}：连接服务器。
* {{code|/mmo d}}或{{code|/mmo disconnect}}：断开连接。
* {{code|/mmo l}}或{{code|/mmo list}}：列出所有在线客户端。
* {{code|/mmo s 消息}}或{{code|/mmo say 消息}}：发送消息（自3.1.5-beta5起）<ref>在3.1.5-beta5前，由于BMMO的实现，消息中不支持输入空格。如果您需要断句，需要使用其它符号代替，例如“我掉了”可以这么打出：{{code|wo/diao/le}}又或者{{code|wo-diao-le}}。在3.1.5-beta5更新中，这一问题由开发者修复。</ref>。

自v3.1反作弊更新后，BMMO支持更多反作弊特性

* {{code|/mmo cheat [on或off]}}：开关'''所有玩家'''的cheat。此命令将在不请求其它玩家的情况下强制改变所有玩家的作弊状态。请不要滥用此指令。
* 现在会在玩家进行作弊的时候进行全局通报，并在作弊玩家名称后部付加{{code|[C]}}进行标记

=== 高级操作 ===

* F3开关右上角调试信息，调试信息主要显示网络传输状态。
* 可以使用键盘快捷键快速发出比赛准备指令。它实际上就是快速执行固定文本的{{code|/mmo say 消息}}
** {{code|左Ctrl + 3}}：发送{{code|3}}
** {{code|左Ctrl + 2}}：发送{{code|3}}
** {{code|左Ctrl + 1}}：发送{{code|1}}
** {{code|左Ctrl + 0}}：发送{{code|GO!}}

== 可用服务器 ==

考虑到服务器的安全性，您需要根据您的需要，加入对应的交流渠道才可以获取可用服务器。当然，如果您也可以根据下一节的讲解开设私服并进行游戏。<br />
如果您希望与中国国内的玩家进行游戏，您需要加入[[QQ群|联机群]]，并在群内获取对应服务器地址<br />
如果您连接中国国内服务器有较大延迟，又或者希望与世界其它的Ballance进行游戏，可以加入Ballance [[Discord]]群组，并在{{code|#multiplay}}频道中获取服务器地址。<br />

== 历史 ==

从BMMO的GitHub Commit历史中可以看出其历史。BMMO从开发至今共有3个大版本。<br />
v1版本是基于TCP连接的架构，在这个版本中，定义了最基础的消息结构并进行过几次测试，TCP连接的最大问题就是一旦网络环境不佳，那么连接质量就会大大下降。这在一些场合是不能接受的。<br />
v2版本使用了[https://github.com/Swung0x48/AMMOProtocol Swung自研的协议]，但最终v2版本没有持续很长时间。<br />
v3版本是大家目前都在使用的版本，也是正在活跃开发的版本，此版本使用了[https://github.com/ValveSoftware/GameNetworkingSockets Valve的GameNetworkingSockets]作为网络协议库，并在此之上构建了此版本的BMMO，凭借Valve的GameNetworkingSockets优异的低延迟，高可靠性的特性，此版本的BMMO目前广受好评，即使玩家分布于世界各地，无论网络情况如何，都可以在可接受的范围内享受联机服务。

== 服务器搭建方法 ==

通常而言，在Linux搭建此服务器较为方便。您可以在其GitHub工程的README中找到如何编译服务器的相关介绍。
同时，你也可以在其 GitHub 工程中的 GitHub Action 中找到由 CI 自动编译的 Windows 版本服务端。

== 引用 ==

<references />

[[Category:BML2第三方Mod]]