IT IS ADVISED TO USE BLUEBERRY PLUS. We have released a way better and safer open-source system. We advise you to use it instead.
Click here.
Blueberry is a new system that allows you to ban/temporarily ban/issue account-based warnings for players who play your ROBLOX game. We all use moderation systems for our ROBLOX games. We all ban users from our game. Most moderation systems work with the basic kicking option: whenever a user joins the game, if their username or ID matches the data in the ban DataStore, they get kicked.
Blueberry’s purpose is to allow developers to display a ban screen instead of instantly kicking the player. Similar to ROBLOX’s website account ban/warning screen, Blueberry will show the reason for the punishment and allow the user to either accept and continue (for warnings) or log out (get instantly kicked) from the game. Blueberry allows you to replace the basic moderation (kicking) screen with a custom GUI.
Images and how it works will be shown in the ‘Showcase’ section below.
Blueberry is 100% free and open-source. Everyone can get it from the ROBLOX library. Get the model now:
To set Blueberry up, you will need to own the model above. Once you do, copy/insert the model in your game.
You will notice a Folder named ‘Blueberry’. Make sure that you place it inside ServerScriptService. If it is not placed there, the model will try to parent itself automatically, but there is a chance of malfunction.
Once the whole Folder is placed inside ServerScriptService, you will need to enable Allow HTTP Requests and Enable Studio Access to API Services in the ‘Security’ tab of your game settings.
Once you finish that, you can consider that Blueberry is installed. The system can now operate, however, you will still want to configure the settings. To do this, open the ‘Blueberry’ Folder, now situated in ServerScriptService, and open the ‘Settings’ file. Customize the settings - everything is explained inside the settings script (comments).
As you might probably know, ScreenGuis can only be client-sided, meaning that exploiters can modify or even delete them. Does this mean that they can bypass the punishments issued with Blueberry?
Well, not quite. Blueberry has several scripts that check the status of the punishment UI. They are linked to each other so that whenever a script is being removed, the others will take action. We have implemented a server-side kicking system, meaning that the kicking request will be handled by the server (so that it cannot be bypassed).
As a disclaimer, the system might still be vulnerable, even though we have checked several times and several different methods to bypass it and patched the vulnerabilities we found.
To avoid unwanted punishment bypasses, we recommend enabling the ‘TempBan Auto-Kick’ and ‘PermBan Auto-Kick’ options in the settings file. This will automatically remove the suspect from the server after the specified amount of time.
With version 1.02 and up, we have added a new security system that will delete the character of the suspect (applies to bans, kicks, slocks, and temporary bans), and disables the chat for them. Meaning that the suspect will be no longer able to interact with the game even if they bypass the punishment screen.
If you find a security vulnerability and wish to report it, please contact me via DevForum, or Session 42 Studios via the website (safe link - Tawk) linked at the bottom.
Blueberry’s best feature is that it allows everyone, even with less scripting skills, to integrate the punishment system with their own scripts. Blueberry has a built-in API that allows you to issue a moderation action by only firing a function. This is the basic usage of the API module:
Require the module: local BlueberryAPI = require(game.ServerScriptService:WaitForChild("Blueberry").Data.API)
Fire functions at your will:
BlueberryAPI:createWarning(username, reason, moderator)BlueberryAPI:removeWarning(username, reason, moderator)BlueberryAPI:tempBan(username, duration, reason, moderator)BlueberryAPI:permBan(username, reason, moderator)BlueberryAPI:kick(username, reason, moderator)BlueberryAPI:removeBan(username, reason, moderator)BlueberryAPI:slock(reason, group ID, minimum rank to ignore, moderator)BlueberryAPI:unslock(moderator)
usernameshould be a string,durationshould be a number,reasonshould be a string,moderatorshould be a string.
Blueberry also comes with a set of RemoteEvents that allow you to take moderation actions via LocalScripts.
Full documentation can be found on Session 42 Studios’ knowledge base (safe link - Tawk):
https://session42studios.tawk.help/category/api-documentation
You can contribute by reporting system errors, issues, vulnerabilities, etc., or suggesting new features. You can do this via our Discord server, via the Session 42 Studios knowledge base, or via DevForum (messaging me).
Also, you could add credits to Session 42 Studios if you remix the model.
Warning system, temporary ban system presentation:
Permanent ban system presentation:
Security systems presentation (exploiter trying to remove the UI):
ROBLOX’s DataStore Service has a rate limit, meaning that if you create and remove the same punishment within a very short time, the action will be queued.
Blueberry can’t currently update automatically so keep an eye on the developer console (output) of your games, as it will automatically print if it is outdated.
We are open to suggestions and critics, but we highly appreciate a friendly tone.
The logo icon is provided by Flaticon.
- Session 42 Studios knowledge base; Help Center : Session 42 Studios
- Blueberry model; https://www.roblox.com/library/9171111506/
- Blueberry documentation (S42S KB); Blueberry System set-up : Session 42 Studios
- Session 42 Studios ROBLOX group; Session 42 Studios - Roblox
- GitHub repo; GitHub - session42studios/blueberry: Blueberry’s purpose is to allow developers to display a ban screen instead of instantly kicking the player. Similar to ROBLOX’s website account ban/warning screen, Blueberry will show the reason for the punishment and allow the user to either accept and continue (for warnings) or log out (get instantly kicked) from the game.
. Thanks for the feedback.