“BallanceMMOClient”的版本间的差异
332wowchoumm（讨论 | 贡献） 小 |
|||
| （未显示2个用户的6个中间版本） | |||
| 第10行： | 第10行： | ||
== Download == | == Download == | ||
| − | * Download from [https://dl.bmmo. | + | * Download from [https://dl.bmmo.bcrc.site/ Publish Website]. Click "Download Standalone Package" to download. (Suggested) |
* Join Multi-play QQ Group, and download from QQ Group Files. | * Join Multi-play QQ Group, and download from QQ Group Files. | ||
* Join Ballance Discord Server. | * Join Ballance Discord Server. | ||
| 第56行： | 第56行： | ||
==== Server Status ==== | ==== Server Status ==== | ||
| − | * {{code|/mmo <u>c</u>onnect <nowiki>[ | + | * {{code|/mmo <u>c</u>onnect <nowiki>[address]</nowiki>}} – Connect your specified server. If address argument is omitted, use the server setting of this plugin instead. |
| − | * {{code|/mmo <u>d</u>isconnect}} – | + | * {{code|/mmo <u>d</u>isconnect}} – Leave current connected server. |
==== Player Status ==== | ==== Player Status ==== | ||
| − | * {{code|/mmo <u>l</u>ist<nowiki>|</nowiki><u>l</u>ist-<u>i</u>d}} – | + | * {{code|/mmo <u>l</u>ist<nowiki>|</nowiki><u>l</u>ist-<u>i</u>d}} – Show a list containing all online player's name. if use {{code|list-id}} argument, a extra temporary internal player ID will be attached to its name. |
| − | * {{code|/mmo <u>g</u>et<u>m</u>ap}} – | + | * {{code|/mmo <u>g</u>et<u>m</u>ap}} – For all players, show which map player is playing and its corresponding sector. It is convenient for looking for players. |
| − | * {{code|/mmo <u>g</u>et<u>p</u>os}} – | + | * {{code|/mmo <u>g</u>et<u>p</u>os}} – Show the position and ball type for all players.<ref name="single-player">For some reason about reducing computing and network resources, server will not send player's position and status data when the server only have a single player. So the shadow ball also can not move following player. Because of this, the position and ball type data is not correct when the server only have 1 player.</ref> |
| − | * {{code|/mmo <u>r</u>e<u>l</u>oad}} – | + | * {{code|/mmo <u>r</u>e<u>l</u>oad}} – Reload all players status in client. If player name label and its shadow ball are mismatched, this function may solve this issue. |
| − | * {{code|/mmo gettimestamp}} – | + | * {{code|/mmo gettimestamp}} – Show all players extrapolation debug data.''This command is served for the developer of this mod.'' |
==== Player Interaction ==== | ==== Player Interaction ==== | ||
| − | * {{code|/mmo <u>s</u>ay <nowiki>< | + | * {{code|/mmo <u>s</u>ay <nowiki><text></nowiki>}} or {{code|/say <nowiki><text></nowiki>}} – Send a public message in server with a content of <text>.<ref>Before 3.1.5-beta5, due to the implementation of BMMO, {{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}}.</ref>. |
| − | * {{code|/mmo <u>w</u>hisper <nowiki>< | + | * {{code|/mmo <u>w</u>hisper <nowiki><player name> <text></nowiki>}} or {{code|/mmo <u>w</u>hisper <nowiki>#<player ID> <text></nowiki>}} – Send a private message for your specified player. This message only can be seen by you and your specified player. |
| − | * {{code|/mmo announce <nowiki>< | + | * {{code|/mmo announce <nowiki><text></nowiki>}} – Send a important public message in server. This message {{Color|'''support non-ASCII characters'''|red}} and will '''be shown at the center of game window for a while.''' |
| − | * {{code|/mmo bulletin <nowiki>[ | + | * {{code|/mmo bulletin <nowiki>[text]</nowiki>}} – Set server bulletin text. '''The bulletin text bar will constantly displayed at the top-center of game window.'''<ref>Bulletin text do not support line break. Please use a clear and short text for it. Additionally, bulletin will set to blank when all players disconnected from server.</ref> |
| − | * {{code|/mmo <u>a</u>nnounce<u>m</u>ap}} – | + | * {{code|/mmo <u>a</u>nnounce<u>m</u>ap}} – Explicitly notify server which map you are playing and which section you are staying. (It is convenient fot notify other players) |
| − | * {{code|/mmo <u>t</u>ele<u>p</u>ort <nowiki>< | + | * {{code|/mmo <u>t</u>ele<u>p</u>ort <nowiki><player name></nowiki>}} or {{code|/mmo <u>t</u>ele<u>p</u>ort <nowiki>#<player ID></nowiki>}} – Teleport to other player's position. Only works on Cheat Mode.<ref>Teleportation only can move you to other player's position. It can not switch your sector automatically and also can not restore element statues.This command is frequently used with {{code|/mmo getmap}}</ref><ref name="single-player" /> |
| − | * {{code|/mmo kick <nowiki>< | + | * {{code|/mmo kick <nowiki><player name> [reason]</nowiki>}} or {{code|/mmo kick <nowiki>#<player ID> [reason]</nowiki>}}: Kick the player from server with corresponding name (case-insensitive) or ID |
| − | * {{code|/mmo custommap <nowiki>< | + | * {{code|/mmo custommap <nowiki><Name|reset></nowiki>}}: Customize your map name which you are playing. This name will be reset when switching levels or sectors. |
==== Tournament Status ==== | ==== Tournament Status ==== | ||
| − | * {{code|/mmo cheat <nowiki>on|off</nowiki>}} – | + | * {{code|/mmo cheat <nowiki>on|off</nowiki>}} – Turn cheat mode on or off for all players online. |
| − | * {{code|/mmo countdown}} – | + | * {{code|/mmo countdown}} – Start the ready-set-go countdown. |
| − | * {{code|/mmo dnf}} – | + | * {{code|/mmo dnf}} – Forfeit the game (did-not-finish). |
| − | * {{code|/mmo rank reset}} – | + | * {{code|/mmo rank reset}} – Run this before activating the countdown to reset all ranking (applies to a single race across multiple levels). |
| − | * {{code|/mmo <nowiki>ready|ready-cancel</nowiki>}} | + | * {{code|/mmo <nowiki>ready|ready-cancel</nowiki>}} - Signify to other players that you are ready for the race or cancel the ready status. |
==== Misc ==== | ==== Misc ==== | ||
| − | * {{code|/mmo <nowiki>show|hide</nowiki>}} – | + | * {{code|/mmo <nowiki>show|hide</nowiki>}} – Show / hide the console window for this mod. All status output from this mod will be available in the console, plus you can use commands of this mod in the console (without the {{code|/mmo}} prefix). Input and output in the console is no longer limited to standard ASCII characters. |
=== Keyboard Shortcuts === | === Keyboard Shortcuts === | ||
| 第94行： | 第94行： | ||
==== Self Status ==== | ==== Self Status ==== | ||
| − | * {{code|Tab}}: | + | * {{code|Tab}}: Toggle name plates for other players. |
| − | * {{code|F3}}: | + | * {{code|F3}}: Toggle debug information. |
| − | * {{code|F3 + A}}: | + | * {{code|F3 + A}}: Reload player status. Use this to readjust when name plates and shadow balls are offset. |
| − | * {{code|Ctrl + Tab}}: | + | * {{code|Ctrl + Tab}}: Show realtime status of players in the race, including current map and checkpoint. <ref>Hold Ctrl then press Tab. The order matters.</ref> |
| − | * {{code|Ctrl + <nowiki>`</nowiki>}}: | + | * {{code|Ctrl + <nowiki>`</nowiki>}}: Show shadow ball of yourself (after network latency). Useful for latency test.<ref>{{code|<nowiki>`</nowiki>}} key is to the left of {{code|1}} on a standard QWERTY keyboard and can be used to type tilde symbol ({{code|<nowiki>~</nowiki>}}) when combined with {{code|<nowiki>Shift</nowiki>}}</ref><ref name="single-player" /> |
| − | * {{code|Ctrl + Shift + ↑}}: | + | * {{code|Ctrl + Shift + ↑}}: Reset camera. Useful when you accidentally set a nonstandard camera angle. Some rules force a player to forfeit the game if nonstandard camera angle is used.<ref>Please allow 1-2 seconds for the camera to readjust and do not move before it's done. You can do this while inside a transformer to avoid some time loss.</ref> |
==== Tournament Status ==== | ==== Tournament Status ==== | ||
| − | * {{code|Ctrl + <nowiki>[3 or 2 or 1]</nowiki>}}: | + | * {{code|Ctrl + <nowiki>[3 or 2 or 1]</nowiki>}}: Start countdown. |
| − | * {{code|Ctrl + 0}}: | + | * {{code|Ctrl + 0}}: Start the race. Resets the race timer for all players. Depending on settings of the server, the level may be restarted. |
| − | * {{code|Ctrl + 4}}: | + | * {{code|Ctrl + 4}}: Notify the players to ready up. |
| − | * {{code|Ctrl + 5}}: | + | * {{code|Ctrl + 5}}: Ask the players to confirm readiness. |
| − | * {{code|Ctrl + D}} | + | * {{code|Ctrl + D}} (press twice consecutively: Forfeit the current level (did-not-finish). |
== Available Servers == | == Available Servers == | ||
| 第114行： | 第114行： | ||
If you want to play with Chinese Ballance players, you should join Multi-play QQ Group and get server URL within it.<br /> | If you want to play with Chinese Ballance players, you should join Multi-play QQ Group and get server URL within it.<br /> | ||
Or, there is a big latency when you are connecting to Chinese BMMO server, or you want to play Ballance with over world Ballance players, you can join Ballance [[Discord]] server and get server URL from {{code|#multiplay}} channel. | Or, there is a big latency when you are connecting to Chinese BMMO server, or you want to play Ballance with over world Ballance players, you can join Ballance [[Discord]] server and get server URL from {{code|#multiplay}} channel. | ||
| − | |||
| − | |||
| − | |||
| − | |||
== References == | == References == | ||
<references /> | <references /> | ||
2023年10月28日 (六) 21:45的最新版本
| Chinese version / 中文版: | BallanceMMOClient/zh |
|---|
 |
Main Page: Ballance Massive Multiplayer Online |
 |
Encoding Warning | |
|---|---|---|
目录
Download
- Download from Publish Website. Click "Download Standalone Package" to download. (Suggested)
- Join Multi-play 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 Settings
After installation, there are 2 way to configure your BallanceMMOClient settings
First, you can enter BallanceMMOClient entry in BML Mods menu, then use its submenu to set the settings what you want set. If your settings is too long or contain complex words, you can use the next method instead.
Method 2, Close game, navigate to ModLoader/Config/BallanceMMOClient.cfg and open it. Now, you can change all settings directly.
Core Settings
Server URL and player name are 2 essential settings for this plugin. You should fill them before any multiplayer game.
Player name setting locate in Player - Playername. Please choose a clear name. By the way, BMMO server will check your given name and remove all invalid characters, so the name adopted by the server may not exactly same with your set name.
Server URL setting locate in Remote - ServerAddress. You must set your server URL correctly, and stay in the same server with your friends/competitors, otherwise you can not do a normal multiplayer game. If the port of this field is omitted, the plugin will connect to the default port 26676.
Other Settings
Spectator Mode setting locate in Remote - SpectatorMode. If enable it, you will enter spectator mode when joining multiplay server. The player in spectator mode will not be account into level ranking. And your ball position also will not be shared. Spectator mode are frequently used by tournament commentary and referee. The name of online players in spectator mode will have a extra star (*) prefix to indicate them.
Extrapolation setting locate in Gameplay - Extrapolation. If enable it, plugin will use extrapolation algorithm to smooth the movement of shadow ball to get better visual effect. If you disable it, the path of each players ball will be dispersed ("Flash"). The default of this setting is enable and we highly recommend all players enable it.
Player list color setting locate in Gameplay - PlayerListColor. This setting allow you customize the color of player list panel which displayed at the right-bottom corner of game window. Usually no need to modify this.
Client Usage
Commands
There are the syntax of following commands introduction and some annotations.
- Use Space to split arguments. The argument without any modifier/bracket should be input directly.
nameindicate the long name of this argument isname. the short name of this argument isnm. Input short name will call the same function.<arg>indicate this argument should be replaced with some string according to your requirement.[arg]indicate this argument is optional (use default value instead).arg1 | arg2Choose a argument between arg1 and arg2.- You can use Tab to auto fill command name, player name and player ID, except
/mmo kick. Just like some UNIX terminals. - Command is case-insensitive. However, argument input by player is case-sensitive. Additionally, Tab Auto Fill rely on the function implemented by BML2, so it is also case-sensitive.
Server Status
/mmo connect [address]– Connect your specified server. If address argument is omitted, use the server setting of this plugin instead./mmo disconnect– Leave current connected server.
Player Status
/mmo list|list-id– Show a list containing all online player's name. if uselist-idargument, a extra temporary internal player ID will be attached to its name./mmo getmap– For all players, show which map player is playing and its corresponding sector. It is convenient for looking for players./mmo getpos– Show the position and ball type for all players.[1]/mmo reload– Reload all players status in client. If player name label and its shadow ball are mismatched, this function may solve this issue./mmo gettimestamp– Show all players extrapolation debug data.This command is served for the developer of this mod.
Player Interaction
/mmo say <text>or/say <text>– Send a public message in server with a content of <text>.[2]./mmo whisper <player name> <text>or/mmo whisper #<player ID> <text>– Send a private message for your specified player. This message only can be seen by you and your specified player./mmo announce <text>– Send a important public message in server. This message support non-ASCII characters and will be shown at the center of game window for a while./mmo bulletin [text]– Set server bulletin text. The bulletin text bar will constantly displayed at the top-center of game window.[3]/mmo announcemap– Explicitly notify server which map you are playing and which section you are staying. (It is convenient fot notify other players)/mmo teleport <player name>or/mmo teleport #<player ID>– Teleport to other player's position. Only works on Cheat Mode.[4][1]/mmo kick <player name> [reason]or/mmo kick #<player ID> [reason]: Kick the player from server with corresponding name (case-insensitive) or ID/mmo custommap <Name|reset>: Customize your map name which you are playing. This name will be reset when switching levels or sectors.
Tournament Status
/mmo cheat on|off– Turn cheat mode on or off for all players online./mmo countdown– Start the ready-set-go countdown./mmo dnf– Forfeit the game (did-not-finish)./mmo rank reset– Run this before activating the countdown to reset all ranking (applies to a single race across multiple levels)./mmo ready|ready-cancel- Signify to other players that you are ready for the race or cancel the ready status.
Misc
/mmo show|hide– Show / hide the console window for this mod. All status output from this mod will be available in the console, plus you can use commands of this mod in the console (without the/mmoprefix). Input and output in the console is no longer limited to standard ASCII characters.
Keyboard Shortcuts
Self Status
Tab: Toggle name plates for other players.F3: Toggle debug information.F3 + A: Reload player status. Use this to readjust when name plates and shadow balls are offset.Ctrl + Tab: Show realtime status of players in the race, including current map and checkpoint. [5]Ctrl + `: Show shadow ball of yourself (after network latency). Useful for latency test.[6][1]Ctrl + Shift + ↑: Reset camera. Useful when you accidentally set a nonstandard camera angle. Some rules force a player to forfeit the game if nonstandard camera angle is used.[7]
Tournament Status
Ctrl + [3 or 2 or 1]: Start countdown.Ctrl + 0: Start the race. Resets the race timer for all players. Depending on settings of the server, the level may be restarted.Ctrl + 4: Notify the players to ready up.Ctrl + 5: Ask the players to confirm readiness.Ctrl + D(press twice consecutively: Forfeit the current level (did-not-finish).
Available Servers
Considering the security of server, you should join corresponding Ballance community according to your multi-play requirements. Then, you can get an available server. Also, you can create a personal BMMO server and play with it. Its method will be introduced in the following chapter.
If you want to play with Chinese Ballance players, you should join Multi-play QQ Group and get server URL within it.
Or, there is a big latency when you are connecting to Chinese BMMO server, or you want to play Ballance with over world Ballance players, you can join Ballance Discord server and get server URL from #multiplay channel.
References
- ↑ 1.0 1.1 1.2 For some reason about reducing computing and network resources, server will not send player's position and status data when the server only have a single player. So the shadow ball also can not move following player. Because of this, the position and ball type data is not correct when the server only have 1 player.
- ↑ Before 3.1.5-beta5, due to the implementation of BMMO,
Spaceis not supported in message content. You need to use other symbol to split words if you need. For example, you can typewait/a/minuteorwait-a-minuteinstead ofwait a minute. - ↑ Bulletin text do not support line break. Please use a clear and short text for it. Additionally, bulletin will set to blank when all players disconnected from server.
- ↑ Teleportation only can move you to other player's position. It can not switch your sector automatically and also can not restore element statues.This command is frequently used with
/mmo getmap - ↑ Hold Ctrl then press Tab. The order matters.
- ↑
`key is to the left of1on a standard QWERTY keyboard and can be used to type tilde symbol (~) when combined withShift - ↑ Please allow 1-2 seconds for the camera to readjust and do not move before it's done. You can do this while inside a transformer to avoid some time loss.
