Administer // Modern & Modular free admin system [1.2]

image image image

image image

NEW: Playground Roblox game: Administer Testing - Roblox

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)

  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.

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

21 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
2 Likes

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.

2 Likes

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

2 Likes

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

2 Likes

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

1 Like

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.

1 Like

Sorry, the app server shut off overnight and I only was able to fix it now. If you were having issues with anything you can retry now.

The issue was a race condition with Mongo starting too slow on the VM and Administer was only waiting 3 seconds to boot. Has been fixed as of this commit, if you continue to have any issues please let me know!

This looks awesome and I love how you did the UI! I hope more people use this and be able to easily manage their game in no time!

1 Like

Version 1.1 released!

Welcome to the first major release notes for Administer! Usually they’ll be formatted like this post wish a short blurb, changes, fixes, and more.

This update was mostly focused on the big 1st wave of redesigning the configuration menu. There is more to come which you’ll see with Settings v2 and other large general overhauls.

Also, we are looking for QA members, come apply with this form!

Additions

+ Added a new /adm command to launch the panel from via TCS/LCS. Can be disabled in Settings. In a future update it may be able to be configured.
image
+ Redesigned the Marketplace view to be more compact and added a new animation.
+ Admins page has also been redesigned with better borders/padding, new headers, and a slightly-redesigned popup.

Video

Watch optimized-admins-2024-10-10_23.39.53 | Streamable

+ Add support for group ranks in the creation UI - sorry for forgetting this earlier!
+ Adds a fun animation that plays when you donate to help give a little more incentive - paying for developers and staff out of pocket is not cheap!
+ Redesigned bottom bar in configuration with new animations. This bar is just beginning its life and I believe these is more it can do in the future!
+ Slightly updated notifications to be taller to allow for three buttons at a time. More visual changes are coming to notifications soon.

Fixes

+ Fixed an issue which would cause the admins page to crash due to a missing edit sign.
+ Fixed a duplication issue with the app install window
+ Fixed a duplication issue with the update logs
+ Fixed an issue where the PFP background color on the homescreen would be incorrect (was always administer blue)

GitHub Diff

Apps

Player Management

Fixes

+ Fixed an issue which would cause the app to freeze when you looked up a player which had not existed
+ Fixed an issue which would cause data to not save if you sent a note

Announcements

Fixes

+ Fixed an issue which caused the panel to lose its blur when you’d open it.
+ Fixed an issue which caused the blur to be missing from notifications.
- Removed the close animation when an announcement was sent via the panel.
+ Fixed various crash cases with announcing

That’s it! Thanks for sticking around and keep the feedback coming please! Every little bit helps Administer improve as a product :heart:

Hi all,

Just noticed a bit of a security issue with places on the app server. An update is coming out right now to the server (no place updates needed) to fix this. This is nothing major, just that PlaceIDs were being recorded in the app’s DB entry which was being sent out to the client. No idea why it was like this in the first place but the issue has been fixed and I’ve wiped the entries clean so it’s like it never happened.

An update is coming out shortly but in the meantime, if anybody has anything which reads any of the following:

  • AdministerMetadata.AdministerIsOld
  • AdministerMetadata.AdministerVersionLastValidated
  • AdministerMetadata.AppDeveloperAppCount
  • AdministerMetadata.AdministerUpdatedAt
  • AppCreatedAt
  • AppInstalls
  • AppLikes
  • AppDislikes

then please remove them from your programs. They will be removed in an Administer update soon. Some will be removed in an update tonight to help condense wasted space and bandwidth.

The removed properties will all be set to 0 and I’ll be removing them entirely a couple of weeks after 1.2 releases so 1.0 and 1.1 panels can continue to work, but please be mindful of the time left.

AppLikes and AppDislikes will be available in a JSON AppVotes: {Dislikes: 0, Likes: 0, Favorites: 0, Score: 100.0} instead of individual properties. 1.2 will account for these changes so nothing will crash. Further, AppDeveloper will soon be replaced by a raw UserID instead of username. This will also not be changed until 1.2.

Thanks for understanding.

1 Like

Looks like a cool resource! Gonna try it! Maybe add a discord webhook feature if you dont have it already! :slight_smile:

1 Like

Hi there, that is planned as an app in the not-too-distant future!

I haven’t tried this but the UI looks nice, although I noticed some nitpicks I’d like to point out:
image
Felt like it needs some more spacing so it doesn’t touch the edge

image
Cut off text

image
Text got too small

image
Cut off text

Thanks for the feedback. All 3 of the bottom issues will be fixed by the work in progress configuration UI revamp (namely Settings V2) which will hopefully be finished within the next 2 updates.

I’ve taken the header feedback into account though, will look into a resolution for 1.2.

1 Like

Applications close Friday afternoon, if you want to be on the team this is your chance!