:warning: Administer 1.0 is now discontinued
Get Administer 2.0 here: Administer 2.0 | Simple & open administration

What is it?

Administer is the admin panel that’s fully yours. You control what it doeswho it belongs toits designand everything about it.

Why Administer?

Administer is quick. On linux (a traditionally slower platform)Administer fully initializes in just over one secondand 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 serversseeing player trust scoresand moreyou 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

    • Convenientlyyou can get it here.
  2. Insert into ServerScriptService

  3. You’re done! Press Shift + Z and have fun configuring.

How to use it

1. Install apps

Administer has an intuitive admin panel that anybody can use. Howeverfor the sake of simplicityit comes with only one app. To install an appgo 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 rankgo to Configurationthen click Admins on the bottom. From there just click the + symbol on Ranksand 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 userjust enter their User ID. For a groupenter 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 thereyou 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 haveif your rank is missing them.

Then click finish and you’re done! You can edit the rank at any time you needjust 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 likingwith options to change the animation speedkeybindsand more.

Application API

Administer features a very robust API to make your own apps. For more informationplease read the application API:

(The app API is going to be overhauled very soonif you are planning on making apps please either join the Discord server or subscribe to this thread so you do not miss the 2.0 announcement.)

Contributions

Administer is open source and our team appreciates any contributions you’re willing to make. Anything is welcomefrom bug fixes 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 you’re feeling niceyou 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 in our community server! We have support channels there so you can make a thread to talk with developers and the support staff.

Credits

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

Core team: @pyxfluff
App development team: @dogo8me2@DullerKill7r @infirmn
Community management: @RoltairTheProtogen

3rd party resources
License

Administer is proudly free software under the GNU AGPL 3.0 license.

WARNING: You MAY NOT use any of Administer’s assets (codesoundUIvisuals) to train any AI model regardless of what it is forI 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 doubtask! For exampleeven though I can’t stop you please do not literally just rip code for your own admin system.

:memo: Update Logs
Current Version: 1.2.3
Logs for 1.2: Administer // Modern & Modular free admin system [1.2] - #37 by pyxfluff

48 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 yesterdaysorry)

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
6 Likes

Hey thereamazing 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 iswhy not utilize the wasted space? I’m no UI expertbut the panel seems large enough for many UI elements (buttonsetc.) yet only a small amount of it is used. Are you planning to add more elements?

Image showcasing what I mean:

1 Like

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


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

5 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

3 Likes

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

3 Likes

Thank youI’ll update it and push next release.

2 Likes

Updating here incase you’re not in the server. This will be a part of the upcoming configuration UI revampbut 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!

2 Likes

Hey there! The UI looks amazingit looks really modern and sleek. If I was a user who used other Admin Systemswhy 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?

2 Likes

It’s up to preference and needsreally. Administer is currently more of a no-nonsense moderation system with none of the “fun” stuff you’d get on HD (capeseffectsetc) 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 serverssee advanced player statisticsand more. We also don’t force you to have anythingthat was one of my biggest peeves with HD admin. It’s a pain to edit the sourceand it uses so many API slots for features you may not need. With Administerif 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

alsothanksthis 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 thanksglad you like it!

1 Like

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.

2 Likes

Sorrythe 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 commitif you continue to have any issues please let me know!

1 Like

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!

2 Likes

Version 1.1 released!

Welcome to the first major release notes for Administer! Usually they’ll be formatted like this post wish a short blurbchangesfixesand 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.

Alsowe are looking for QA memberscome 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/paddingnew headersand 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:

1 Like

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 majorjust 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 meantimeif 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 workbut please be mindful of the time left.

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

Thanks for understanding.

2 Likes

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

2 Likes

Hi therethat is planned as an app in the not-too-distant future!

1 Like

I haven’t tried this but the UI looks nicealthough 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

1 Like

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 thoughwill look into a resolution for 1.2.

2 Likes

Applications close Friday afternoonif you want to be on the team this is your chance!

1 Like