Settings

The files

Settings

Debug = true,
Prefix = "u!",
SplitKey = " ",
CommandDebounce = 0.25,
CommandFrequencies = { shutdown = 5, nuke = 3, explosion = 1, vote = 10, permrank = 2, rank = 1 },
WarnThreshold = 3,
WarnAutoAction = "kick",
WarnAutoBanDuration = 86400 * 7,
WelcomeNotification = true,

Changing the prefix changes the chat commands too, because they are registered from it at startup.

The private server blacklist

VIPServerCommandBlacklist = {
    "permrank", "unpermrank",
    "ban", "tempban", "unban",
    "globalservermessage",
    "savemap", "loadmap",
},

Commands in this list are refused inside a paid private server, even for an Owner. The check requires both a private server id and a private server owner, so it applies to paid private servers and not to reserved servers your own code creates.

Messages

Messages = {
    ServerClosed         = "The server has been shut down.",
    ServerCloseWarning   = "The server is being shut down by the administrator.",
    LockdownKick         = "A lockdown has been activated on this server …",
    LockedKick           = "This server is locked. You cannot join.",
    KickMessage          = "You Are Kicked From The Game\nReason: $reason\n",
    BanDisplayReason     = "You are banned from this game. Reason: $reason",
    TempBanDisplayReason = "You are temporarily banned from this game. Reason: $reason | Duration: $duration",
    BanSuccess           = "Player permanently banned successfully",
    BanFail              = "Ban failed: $error",
    TempBanSuccess       = "Player temporarily banned for $duration",
    TempBanFail          = "Temporary ban failed: $error",
}

$reason, $duration and $error are replaced at display time. These are the lines a punished player actually reads, so they are worth writing in your game's own voice.

Localization

Localization = { Self = "me", All = "all", Other = "other" },

Renames the three targeting keywords. The English words keep working alongside whatever you set. See Choosing targets.

The folder layout

Everything except the first is recreated at runtime. Edits to the replicas are lost on the next server start.

The remotes

One RemoteEvent and one RemoteFunction under Core/apEvents, multiplexed by a leading string.

Every handler that does anything privileged re-checks the caller's rank and logs a warning when it refuses. The panel's own gating is a convenience on top of that.

The data stores

Bans themselves are held by Roblox, not here; the punishment store keeps the reasons and the history alongside them.

Adding a command

Two files, always both:

-- Shared/Config/Commands.luau
Commands.myCmd = {
    Aliases = {"mc"},
    Category = "Utility",
    Permission = "Mod",
    Description = "What it does.",
    Args = {
        { name = "target", type = "Players", default = "me" },
        { name = "amount", type = "Number", default = 10, min = 1, max = 100 },
    },
    Log = true,
    Webhook = false,
    Confirm = false,
}

-- Server/Commands/Utility.luau
myCmd = function(ctx, args)
    -- args.target is one player, args.amount is a clamped number
end,

The code runs once per resolved target, with args.target already narrowed to a single player. Nothing needs registering: the lookup tables are rebuilt on every load.

Where to start