Skip to content
Oliver Martin edited this page Apr 10, 2019 · 2 revisions

Welcome to the official documentation for the SlingShot bungeecord plugin!

SlingShot catches players being kicked or disconnected from your servers and "slingshots" them to your lobby server (easily configurable) instead of them falling out of your network and not being able to log in! This includes stopping people disconnecting when one of your servers goes down! Instead they will just be connected to your lobby server for a more reliable playing experience!

When would you use this plugin?

Have a network comprised of modded and unmodded servers? If someone was on the modded server last and they try to log in to your network on their vanilla client, they join bungeecord which tries to send them to the modded server as it is where they were last. However, because they have a vanilla client they are rejected by the server and kicked from your network :( SlingShot will catch this and send them to your lobby server instead!

Have a server which regularly has to generate maps or becomes whitelisted and people can't connect while this is happening? If they try and log in usually they'd get a horrible error message and be kicked from your network, but with SlingShot they will be sent to your specified lobby server!

But wait won't this mess up my normal server kicks?! What if I have a server I dont want this to happen on?! Will the player be notifed what is going on?!

If you use Bungeecord there is a high chance you dont use the default minecraft kicks. A plugin such as BungeeAdminTools (which I would highly recommend) features its own /gkick command which will "globally" kick a player from your network. I suggest you find a plugin like this to deal with global kicks from bungeecord networks! Otherwise a regular minecraft /kick will cause the player to be sent to the lobby... UNLESS you use the blacklist feature provided in the config file, this means you can flag servers that slingshot should not catch kicks or disconnects from and also ignore particular kick reasons! And yes, you can add a message to show to players when they are slingshotted.

But I have many reasons why they might be kicked, how can I write a generic message?! D:

Luckily you can add %REASON% into your message field which will include the full reason for the original kick or disconnect! For example if I did my message as "You have been sent to the lobby because: %REASON%" in my config file. I might get the follow sorts of things sent to players:

You have been sent to the lobby because: This server is not yet loaded [54% complete]
You have been sent to the lobby because: Incompatible modpack for this server!

Oooh I have lots of features and ideas / critisims for the plugin, what can I do?!

I am very busy university student already maintaining the popular MultiChat bungeecord chatting plugin by myself so I don't have much in the way of free time at the moment. I release this plugin to help others as I originally wrote it for the server I administrate as none of the other options we tried worked as we required. This plugin quite simple, and while I might extend it in the future don't expect any miracles ;) Any bugs feel free to message me and I will always try my best to see what I can sort out for you :)

Clone this wiki locally