What is it?
Administer is the admin panel that’s fully yours. You control what it does, who it belongs to, its design, and everything about it.
Why Administer?
Administer is quick. On linux (a traditionally slower platform), Administer fully initializes in just over one second, and just over .3 seconds in a live server!
Administer is personal and tuned to your game. You are free to remove any apps (commands/functions) you don’t need. You can customize a lot of the views and how the system operates just for your game.
Administer is secure. All server requests are validated before taking action and all panel assets are stored in the server. Apps have the proper API to validate admin status.
Administer is open. Fully open-source client and server code and app server on Github. Contributions are more than welcome and will be reviewed.
Administer is powerful. With multiple features like listing servers, seeing player trust scores, and more, you get to take control of your game once again and know all about your players.
Quickstart Guide
Administer is ready to go out of the box. Just follow these simple steps and you’re ready to go immediately.
Ensure HTTP Requests are enabled (required for app server communication) and studio APIs are on (required for datastores + lots of apps use other APIs)
-
Download from Roblox
- Conveniently, you can get it here.
-
Insert into ServerScriptService
-
You’re done! Press Shift + Z and have fun configuring.
How to use it
Note: We’re working on import scripts which will come relatively soon, so you can import admins, custom commands, bans, etc from existing systems like product: exe V3/4, HD Admin, Adonis, and more! They won’t be out until our large Apps update (scheduled for December) so it’s nothing to hold out on.
1. Install apps
Administer has an intuitive admin panel that anybody can use. However, for the sake of simplicity, it comes with only one app. To install an app, go to the Marketplace in Configuration and then reload your servers. Think of apps as groups of commands each with their own options and abilities.
Please note that existing ranks will NOT have access to the page. You may want to wait until you finish adding apps to make ranks.
App installation demo (video)
2. Add your staff as admins
The owner of the game has admin by default (the group/user), and sandbox mode is enabled (all people in studio have admin). To create an admin rank, go to Configuration, then click Admins on the bottom. From there just click the + symbol on Ranks, and you’re done.
Creating a rank is a simple process. After you’re done selecting a name (which is filtered), you’ll have the ability to add people based on a group or user ID. Just click “User” or “Group” at the bottom to add the member. If it’s a user, just enter their User ID. For a group, enter the group ID and the exact rank ID in the box next to it. You can add the same group in another card to make another role the same rank. This process will be improved over the coming months.
From there, you can enable what apps you want them to have access to. I understand this is very barebones at the moment and it will be improved in a future update with the appropriate API to check via your own app. Click on an app to disable it and click again to re-enable it. Please note that you will only be able to give access to Apps that you have, if your rank is missing them.
Then click finish and you’re done! You can edit the rank at any time you need, just click the settings icon next to the rank in the same area and configure it via the menu which pops up.
3. Make it yours
Administer is custom. You can edit your game’s settings in the configuration menu to your liking, with options to change the animation speed, keybinds, and more.
Expect a more robust configuration system in the coming updates which will have a better keybind editor, personal or game level toggling, etc.
Application API
Administer features a very robust API to make your own apps. This topic isn’t for that though and we have documentation you can read. If you have any issues please make a GitHub issue with a documentation tag so the maintainers can fix it.
Contributions
Administer is open source and our team appreciates any contributions you’re willing to make. Anything is welcome, from bugfixes to feature additions. Please make sure to test your code before pushing it.
Note that if we don;'t see a feature as fit it may be declined. We strongly suggest that you post your feature idea either here or in our server for developer approval first.
If your new feature requires new UI please attack it as an rbxm in your PR. Eventually I’m considering making the UI code via Roact or something else so you can directly submit it, but that’s not for today.
If you’re feeling nice, you can do a task from our Trello list. Think of it as a gift to our developers - one less thing we need to do!
Issues
Please report any and all issues on here and our server! Administer is a very early product still in active development. You shouldn’t experience any dealbreaking bugs but I am there will probably be some unintended issues.
If anything doesn’t make sense to you on the UX end also please let me know here - i’ll listen as best as I can!
You can also report it in the server preferably so we can triage it correctly and not just watch this thread.
Credits
I couldn’t do it alone - huge thanks to the other people who make Administer and regular releases possible
Core UI + Scripts: @pyxfluff
Documentation: @iiPythonx
App development team: @dogo8me2, @DullerKill7r
Community management: @RoltairTheProtogen
Development funding: @TeaCem
3rd party resources
- UICons: FlatIcon
- QuickBlur: @pixe_ated
- MUI Button Animations: @Qinrir
- neon: @Fractality
- Shime: @WinnersTakesAll
License
Administer is licensed under the GNU AGPL 3.0 license. You can do whatever you’d like, you just have to open-source anything you do for it (GitHub fork/other Git hosting service).
WARNING: The only exception to this is AI training. You MAY NOT use any of Administer’s assets (code, sound, UI, visuals) to train any AI model regardless of what it is for, I do not support AI training and I am not donating my code to it.
Read more on the GNU AGPL 3.0 license here. The license is what we follow but please have common sense. When in doubt, ask! For example, even though I can’t stop you please do not literally just rip code for your own admin system.