Administer - Fully modular advanced administration panel

image image image

image image

Welcome to Administer, your personal admin panel.

What is it?

Administer is the admin panel that you control. You control what it does, who it belongs to, its design, and everything about it.

Why Administer?

Administer is quick. Like, really 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.

WARNING: Administer is a very early product. It’s in a state that I’m sure it will work and record data correctly, but you probably should avoid using it in a high-importance environment. It’s not exactly a beta product but the panel says so to avoid confusion for a “100% stable” release. Over the coming months you can expect lots of improvements, fixes, and new apps, all before the end of the year. For more information, please check out our trello board.

Prerequisites

Ensure HTTP Requests are enabled (required for app server communication) and studio APIs are on (required for datastores + lots of apps use other APIs)

COMMAND LINE INSERT (recommended)

Simply run game:GetObjects("rbxassetid://127698208806211")[1].Parent = game.ServerScriptService in the command bar and you’re done!

MANUAL INSTALL

  1. Download from Roblox

    • Conveniently, you can get it here.
  2. Insert into ServerScriptService

  3. 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)

https://youtu.be/f0q49wqpcdQ

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.

Likewise we are looking for QA testers so if you’re interested in helping out please reach out to me directly :slight_smile:

Credits

I couldn’t do it alone - huge thanks to the other people who make Administer and regular releases possible :heart:

Core UI + Scripts: @pyxfluff
Documentation: @iiPythonx
App development team: @CDot_NightHawk, @dogo8me2, @uvic1rn, @DullerKill7r
Community management: @RoltairTheProtogen
QA: @watamelnKalashnikov
Development funding: @TeaCem

3rd party resources
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.

10 Likes

Version 1.0.1

Version 1.0.1 is now out!

Changes

  • Change the default background image on the cards to stop it from showing the Administer logo if editable images are disabled/failing.
  • Significantly improve load times on the admins page.

Before:


After:

  • Adds the ability to see legacy module admins on the page.
    image

  • Remove myself from the admins whitelist by default (forgot to do that yesterday, sorry)

GH Diff: 1.0.1 · pyxfluff/Administer@ec6d741 · GitHub

Updating

Just run the same Setup command and you’ll be good.

game.ServerScriptService.Administer:Destroy()

game:GetObjects("rbxassetid://127698208806211")[1].Parent = game.ServerScriptService

Hey there, amazing job on Administer; I have to give you props that it is well-built and definitely has a bright future ahead of it. A question that popped into my mind is, why not utilize the wasted space? I’m no UI expert, but the panel seems large enough for many UI elements (buttons, etc.) , yet only a small amount of it is used. Are you planning to add more elements?

Image showcasing what I mean:

Hi! A lot of the design was made in Figma and Studio’s viewport on a 1080p monitor. Over the coming updates there will be lots of small UX refactors to make better use of space and shrinking things down.

For example, the navigation bar is being condensed and will soon look like this on a 1080p monitor:

I am more than open to suggestions from you or anybody else but there is work to be done for sure and I’m making sure as components get redone they fit on all devices no matter the size (current priority is the Configuration menu in general so that screenshot you sent will also be redone)

Originally the design was more like this which may be more fitting but I’ll get to that when I begin to redesign that menu


Yes, a part of a UI refactor would include adding more useful labels and stuff, like for example the rank creator. I’ll be sure to post updates in the Discord server when I get something.

1 Like

Thank you for the detailed explanation. It definitely makes a lot more sense now. I’ll definitely be looking forward to seeing these happen over time.

Best regards

1 Like

thank you for using my module!
i’d like to give a heads up that i updated my module yesterday for better performance

1 Like

Thank you, I’ll update it and push next release.

Updating here incase you’re not in the server. This will be a part of the upcoming configuration UI revamp, but here is the new UX incase you’re interested:

Ignore the bottom bar (i’m working on that next) but hopefully this will get people excited for what’s to come!

1 Like

Hey there! The UI looks amazing, it looks really modern and sleek. If I was a user who used other Admin Systems, why should I use Administer other popular administrative systems already on the Roblox platform? (Adonis & HD Admin) What features does this system have that others don’t?

1 Like

It’s up to preference and needs, really. Administer is currently more of a no-nonsense moderation system with none of the “fun” stuff you’d get on HD (capes, effects, etc) but it’s def something we are looking into (stuff like flying is coming in an app soon).

One of my favorite parts about Administer is you can list servers, see advanced player statistics, and more. We also don’t force you to have anything, that was one of my biggest peeves with HD admin. It’s a pain to edit the source, and it uses so many API slots for features you may not need. With Administer, if I don’t want Announcements all I have to do is click a button and it’s gone.

Administer is still in the early stages of it’s life and I’m excited to continue adding apps and features like the command bar which should make Administer the go-to for a lot of people. Stuff like this cannot be done with any other system on the market currently and we are working on adding even more :eyes:.

image
image

also, thanks, this means a lot! i’m aiming for an interface which is nice to look at but not form over function with pretty animations which are not hard to watch and i’m glad it didnt go down like my old module. still many thanks, glad you like it!

Hello,

Just pushed some hotfixes to a couple of apps. Should fix most of the crash cases and some misc bugs (announcements was breaking the UI acrylic). No new version because there is no new core distribution.