Skip to content

Latest commit

 

History

History
155 lines (127 loc) · 6.94 KB

File metadata and controls

155 lines (127 loc) · 6.94 KB
title Basic Admin Remade Quickstart: Up and Running in Minutes
sidebarTitle Quickstart
description Configure your first admin list, set your prefix, and run your first commands with Basic Admin Remade. From install to working admin in minutes.

Once BAR is installed in ServerScriptService, all you need to do is open main_script, fill in a few fields in the Configuration table, and hit Play. This quickstart walks through the minimum configuration needed to have a fully working admin setup — from adding your first Super Admin to typing your first command in chat.

The Configuration Table

The entire BAR configuration lives in the Configuration table at the top of main_script. Here is the full table with all key fields you will want to review:

local Configuration = {
    ['Loader ID'] = 9450667008,

    ['Super Admins'] = {
        -- Add Roblox User IDs here (level 3 access)
    },

    ['Admins'] = {
        -- Add Roblox User IDs here (level 2 access)
    },

    ['Mods'] = {
        -- Add Roblox User IDs here (level 1 access)
    },

    ['Banned'] = {
        -- Add Roblox User IDs here to ban on load
    },

    ['Group Configuration'] = {
        {
            ['Group ID'] = 0,
            ['Group Rank'] = 0,
            ['Tolerance Type'] = '>=',
            ['Admin Level'] = 0,
        },
    },

    ['Command Configuration'] = {
        ['fly'] = {
            ['Permission'] = 1,
        },
        ['unfly'] = {
            ['Permission'] = 1,
        },
    },

    ['Prefix'] = (':'),              -- The prefix to the admin, i.e :cmds or :sm hi
    ['Kick Reason'] = ('You have been kicked from the server.'),
    ['Ban Reason'] = ('You have been banned from the game.'),
    ['Shutdown Reason'] = ('This server is shutting down..\nTry joining a different server!'),
    ['Server Message'] = ('BAR Server Message'),
    ['Server Lock Reason'] = ('The server is locked.'),
    ['Trello'] = false,              -- Use trello? HttpService must be enabled.
    ['Trello Board'] = (''),
    ['Trello App Key'] = (''),
    ['Trello Token'] = (''),
    ['Creator Debugging'] = true,
    ['Donor Perks'] = true,
    ['Public Commands'] = false,     -- Will people that are not admin be able to say :cmds, or !clean?
    ['Auto Clean'] = true,
    ['System Color'] = Color3.new(0, 0, 0),
    ['Tools Location'] = game.ServerStorage,
    ['Command Confirmation'] = true, -- Validates certain commands like :Ban all, or :PBan all.
    ['Datastore Key'] = ('BAR')      -- What cape data, ban data, etc. is stored under. Changing will wipe it.
}
In the **Explorer** panel, expand **ServerScriptService → BasicAdminRemade** (or whatever the model is named) and double-click **main\_script** to open it in the Script Editor.
You will see the `Configuration` table near the top of the file, just below the header comment block.
Find the `['Super Admins']` table and add your Roblox User ID as a key with your username as the value. User IDs are numbers — you can find yours at `roblox.com/users//profile` or by searching your profile URL.
```lua
['Super Admins'] = {
    [123456789] = 'YourUsername',
},
```

You can add multiple users the same way:

```lua
['Super Admins'] = {
    [123456789] = 'YourUsername',
    [987654321] = 'FriendUsername',
},
```

<Note>
  As the game creator, you are **automatically** given Game Creator rank (level 4) when you join your own game. You do not need to add yourself to any table — your `game.CreatorId` is detected automatically by BAR.
</Note>
The default prefix is **`:`** — so commands are typed as `:cmds`, `:kick PlayerName`, etc. If you want a different prefix (for example `!` or `/`), update the `['Prefix']` field:
```lua
['Prefix'] = ('!'),  -- Commands become !cmds, !kick, etc.
```

The prefix must be exactly **one character**. If a multi-character string is provided, BAR ignores it and falls back to the default `':'`.
Save your changes (`Ctrl+S`), then click **Play** in Roblox Studio to start a local test session. BAR loads on the server and sets up all commands, permissions, and UI automatically.
If `Creator Debugging` is `true` (the default), any Game Creator-rank admin who joins will receive a hint notification if the installed version is out of date.
In the in-game chat, type **`:cmds`** (or your custom prefix + `cmds`) and press Enter. The BAR commands panel will open and show every command you have access to at your current rank.
From here you can click any command in the panel to auto-fill it, or type commands directly in chat.

Your First Commands

Once you are in-game with admin, try these common commands to get familiar with BAR:

Command Description
:cmds Open the full command list for your rank
:admins View all configured admins and their rank levels
:kick <player> Kick a player from the server
:ban <player> Temporarily ban a player for this server session
:m <message> Display a message popup to all players with your name as the title
:sm <message> Display a server message to all players
:h <message> Send a hint notification to all players
:fly <player> Give a player the ability to fly (CTRL to go down, Space to move up)
:tp <player1> <player2> Teleport player1 to player2
:pban <player> Permanently ban a player (persists across server restarts via DataStore)
**Command Confirmation** is enabled by default (`['Command Confirmation'] = true`). When you run a broad destructive command — like `:ban all` or `:pban all` — BAR will show you a confirmation dialog listing the affected players before executing. You must confirm before the command runs. This prevents accidental mass actions. You can disable this behavior by setting `['Command Confirmation'] = false` in the Configuration table. BAR supports **display name targeting** out of the box. With `DisplayNameSupportEnabled = true` in `ExtraSettings.lua` (the default), you can target players using either their Roblox username or their display name when running commands like `:kick`, `:ban`, `:tp`, and others. This makes commands much more intuitive when display names differ from usernames.

Next Steps

Explore every field in the Configuration table and ExtraSettings in detail. Browse the full list of 50+ commands, their syntax, and required permission levels.