BRB Admin | VORP Core UI Panel

Introduction

Welcome to BRB Admin, a modern, feature-rich, and highly intuitive admin panel designed from the ground up for RedM servers running the VORP Core framework. This project was developed to replace traditional, command-based administration with a clean, user-friendly graphical interface, making server management faster, easier, and more efficient.

BRB Admin centralizes all the tools a server owner needs, from comprehensive player management to detailed server controls, all wrapped in a stylish and responsive UI. It is designed to be both powerful for experienced administrators and easy to learn for new staff members.

Features

BRB Admin is packed with features that cover every aspect of server management.

Dashboard

The main landing page provides a quick overview and access to essential tools.

Live Player Count: See how many players are currently on the server.
Quick Actions: Instantly toggle the most frequently used admin powers. The buttons change color to indicate their current status (On/Off).
- Noclip: Move freely through the world, ignoring physics and collisions.
- God Mode: Become invincible to all forms of damage.
- Invisibility: Become invisible to other players.
- Revive Self: Instantly bring yourself back to life if you are dead.

Player Management

A powerful and dynamic list of all online players, with a clean dropdown menu for every conceivable action.

Live Player List: View all online players with their Server ID and Character Name. Includes a refresh button.
Dropdown Action Menu:
- Teleport: Go To a player or Bring a player to you.
- Spectate: Watch the target player from their first-person point of view.
- Vitals: Revive a dead player or Heal a player (restores health, hunger, and thirst to 100%).
- Inventory Management:
  - View Inventory: See a list of all items in the player's inventory.
  - Give Item: Give a specific quantity of any item.
  - Give Weapon: Give any weapon by its model name.
  - Give Money/Gold: Add cash or gold to the player's balance.
  - Clear Inventory: A confirmation-protected action to wipe all items from a player's inventory.
- Advanced Management:
  - Set Job: Change a player's job and grade.
  - Set Group: Change a player's permission group (e.g., user, mod, admin).
- Troll Actions: Kill, Set on Fire, Ragdoll, and Lightning Strike the player.
- Administrative: Kick or Ban a player using stylish modals to input the reason and duration.

Server Management

Control server-wide settings on the fly.

Make Announcement: Send a custom announcement that appears on every player's screen.
Change Weather: Instantly set the weather to Sunny, Clouds, Rain, Storm, or Fog for the entire server.
Kick All Players: Kicks every player from the server except for yourself (with a confirmation dialog).

Developer Tools

Essential tools for server development, mapping, and debugging.

Live Coordinate Tracker: See your real-time vector coordinates and heading.
Copy Coordinates: Copy your current location to your clipboard with a single click.
Teleport to Coordinates: Paste coordinates into an input field and teleport instantly and safely (waits for collision to load).
Delete Object: Find the model name of the nearest non-static object and delete it from the world.

Offline Management

Manage your community even when players are not online.

Offline Ban/Unban: Ban or unban a player using their database Static ID.
Offline Whitelist: Add or remove a player from the whitelist using their Steam Hex ID.

Core Systems

Multi-Language Support: The entire UI can be switched between Turkish and English with buttons in the "Language" tab. The system is built to easily support adding more languages.
Advanced Permission System: The config.lua file allows for incredibly detailed permission control. You can define ranks like staff, mod, and admin and enable/disable every single button and tab for each rank. Buttons and tabs that a user does not have permission for are automatically hidden from their UI.
Custom Notification System: All actions provide feedback through a custom, theme-consistent notification system that appears in the top-right corner of the screen, completely replacing the default VORP notifications.

Dependencies

For BRB Admin to function correctly, your server must have the following resources installed and running:

VORP Core
vorp_inventory
vorp_character
[vorpbans] (or a similar banning script that uses the same events)

Installation

Download the brb_admin resource.
Place the brb_admin folder into your server's resources directory.
Open your server.cfg file and add the following line:
Kod snippet'i
```
ensure brb_admin
```
CRITICAL: Before starting, open config.lua and configure the permission groups (staff, mod, admin) to match the groups used on your server.
Start your server, or if it's already running, use the commands refresh followed by ensure brb_admin in your server console.
In-game, use the /admin command to open the panel.

Setting Up Admins

For the admin panel to work, you must grant administrative privileges to the correct players. There are two primary methods for granting permissions in a VORP server. Method 1 is required for the BRB Admin panel to function correctly. Method 2 is for general server command permissions.

Method 1: Database (Required for UI Permissions)

This method assigns a player to a specific group (admin, mod, staff) within the VORP database. The BRB Admin panel reads this group to determine which buttons and tabs a user can see and use, based on your config.lua settings.

Instructions:

Identify the Player: You need the player's unique identifier, which is typically their Steam Hex ID (e.g., steam:11000010a1b2c3d). You can find this in your server's users table in the database.
Open Your Database: Use a tool like HeidiSQL or phpMyAdmin to access your server's database.
Navigate to the characters Table: This table stores all the characters created on your server.
Find the Player's Character: Locate the row corresponding to the character you want to make an admin. You can find it using their identifier (from the users table) or by their firstname and lastname.
Update the group Column: Find the column named group. Change its value from user to admin (or mod, staff, depending on the rank you want to assign).

Example SQL Query:

Alternatively, you can run the following SQL query to update the character directly. Replace the name with your target player's character name.

SQL

UPDATE `characters` SET `group` = 'admin' WHERE `firstname` = 'John' AND `lastname` = 'Doe';

After changing this value in the database, the player will have the assigned permissions the next time they log in or their character is loaded.

Method 2: server.cfg (For Built-in Server Permissions)

This method uses the server's Access Control List (ACE) to grant permissions for built-in server commands (like ensure, stop, say) and access to things like TxAdmin. This is separate from the UI but is usually given to the same trusted administrators.

Instructions:

Open server.cfg: Open your main server configuration file.

Add Principals: Add the following lines to your server.cfg. Make sure to replace steam:11000010a1b2c3d with the Steam Hex ID of the admin.

Kod snippet'i

# =================================================================
# BRB ADMIN - ADMIN PERMISSIONS
# =================================================================

# Add your main admins to the "group.admin" ACE group.
# Replace the steam hex with your admin's Steam Hex ID.
add_principal identifier.steam:11000010a1b2c3d group.admin

# You can add more admins like this:
# add_principal identifier.steam: ANOTHER_HEX_ID group.admin

# This gives the admin group full access to all built-in server commands.
add_ace group.admin command allow
add_ace group.admin TxAdmin allow

# =================================================================

Restart Your Server: Changes to server.cfg require a full server restart to take effect.

Summary:

Database (characters table): Controls who can use the features inside the BRB Admin Panel.
server.cfg (ACE Permissions): Controls who can use powerful server commands in the console or chat.

For a player to be a full administrator, it is recommended to apply both methods.

Configuration (`config.lua`)

The config.lua file is the heart of the panel's customization.

Language

Lua

-- "tr" for Turkish, "en" for English.
Config.Lang = "tr"

Noclip Settings

Lua

-- The key to toggle Noclip (Default: F5)
Config.NoclipKey = 0xD8549539

-- The control hashes for movement while in Noclip
Config.Controls = {
    goUp        = 0xF84FA74F,  -- Q
    goDown      = 0x07CE1E61,  -- Z
    -- ... and so on
}

Permission System

This is where you define who can do what. You can add, remove, or modify groups. For each action, set it to true to allow it or false (or simply omit the line) to deny it.

Lua

Config.AllowedActions = {
    ['admin'] = {
        actions = {
            all = true -- Grants the 'admin' group access to everything.
        }
    },
    ['mod'] = {
        actions = {
            -- Tab Permissions
            tab_players = true,
            tab_server = true,
            tab_spawn = true,
            tab_developer = false, -- Mods cannot see the Developer tab

            -- Player Actions
            player_kick = true,
            player_ban = false, -- Mods cannot ban
            
            -- ... and so on for every feature
        }
    },
    ['staff'] = {
        actions = {
            tab_players = true,
            player_kick = true,
            player_spectate = true,
            player_goto = true,
            player_bring = true
            -- Any permission not listed here will be denied for staff.
        }
    }
}

PreviousBRB Wanted Poster System - Installation Guide

Last updated 1 month ago