查看“BallanceMMOClient/zh”的源代码

{{Languages|en|BallanceMMOClient}}

{{Seealso|主条目：[[Ballance大型多人在线游戏]]}}

{{ambox|type=content
|issue='''字符编码警告'''
|info=由于Ballance的限制，BallanceMMOClient不允许您使用任何非ASCII字符。这就意味着您在此插件中使用的'''任何文本'''不能包含汉字，平假名，片假名，韩文，西里尔字母，希腊字母等。<br />
但是，在后续章节的介绍中，有一些特殊命令可以帮助您突破此限制。}}

== 下载 ==

* 在[https://dl.bmmo.bcrc.site/ 发布网站]下载。选择Download Standalone Package进行下载。（推荐）
* 加入[[QQ群|联机群]]，并在群文件中下载。（推荐）
* 加入Ballance [[Discord]]群组获得客户端
* 前往[https://github.com/Swung0x48/BallanceMMO GitHub工程]的Release页面下载（不推荐，因为更新不及时）
* 自行编译（不推荐，因为编译较为困难）

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

== 安装客户端 ==

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

== 客户端配置 ==

插件的配置方式有两种。<br />
您可以在游戏的Mod界面中，BallanceMMOClient设置项中的层级菜单内，选择对应设置进行修改。如果您的设置项较长或包含复杂文本，您可以选择第二种方法。<br />
第二种方法则是可以编辑{{code|ModLoader/Config/BallanceMMOClient.cfg}}来修改插件的相关设置。

=== 核心设置 ===

用户名和服务器地址是您进行联机必须要进行设置的两项内容。

用户名设置位于Player - Playername。请选择一个较为清晰的名称。需要注意的是，您输入的用户名会被服务器进行一次无效字符删除，因此服务器最终采用的用户名可能与你设定的有所出入。

服务器地址设置位于Remote - ServerAddress。您必须设置正确的服务器地址，并确保您和您希望联机的人处在同一服务器下，您才可以进行正常的联机。此外，如果您省略了地址的端口号，那么插件将默认连接{{code|26676}}端口。

=== 其它设置 ===

旁观者模式设置位于Remote - SpectatorMode。开启后你将以旁观者模式进行联机。旁观者不参与游戏内排名，也不会对其他玩家显示你的影子球。旁观者模式经常用于比赛中的解说与裁判。处于旁观者模式的玩家前会被自动添加一个星号（{{code|*}}）以标记。

外推插值设置位于Gameplay - Extrapolation。开启后将启用外推插值功能平滑显示玩家球运动轨迹，以取得更好的显示效果。若关闭，插件将停止平滑球的轨迹，球的轨迹将会是以离散形式呈现（瞬移）。此设置默认开启并且建议所有用户都开启它。

玩家列表颜色设置位于Gameplay - PlayerListColor。此设置允许你控制右下方的玩家列表（参见后续章节以了解）显示所用的颜色。通常无需修改。

== 客户端使用方法 ==

=== 命令 ===

下文命令的描述格式和注意事项

* 不同参数之间以空格分隔；未使用任何格式的参数表示玩家必须原样输入参数名称。
* {{code|<u>n</u>a<u>m</u>e}} 表示对应的参数名称为 {{code|name}}，但可以仅输入下划线所示的部分（即字母 {{code|nm}} 的组合）。
* {{code|<nowiki><参数></nowiki>}} 表示必须根据实际状态输入的参数。
* {{code|<nowiki>[参数]</nowiki>}} 表示可以省略（将会使用默认值）的玩家参数。
* {{code|<nowiki>参数1 | 参数2</nowiki>}} 表示玩家需要选择参数 1 或参数 2 中的一个填入。
* 除了 {{code|/mmo kick}} 外，命令的完整名称以及玩家名或玩家 ID 可以输入首字母后按下 Tab 键自动补全，方便快速输入。
* 固定的命令和玩家名不区分字母大小写，但玩家根据实际状态自行填入的其他参数区分。此外，Tab 键自动补全时由于 BML 自身设定问题，也区分大小写。

==== 服务器状态类 ====

* {{code|/mmo <u>c</u>onnect <nowiki>[地址]</nowiki>}} – 连接到地址对应的服务器。若不填地址则使用 Mod 设置内填入的服务器地址。
* {{code|/mmo <u>d</u>isconnect}} – 离开玩家所在的服务器。

==== 玩家状态类 ====

* {{code|/mmo <u>l</u>ist<nowiki>|</nowiki><u>l</u>ist-<u>i</u>d}} – 显示所在服务器内所有玩家的名称列表。若使用 {{code|list-id}}，则在列表内同时列出玩家名称和内部临时 ID。
* {{code|/mmo <u>g</u>et<u>m</u>ap}} – 显示服务器内所有玩家各自所在的地图名称和小节号（方便寻找不同玩家）。
* {{code|/mmo <u>g</u>et<u>p</u>os}} – 显示服务器内所有玩家各自的坐标和球的种类。<ref name="single-player">服务器内玩家数仅有 1 人（即玩家自身）时为节约运算和网络资源，服务器并不会向玩家发送坐标等状态信息，所以影子球不会跟随玩家移动。也因此服务器内仅有 1 名玩家（即玩家自身）时并不会正确显示坐标和球的种类。</ref>
* {{code|/mmo <u>r</u>e<u>l</u>oad}} – 重新加载服务器内玩家状态。如果玩家名称标记和实际影子球错位，可以使用重载功能调整。
* {{code|/mmo gettimestamp}} – 显示服务器内玩家的影子球插值用时间数据。''此命令为调试功能。''

==== 玩家互动类 ====

* {{code|/mmo <u>s</u>ay <nowiki><文字></nowiki>}} 或 {{code|/say <nowiki><文字></nowiki>}} – 在服务器内公开发送一条内容为 <文字> 的聊天信息。<ref>在3.1.5-beta5前，由于BMMO的实现，消息中不支持输入空格。如果您需要断句，需要使用其它符号代替，例如“我掉了”可以这么打出：{{code|wo/diao/le}}又或者{{code|wo-diao-le}}。在3.1.5-beta5更新中，这一问题由开发者修复。</ref>
* {{code|/mmo <u>w</u>hisper <nowiki><玩家名称> <文字></nowiki>}} 或 {{code|/mmo <u>w</u>hisper <nowiki>#<玩家ID> <文字></nowiki>}} – 向对应的玩家发送私聊信息，只有对方能够看见。
* {{code|/mmo announce <nowiki><文字></nowiki>}} – 在服务器内发送一条重要通知。可以显示包括中文在内的非 ASCII 字符。
* {{code|/mmo bulletin <nowiki>[文字]</nowiki>}} – 设置服务器的常驻通知（会维持在游戏界面顶端显示）。<ref>常驻通知不会自动换行，请注意描述的简洁度；此外，服务器内所有玩家均退出（使得服务器内没有玩家）后常驻通知会自动清空。</ref>
* {{code|/mmo <u>a</u>nnounce<u>m</u>ap}} – 在服务器内公开发送自己所在的地图和小节的信息（可以用于通知其他用户）。
* {{code|/mmo <u>t</u>ele<u>p</u>ort <nowiki><玩家名称></nowiki>}} 或 {{code|/mmo <u>t</u>ele<u>p</u>ort <nowiki>#<玩家ID></nowiki>}} – 传送至服务器内其他玩家的坐标。只能在作弊模式（Cheat Mode）下使用。<ref>传送只能做到传送到玩家本地存储的其他玩家的坐标，不会连带切换玩家所在的地图或小节，也不会复原其他玩家视角的机关摆放；请与 {{code|/mmo getmap}} 等命令配合使用。</ref><ref name="single-player" />
* {{code|/mmo kick <nowiki><玩家名称> [理由]</nowiki>}} 或 {{code|/mmo kick <nowiki>#<玩家ID> [理由]</nowiki>}}: 将对应名称（不区分大小写）或 ID 的玩家踢出服务器。
* {{code|/mmo custommap <nowiki><名称|reset></nowiki>}}: 自定义自己所在地图的名称（仅对其他玩家有效，玩家自身无法查看）。切换地图或者切换小节时均会重置。

==== 比赛状态类 ====

* {{code|/mmo cheat <nowiki>on|off</nowiki>}} – 开启或关闭服务器内所有人的作弊模式（Cheat Mode）。
* {{code|/mmo countdown}} – 自动连续发出 3, 2, 1, 开始比赛的信号。
* {{code|/mmo dnf}} – 发出未能成功完赛所在地图的信号（同对应的快捷键）。
* {{code|/mmo rank reset}} – 若玩家自己稍后发送比赛起跑命令，则同时重置服务器内所有地图先前已有的排行名次（适用于多地图连续比赛但仅发号一次的场景）。
* {{code|/mmo <nowiki>ready|ready-cancel</nowiki>}} – 用于公开示意自己已经准备好了（进入已准备状态）或还未准备好（取消先前的准备状态）。

==== 杂项 ====

* {{code|/mmo <nowiki>show|hide</nowiki>}} – 显示或隐藏本 mod 的命令行控制台。控制台内可以显示本 mod 的所有状态提示信息。命令行控制台的输入和输出将{{Color|'''不再有ASCII字符限制'''|red}}（即支持显示与输入中文等字符）。同时输入命令时也无需 {{code|/mmo}} 前缀。

=== 快捷键 ===

==== 自身状态类 ====

* {{code|Tab}}: 显示/隐藏其他玩家的影子球的名称标签。
* {{code|F3}}: 显示/隐藏调试信息。
* {{code|F3 + A}}: 重新加载服务器内玩家状态。如果玩家名称标记和实际影子球错位，可以使用重载功能调整。
* {{code|Ctrl + Tab}}: 显示比赛内非旁观玩家的实时状态（所在的地图和小节）列表。<ref>先按住 Ctrl 再按 Tab（其他快捷键同理），虽然要同时按下但顺序不可错乱。</ref>
* {{code|Ctrl + <nowiki>`</nowiki>}}: 显示/隐藏自己的（经历网络延迟后的）实时影子球，方便观察自身延迟。<ref>{{code|<nowiki>`</nowiki>}} 键位于标准 QWERTY 键盘的 1 键左侧，同时可以用于输入 {{code|<nowiki>~</nowiki>}}。</ref><ref name="single-player" />
* {{code|Ctrl + Shift + ↑}}: 重置自己的视角。防止比赛过程中意外切换到非 90 度视角状态后无法正常继续比赛。<ref>重置视角时摄像机需要有大约 1~2 秒的调整时间，此期间建议不要移动防止出现其他意外（可以在变球器上时调整视角，减少非必要的时间浪费）。</ref>

==== 比赛状态类 ====

* {{code|Ctrl + <nowiki>[3 或 2 或 1]</nowiki>}}: 发出对玩家所在地图开始比赛的对应倒数命令。
* {{code|Ctrl + 0}}: 发出对玩家所在地图的起跑命令（玩家收到后会同时重置本地的比赛用时计时器）。根据服务器相关设置，地图相同的玩家收到后可能会自动重开所在地图。
* {{code|Ctrl + 4}}: 发出对玩家所在地图的准备命令。
* {{code|Ctrl + 5}}: 发出对玩家所在地图的确认准备状态的命令（用于提示玩家对自己是否准备好了进行示意）。
* {{code|Ctrl + D}} 快速同时按下两次: 发出未能成功完赛（Did not finish, DNF）所在地图的信号。

== 可用服务器 ==

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

== 引用 ==

<references />

[[Category:BML2第三方Mod]]