查看“BallanceMMOClient”的源代码

{{Languages|zh|BallanceMMOClient/zh}}

{{Appbox
|name=BallanceMMOClient
|screenshot=bmmo.png
|screenshotDesc=The multiplay game window implemented by BallanceMMOClient.
|author=Swung0x48
|suit=Ballance
|link=[https://github.com/Swung0x48/BallanceMMO GitHub repository]
|dependency=The Latest [[BML2]]
|status=active
|date=19 Apr, 2021 ({{AgeYM|2021|4|19}} ago)
|latest=None
|license=
* v1：Apache License
* v2 and v3：Unknow License
}}

{{Cquote|yyc12345|This is a brand-new, groundbreaking plugin. This plugin revives Ballance community.}}

'''BallanceMMOClient'''(abbr, BMMO) is a groundbreaking [[BML2]] plugin developed by Swung0x48. It allows a player to play Ballance with other players with low latency via a deployed central BMMO server. The ball of other players will be rendered as a shadow ball(half-transparent ball) in the game viewport, and a player name label will also be attached to it. Moreover, real-time chat, detect cheat status(cheat mode on or off) are also available. BMMO is enough stable to be used for some tournaments after a few iterations.

== Download ==

* Join Multiplay QQ Group, and download from QQ Group Files.
* Join Ballance Discord Server.
* Download from the Release page of GitHub repository.(Not suggested because publish is not in time.)
* Download project and build by yourself.(Not suggested because building this plugin is harder than imagine.)

Please read the requirement of server which you want to join and download correct version. '''In most instances, downloading the latest version is the best decision.''' Server will reject the connection of obsolete client after some updates.

== Client Usage ==

{{ambox|type=content
|issue='''Encoding Warning'''
|info=Due to the limitation of Ballance. Any non-ASCII character is not allowed in BallanceMMOClient, from server URL, username to message content. It means that you should not use any Chinese character, Katakana, Hiragana, Korea character, Cyrillic, Greek character and etc.}}

=== Install Client ===

Please ensure that you have installed the latest BML2. Then you need to put your downloaded zip file in {{code|ModLoader/Mods}} '''directly without decompression'''. If you have '''installed obsolete BMMO''' previously, '''please remove it instantly.''' Your installation is finished if you can see BallanceMMOClient entry in BML Mods menu.

=== Configurate Server and Username ===

After installation, there are 2 way to configure your server URL and username. If you are looking for some available servers, please check out the next chapter to get an available server.<br />
First, you can enter BallanceMMOClient entry in BML Mods menu, then use Remote and Player submenu to set server URL and username. If your server URL or username contain complex words, you can use the next method.<br />
Method 2, Close game, navigate to {{code|ModLoader/Config/BallanceMMOClient.cfg}} and open it. Now, you can change server URL and username directly.

=== Basic Operations ===

The following operations are frequently to be used. Please ensure that you have known them well before starting multi-play.

* {{code|/mmo c}} or {{code|/mmo connect}}: Connect to server.
* {{code|/mmo d}} or {{code|/mmo disconnect}}: Disconnect from server
* {{code|/mmo l}} or {{code|/mmo list}}: List all online player clients.
* {{code|/mmo s <message>}} or {{code|/mmo say <message>}}: Send message. Due the implementation of BML command, {{code|Space}} is not supported in message content. You need to use other symbol to split words if you need. For example, you can type {{code|wait/a/minute}} or {{code|wait-a-minute}} instead of {{code|wait a minute}}.
* F3 for switching the display of debug information. Debug information mainly show network transfer status.

After anti-cheat update(v3.1), BMMO supports more anti-cheat features.

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

== Available Servers ==

== History ==

== Deploy a Personal Server ==