Kometto Advanced Banning System Plugin - Information for Users

Welcome to the official guide for the Kometto Advanced Banning System (K.A.B.S.). This powerful tool enables developers to manage bans effectively within their Roblox games, providing a streamlined interface and robust backend support. It is the very first plugin to utilise the brand new Roblox Ban API, making it an innovative and must-have tool for all developers - big and small. Below, you’ll find all the information needed to install, use, and troubleshoot this system.

Creating this plugin took about a month and a half, it was a difficult and complex journey with it being my first ever plugin but I am so relieved it’s finished to a great standard!

PURCHASE HERE: https://create.roblox.com/store/asset/18532618778/Kometto-Advanced-Banning-System

Default plugin settings for bans: Alt accounts are banned and bans are applied universally.

Customisable settings: Ban reasons and ban durations (in seconds and includes permanent)

I plan to eventually add support for being able to configure universal/non-universal bans, alt account bans and any new features Roblox brings to this API.

To contact Kometto, please send a private message to @RealCometGames on Twitter (or X).


Installation Guide

  1. Add the Plugin to Your Experience:
  • Install the K.A.B.S. Plugin from the Roblox Library.
  • Launch the plugin through the toolbar button labelled “Launch Kometto Advanced Banning System.”
  • Ensure that script injection is permitted, otherwise the plugin will not work. The reason you need to allow this is because the plugin makes use of 2 scripts (which must be kept permanently in your experience) to get the ban data from the datastores and then use the Roblox Ban API to make the actual ban requests since the API only works in live servers.
  1. Install the Ban Handler Scripts:
  • After opening the plugin interface, click the “Install Ban Handler” button. This will place the necessary server scripts into your ServerScriptService.
  • The system automatically checks for existing installations, so you don’t need to worry about duplicate scripts.

Feel free to dock the widget anywhere you’d like and expand so that you can view the entire interface.


How to Use K.A.B.S.

Banning a Player

  1. Open the plugin interface.
  2. Enter the player’s Username or UserId.
  3. Specify the Ban Duration (in seconds) or use -1 for a permanent ban.
  4. Enter a Ban Reason.
  5. Click the “Ban Player” button.

Unbanning a Player

  1. Enter the player’s Username or UserId.
  2. Click the “Unban Player” button.

IMPORTANT: The Roblox Ban API is strictly ServerSide only. To mitigate this, the plugin sends the ban data to a datastore. Live servers will check the datastore from time to time to update the necessary changes after every interval which you can change manually if you’d like. Therefore, it can take a little bit of time to take effect but all new servers will reflect the changes immediately.


Important Notes & Troubleshooting

1. Unbanning Yourself

Due to the server-side nature of the ban system, unbanning yourself from the game can be challenging. If you mistakenly ban yourself, you will need to go to the Creator Dashboard for your experience and scroll down to the Bans tab to manually remove your UserId from the banned list.

2. Cooldown Mechanism

The system includes a cooldown to prevent spamming the DataStore service, ensuring efficient and responsible data management. If requests are failing, consider the possibility that you might be sending too many requests.

3. Debugging Information

  • Ban Requests: If a ban doesn’t apply as expected, check the DataStore for errors. Ensure the ban information (UserId, duration, reason) is correctly formatted. Status messages are also printed into the output.
  • Unban Requests: If a player remains banned after an unban request, verify that their UserId is removed from both the ban data store and the pending unbans list. Make a note of all status messages in the output and contact me if there’s an issue.

4. Ban Handler Script Checks

Before installing any scripts, the system checks whether the necessary server-side components are already present. If you’re seeing unexpected behaviour, ensure that these scripts haven’t been accidentally removed or corrupted. It is not recommended to remove any remote events or scripts yourself because it can harm the ability for the plugin to operate normally.


Troubleshooting

1. Ban Not Applying

  • Verify that the UserId and ban duration are entered correctly.
  • Ensure the server script (UnifiedBanManagementServer) is correctly installed in ServerScriptService and the server script (BanApplier) is also correctly installed in ServerScriptService.

2. Player Remains Banned After Unbanning

  • Double-check that the unban request has processed successfully. Run a new live server and wait up to 60 seconds to be extra sure so it has time to go through.
  • Use the Creator Dashboard to remove the UserId from the ban data manually if necessary.

3. Plugin Interface Issues

  • If the plugin UI is not responding, try reloading the plugin or reopening Roblox Studio.
  • Ensure all required scripts and assets are correctly installed.
  • Reinstall the plugin and try again.

Additional Information

Ban Management Dashboard

To view and manage bans directly, use the tools available on the Roblox Creator Dashboard. This will allow you to manually edit or remove entries if needed. If you wanted to stop alt account bans for a specific profile, you can do so from this dashboard. The plugin, by default, bans alts and applies bans universally.

Compatibility

K.A.B.S. is designed to be compatible with a wide range of experiences and should work seamlessly in most Roblox environments. If you encounter any compatibility issues, please contact Kometto for additional support.


This guide is meant to provide a comprehensive overview of the Kometto Advanced Banning System. For further updates, improvements, or community feedback, keep an eye on this thread. Thank you for using K.A.B.S., and happy developing!

Thank you so much to Roblox for creating such a fantastic API and for making such a helpful documentation that allows developers to easily understand how to use it.


Changelog
  • 1st July 2024: Work on K.A.B.S. begins
  • 14th August 2024: K.A.B.S. officially released to the public

Note: This thread is automatically locked, and no further comments can be made. For any additional help, please contact Kometto.