Bungee Queue | Prevent server crashes from player join overload! | Bungeecord/Waterfall [1.8-1.15.2] 3.0.2

Native Minecraft Version:

1.14

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16

Source Code:

https://github.com/Larskei-dev/BungeeQueue

Contributors:

Larskei

Tutorial, Setup, and common questions
​

This is a highly configurable queue system for Bungeecord or Waterfall [1.8-1.15.2]

Please submit a review if you like this plugin so I know to add more content and create more useful plugins like this!

INTENDED USE:
This plugin is designed for servers that are medium to large deployments, designed for use with player bases of 100+ players. While you can use this plugin with smaller playerbases that is the original design intention, this plugin is designed to be extremely lightweight and do as few calculations as possible in order to keep overhead to a minimum.


Permissions:
bungeequeue.skip
Gives permission to skip the queue, also will force override a waitingqueue or maximum size defined in the bungeequeue config.

bungeequeue.donor
The user then has permission that always puts them in a separate donor queue, this queue has its own adjustable multipliers and messages.


Commands:

/join (servername) - this will put you into the queue for the specified server

/queuetime (servername) - tells you the current queue time for the specified server

/qtime (servername) - tells you the current queue time for the specified server

Update 3.0.0 Complete ReWrite!
- Removed Server grouping (if you want to use it you can use a later version)

- Added a server full queue, where if a server is above the set maxlimit in the config, it will put those players in a waiting queue and check too see if a free slot is available every 1 second.

- Added config placeholders and got rid of the old message1+message2 system, you can now just use the placeholders listed in the config instead of the old system (THIS IS NOT PLACEHOLDER API SUPPORT)

- Changed the base command from /move to /join

- A much better looking and easier to read config!

​

Spoiler: Config

8b: '--------------------------------------------------------------------------'
'|': The multiplier below is what determines wait time, the larger the multiplier
the longer the queue gets exponentially per player in queue
'||': if 2 players are in queue 2nd player has Multiplier * 2 to wait before they
enter the server, if your server is crashing because of players joining to fast
try setting the multiplier larger
'-': '--------------------------------------------------------------------------'
Multiplier: 1
'|||': This decides whether or not to factor server size in (default is false)
'||||': If true new equation is (AmountOfPlayersInQueue * Multiplier) + AmountOfPlayersOnServer
--: '--------------------------------------------------------------------------'
IsServerSizeCalculated: false
DonorWaitMultiplier: 1
'---': '--------------------------------------------------------------------------'
'|||||': The message sent to non-donors, available placeholders %queuetime% %queueposition%
and %queuetotal% (QueueTime shows the estimated time till connection, queueposition
shows their queueposition, and queuetotal shows total players in queue
'----': '--------------------------------------------------------------------------'
EnteringQueueMessage: '&aThank you for queueing you will be connected in %queuetime%
seconds, you are %queueposition% player in queue'
ShowDonorQueueTimer: true
EnterningDonorQueueMessage: You are in donor queue, you are in %queueposition% and
will join in %queuetime% seconds, there are %donorqueuetotal% players in queue
SkippingQueueMessage: You have skipped the queue
FallBackServer: lobby
'-----': '--------------------------------------------------------------------------'
'||||||': if a server is over this many players this will pause the queue for those
specific people until that server has a empty spot available, it measures it based
off of this integer and not the maximum of the server (in case you want admins or
something to be able to login, anyone with bungeequeue.skip will override this,
and will always attempt to connect regardless if the playercount exceeds maximumsize)
available placeholder %waitposition%
'------': '--------------------------------------------------------------------------'
MaximumSize: 1
FullServerCannotConnectMessage: '&cThe server you are trying to connect to is full,
you will be connected once there is a free slot available'
'-------': '--------------------------------------------------------------------------'
'|||||||': Blocked Servers are servers that will not allow a player to do /join to
this server.
'--------': '--------------------------------------------------------------------------'
DenialToQueueMessage: '&cYou do not have permission to queue for this server.'
BlockedServers:
- example-server​

​

Support discord




Warning:
If a player has multiple donor or skip permissions at the same time it may throw errors, or crash.

If you are updating from a older version to a new version of this plugin you MUST follow these steps

1. Stop bungeecord
2. Delete the old BungeeQueue.jar
3. Delete the BungeeQueue Folder and all of its contents
4. Put the new BungeeQueue.jar into your plugins folder for bungeecord/waterfall
5. Start your bungeecord to generate the files.
6. Stop bungeecord
7. Configure the config.yml (follow the instructions in the config)
8. Start your bungeecord server

if you need support please contact me via Discord, my discord name is in my spigot profile, and in your bungeecord console when the plugin starts.


Please do not leave problems, requests or questions as negative reviews if you have never read any of the documentation or joined the support discord, I try to be a extremely active author of this plugin and cater to everyone's requests, just message me and I'll do my best!