MC Plugin ML MatchMaker 2.5.2

Make your minigames start fast! Server queues! Eliminate the problem with half-filled servers!

MatchMaker
From the author of legendary MultiLobby balancing plugin available since 2014!
With this plugin you will be able to speed up the process of filling and starting your minigame servers. Imagine you have 10 SkyWars servers but players join different servers so they wait much longer for the minigame to fill up and start as the minigame requieres certain amount of players to start. This plugin will automatically check status of your minigame servers, then the server with joinable status will be selected and filled with players. Once filled MatchMaker will select another available server and fill it as well. You can choose between random rotation of servers and round-robin.

MultiLobby is a family of plugins on the market since 2014!


Features:

- Speed up your minigames start times, don't let your players waste their time waiting for others to join
- Support for multiple groups of minigame servers
- Server status detection (multiple "ready to join" statuses support)
- Players will always be send only to available/joinable servers
- Offline detection! You can turn off any server for maintenance at any time, players won't even notice!
- Queues! If all servers are full or in-game, players will be placed to the queue (first in, first out style).
- Useful commands to see status of each group or server
- NEW: Permission redirects: Redirect players to server based on their permissions!
- Multi-Bungee setup support
- Party And Friends Support (party members join the same server, works for single bungee setup only)
- Fast discord support with over 150 members.


Which minigames are supported ?
All minigame plugins are supported as long as they print their current game status into MOTD.


How to setup:
1. Drop the .jar file into your bungee plugins folder
2. Configure your servers for ML MM (MultiLobby MatchMaking), there are 2 examples in the default config SkyWars and BedWars groups
3. Add exact server names matching your bungeecord server names to your matchmaking group
4. Setup your server selector plugin (or any other way how your players connect to that minigame)
5. Setup the server selector plugin to send players to any server that is inside the group and ML MM will take care of the rest. For example if you have SkyWars group setup your server selector that it will send all players to SkyWars1 server and ML MM will automatically select them free server they can play on (even when SkyWars1 is offline or full).


How to send a player to a group:
Option 1: Send player to any server that is inside any group and MatchMaker will take care of the rest.

Option 2 (Fake servers): Create a fake server in bungee config, give the server nonsense IP (like 2.2.2.2 or something) and name the server exactly the same as your group. Then anyone connecting to this server from any plugin will be send to the group instead.


Queues:

Once a certain group has no more "joinable" servers, meaning servers are either full or all in-game and do not accept any more players, then players are placed into the queue.


Player will get fully customized message about beeing placed in queue. Also his initial position is displayed. Players will be continuously updated when their position in the queue chages as you can see in the screen above.
- Once player position in the queue is 0, he will be connected automatically to the free server!
- Players in the queue can decide to leave the queue at any moment with command /lq or /leavequeue




/gstatus <group>:

Group status command will give you a brief overview of all servers in the group:




/mlmstatus:
This command will provide you with details about all your minigame groups. Total players for each group, queue size, number of free servers and finally a current server, which is the server MatchMaker is currently filling up with players. In the screen below you can see, that we have 2 groups, SkyWars and BedWars. In this example we can see that BedWars group currently has no available servers for players to join.




PAPI Support:
- You can use PAPI tags to count all players in the server group using tag: %bungee_groupname% (for your "BedWars group, the PAPI variable will be registered as %BedWars%, so make sure to name your groups in a way there is conflict with other plugin's variables)
- You need to have fake servers feature enabled in config!


Commands:

/gstatus <group> - Status of all servers in the group
/mlmstatus - Overall status
/mlmreload - Reloads the plugin
/lq or /leavequeue - Leave the queue you are currently in
/mlmqremove <player> - Manually remove player from a queue (requieres mlm.admin)
/mserver <server> - Directly sends you to the target server
/mserver <player> <server> - Sends specified player to the specified server directly
/mgroup <group> - Sends you to the group
/mgroup <group> <player> - Send other player to the group


Permissions:
mlm.admin - Grants access to all ML commands
mlm.status - Grants access to /gstatus command
mlm.reload - Grants access to /mlmreload command
mlm.leave - Grants access to /lq or /leavequeue commands
mlm.ignore - Player with this permission will ignore matchmaking. This allows admins to join whatever server they need
mlm.mserver- Grants access to /mserver <server>
mlm.mserver.others - Grants access to /mserver <player> <server>
mlm.mgroup - Grants access /mgroup <group> <player>




Troubleshooting:
1. Do not test on admin account since mlm.ignore permission causes you to be ignored by matchmaker
2. See your actual server and group statuses with /gstatus <group> and /mlmstatus