OperatorDefine commands, not an admin panel.

A command console and permission system for Roblox, in pure Luau. One require, one call, and nothing reaches a player who is not allowed it.

Get started

Command syntax

GitHub

click to try it

The built-in console. Press F2 in game — or click above to drive this one.

🔒

Nothing reaches an unauthorised client

No modules, no remote, no interface. A player who is allowed nothing has no way to tell the package is installed.

How delivery works

👥

Roles are built in

Declare them by group rank or user ID, inherit between them, and permissions resolve themselves. No hooks to write.

Permissions

⚡

One require, one call

No client bootstrap, no configuration files, no folder you have to create first. Every field is optional.

Setup

🧩

Typed argument tables

Arguments arrive as a checked table, not positional strings, so a typo in a handler is a type error rather than a runtime surprise.

Commands

🎨

Extensible argument types

Define your own with validation, transformation and autocomplete, and compose them on top of the built-ins.

Argument types

📋

An audit trail you can trust

Every dispatch is recorded with server-stamped identity, and records a client reported rather than the server observed are marked as such.

Audit log

A command

luau

local Operator = require(game:GetService("ServerStorage").Operator)
local Command, Types = Operator.Command, Operator.Types

export type KickArgs = { target: Player, reason: string }

return (Command.new("kick") :: Operator.Builder<KickArgs>)
	:description("Kick a player")
	:arg(Types.Player, "target", "Player to kick")
	:arg(Types.String, "reason", "Reason shown to the player", { rest = true })
	:permission("moderator")
	:destructive()
	:run(function(context, args)
		args.target:Kick(args.reason)
		context:reply(`kicked {args.target.Name}`)
	end)

Inside run, args.target is a Player and args.reason is a string, fully checked.

Starting it

luau

local Operator = require(game:GetService("ServerStorage").Operator)

Operator.Start({
	Commands = script.Parent.Commands,
	DefaultCommands = { "debug", "moderation" },

	Roles = {
		owner = { UserIds = { 1234567 }, Inherits = { "moderator" } },
		moderator = { GroupId = 123456, MinRank = 200 },
	},
})

That is the whole setup. Operator.Start({}) also works, and gives you a console for the place owner and nobody else.

Where to next

If you want to…	Read
install it into a place	Installation
know what the console accepts as you type	Command Syntax
write your first command	Commands
decide who can run what	Permissions
look up an exact signature	API reference
build your own interface on top	Custom Interfaces

Attributions

Centurion: console interface design and interaction model. Operator's console is a structural port of Centurion's terminal UI, reimplemented in Luau.
Cmdr: prior art for Roblox command consoles, and the origin of the quote-aware argument splitting both use.
Vide: the reactive UI library the console is built with, vendored under Client/UI/Packages/.