Hiya,
I’ve spent a little while recently working on an Admin Panel that could be set up in studio instantly for my games, and I thought I should release it for anyone else to use freely in their games as well.
Qban helps you to more easily and quickly determine if a player should be banned, by giving you a short preview into their history/offenses. And if so you chose to bring down the hammer, the ban is enforced using Roblox’s Ban API. Qban also allows players to report abuse in a server, and call for an admin to respond!
Admins also have a small variety of tools they can use in a server to aid in moderation, like highlighting players, locking a server, shutting down a server, using notepad that saves, being able to fly around, and more…
Its ‘key feature’ also why I chose to name is Qban is, Quick ban, which shows a list of everyone currently in the server, allowing you to select that person, and then, so chose, permanently ban them with one click (You can also kick them from this menu)
Qban works on PC and Mobile, though works better on larger screens… (Mobile users wont be able to use the fly feature however)
Image of what the home screen of Qban looks like for admins:
Image of what the home screen of Qban looks like for non-admins:
Quick ban menu:
Image of what Qban looks when not open (Sits in the top left corner of the screen):
Set up:
If you’d like to use Qban in your game you can get the model here: Link
- Add the Qban model into workspace (Ensure you have explorer open)
- Enable Studio Assess to API services (Enable Data stores)*
- Open 'Qban_Settings_And_Documentation*
- Scroll down until you see Settings
- Change Qban.HeadAdmin to the UserID of the person you’d like to be the Head Admin (By default it will be set to the games owner)
- Only the Head Admin can assign and remove Admins, you can change the Head Admin at any time by changing the UserID in the script
- Feel free to also change the other settings (Which have comments explaining them) (e.g. disabling player reports)
Documentation:
Ban a player
METHOD 1:
- Open the Ban tab in Qban.
- Enter the player’s username or user ID.
- Configure ban details:
- Alt Detection is off by default. Enabling it may ban accounts mistakenly linked (and you can’t see which accounts are affected).
- Bans are permanent by default.
- Uses Roblox’s Ban API. More info: https://create.roblox.com/docs/reference/engine/classes/Players#BanAsync
- Click Ban to ban the player.
METHOD 2:
- Open the Quick Ban tab in Qban.
- Select a player from the list.
- Configure ban details (same as above).
- Click Ban to ban the player.
Unban a player
- Open the Ban tab in Qban.
- Enter the player’s username or user ID.
- Click Unban to Unban the player.
- It will succeed regardless of if the player was already banned or not
View Ban History
- Open the Ban tab in Qban.
- Enter the player’s username or user ID.
- Click the History tab
- History will be displayed ONLY for the users latest ban, you will need to visit your games Creator hub to view the players ENTIRE history
- NOTE: To see everyone who is currently banned you will need to visit your games Creator hub
Kick a player
METHOD 1:
- Open the Quick Ban tab in Qban.
- Click the Kick tab.
- Select a player from the list.
- Type in a Reason, what the player being kicked will see.
- Click Kick to kick the player.
- NOTE: Kicks will not appear on a player’s record.
METHOD 2:
- Open the Ban tab in Qban.
- Enter the player’s username or user ID.
- Select Custom or type in 1 minute for the Ban length.
- Type in a Reason, what the player being kicked will see.
- You can also type in a private note that only other admins can see.
- Click Ban to ban/kick the player.
- NOTE: This method may be preferable if you want to record a kick on a player’s record.
Reports
- Open the Report tab in Qban.
- Select a report from the list
- Reveiw the details of the report
- Click Join to Join the player in their server, click Close to close the report.
- NOTE: Reports expire after 1 hour (You can adjust this in the settings), if you fail to join a player, it is very likley the server they were in closed.
Add or remove Admins
Open the Admin tab in Qban.
- Select a Player from the List or enter a player’s username or user ID.
- Click Admin to add them as an Admin, Click Unadmin to remove them as an admin
- NOTE: ONLY Head Admins can change who is an admin, Other admins cans see who else is an admin
Misq Information
- The fingerprint icon you see next to selected players shows if that player has been banned before (Green = No Ban History, Red = Ban History, White = No Data)
- Report bugs under this Dev forum post
- Changing a Head admin, will not remove their admin status, the new head admin would need to demote them|
Remove Qban
- Delete Qban from workspace
- NOTE: Qban does NOT delete any pre-existing or created Save data, if you so chose to re-add Qban, the orignal data will be used again (Except for the settings in this script they will be reset)
(Documentation can also be found inside Qban)
Disclaimers:
Qban was not written in the most effective or best way possible, as I am not an expert coder, so please do limit any expectations. I would love to here your opinions, criticism, etc… as well feel free to post bugs or other complaints you have and I’ll do my best to address them
*In this regard Qban also uses a lot of very poorly constructed Data stores, which may be resource intensive, I’ve only been able to test Qban under very small sample sizes.
This is V1.0.0, I will try to release updates, but if you do want to use Qban expect bugs and issues, though I’ve tried my very hardest to squash them already… Also note that Qban of course, is not going to compete with more advanced admin panels or specialty made moderating tools, but for some projects this might be perfect…
Obviously, you are also completely free to make changes and updates to Qban as well, and publish your versions!
Cheers,
rorobot12, Airbase Development