Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Verveo/Basic-Admin-Remade/llms.txt

Use this file to discover all available pages before exploring further.

Moderation commands let admins manage player access and communicate with the server. These are the most commonly used commands in Basic Admin Remade, covering everything from removing a single disruptive player to locking down the entire server and broadcasting messages to all players.

Command Reference

CommandUsagePermissionDescription
kick:kick <User(s)> <Reason>1 — ModeratorKicks the specified user(s) with an optional reason.
ban:ban <User>2 — AdminBans the specified user from the server (session-only).
unban:unban <User>2 — AdminRemoves a session ban on the specified user.
pban:pban <Full User> / <User>2 — AdminPermanently bans the specified user using their username. Persists across servers via DataStore.
pbanid:pbanid <User ID>2 — AdminPermanently bans a user by their numeric Roblox User ID.
unpban:unpban <Full Username>2 — AdminRemoves a permanent ban by full username.
unpbanid:unpbanid <User ID>2 — AdminRemoves a permanent ban by Roblox User ID.
pbans:pbans1 — ModeratorOpens the permanent bans lookup panel where you can check if a user is banned by username or ID.
bans:bans1 — ModeratorDisplays all currently session-banned users.
trellobans:trellobans1 — ModeratorDisplays all bans sourced from the configured Trello ban list (requires Trello integration).
slock:slock1 — ModeratorLocks the server so only Moderators and above can join.
unslock:unslock1 — ModeratorUnlocks the server so anyone can join.
sm:sm <Text>2 — AdminDisplays a server-wide message with the title “Server Message” (configurable).
m:m <Text>1 — ModeratorDisplays a server-wide message with the caller’s name as the title.
h:h <Text>1 — ModeratorDisplays a hint notification to all players with the caller’s name as the title.
pm:pm <User(s)> <Text>1 — ModeratorSends a private message to the specified user(s) with a reply option.
globalm:globalm <Text>1 — ModeratorSends a message to all players across all servers using MessagingService.
shutdown:shutdown2 — AdminShuts the server down, kicking all players with the configured Shutdown Reason message.

Permanent Bans

BAR distinguishes between session bans (:ban) and permanent bans (:pban / :pbanid).
  • :ban adds the user to an in-memory banned table. The ban is cleared when the server shuts down — it only affects the current session.
  • :pban / :pbanid write ban data to Roblox DataStore, persisting across all servers and server restarts. On joining, BAR checks DataStore for the player’s User ID and kicks them if a permanent ban entry exists.
When UseLegacyBan = false is set in ExtraSettings, BAR also calls Roblox’s native Ban API (Players:BanAsync), which applies the ban at the platform level across all universes and alternate accounts (ExcludeAltAccounts = false behavior depends on your configuration).
-- ExtraSettings.lua
UseLegacyBan = false  -- Use Roblox's native Ban API in addition to DataStore
Permanent bans store the banned player’s name, the banning admin’s name, the ban date, and an optional reason. All of this is visible via :pbans.

Server Lock

:slock sets a server-locked flag that prevents players with permission level 0 (Public) from joining. Any player who attempts to join a locked server is immediately kicked with the Server Lock Reason message defined in main_script.lua:
['Server Lock Reason'] = 'The server is locked.',
Moderators, Admins, Super Admins, and the Game Creator can always join regardless of server lock status. Use :unslock to reopen the server to all players. The lock is session-scoped and resets when the server restarts (unless LockedOnStart = true is set in ExtraSettings).

Messaging Commands

BAR provides several ways to communicate with players:
  • :sm <Text> — Broadcasts a full-screen message with the title set to Server Message (or your configured value). The message text is filtered through Roblox’s chat filter for each recipient.
  • :m <Text> — Same as :sm but uses the sending admin’s display name as the title, making it clear who sent the message.
  • :h <Text> — Sends a hint-style notification (smaller, top-of-screen) with the admin’s name as the title.
  • :pm <User(s)> <Text> — Sends a private pop-up message to specific players. Recipients can reply directly through the BAR UI. BAR enforces Roblox’s chat privacy settings — if two players cannot communicate, the PM will not be sent.
  • :globalm <Text> — Uses Roblox’s MessagingService to broadcast a message across all servers of the place simultaneously.
:shutdown sends a full-screen message containing the configured Shutdown Reason to all players before kicking them. The reason can be customized in main_script.lua via ['Shutdown Reason']. Shutdown events are logged to the DataStore shutdown log, which is viewable with :shutdownlogs.

Build docs developers (and LLMs) love