PowerfulWhitelist 1.0.0

PowerfulWhitelist is a whitelist for Rust. It works on its own through chat andconsole commands with login enforcement, and if you also run PowerfulAdmin itadds an in-game management panel.

>>> No dependencies required. Install PowerfulAdmin only if you want the UI.

• Works on its own. Commands, enforcement and storage run with no other plugin installed. PowerfulAdmin is optional and only adds the in-game panel.
• Three storage backends. Keep the list in a JSON file, a local SQLite database, or MySQL/MariaDB to share it across several servers.
• Instant rejection at the connect screen. Players who are not whitelisted are rejected during login (`CanUserLogin`), so they never spawn in. The list is held in memory, so the check is instant and there is no "join then kick" flash.
• Shared list across servers. Point every server at the same MySQL database and additions and removals show up on all of them.
• Two independent on/off switches. Right on the Whitelist page: a This server switch (local) and an In database switch (shared across every server on the same database). The whitelist enforces if either one is on.
• Auto-reconnect. If the database is briefly unreachable at boot, the plugin keeps retrying and starts enforcing as soon as it connects.
• In-game panel. Search, add and remove from a UI that follows your PowerfulAdmin theme (requires PowerfulAdmin).
• Admin options. Server owners and moderators can be let through automatically, there is a bypass permission, and you can optionally kick non-listed players the moment the whitelist starts enforcing.

A dedicated Whitelist section in the Tools category:

• A status banner with two switches, This server (local on/off) and In database (shared on/off, shown when a database backend is used), plus an Enforce button to kick everyone not on the list. The whitelist is active if either switch is on.
• The whitelist with search (by name or SteamID) and pagination.
• Each entry shows the player avatar, name, SteamID, who added it and when.
• One-click Remove with a confirmation step.
• An + Add dialog with:

             1. a SteamID input with live validation (green when valid, red when not);
             2. a searchable, paged player picker that shows online status and hides players who are already whitelisted;
             3. an avatar and name preview before you confirm.

• A whitelist status row in the player popup card (Listed / Allowed / Not listed).
• Colors, fonts and switches follow your active theme.

Every action is written to PowerfulAdmin's Logs.

• JSON (default): a plain data file, nothing to configure. Good for a single server.
• SQLite: a local database file, created automatically.
• MySQL / MariaDB: share one whitelist across many servers.

Switch backends and migrate your data from the Settings page (your current list is

copied into the new backend), or check your MySQL connection first with the

built-in Test connection button.

With MySQL, each server refreshes the list on a short interval, so an addition or removal made on one server shows up on the others. The Whitelist page has two separate switches: This server (local, per-server) and In database (shared). Flip the database switch on one server and the whole network starts enforcing. The whitelist is active whenever either switch is on.

/whitelist add <name|steamid>      - add a player

/whitelist remove <name|steamid>   - remove a player

/whitelist list [page]             - list whitelisted players

/whitelist on | off                - enable / disable the whitelist (this server)

/whitelist enforce                 - kick everyone not on the list

/whitelist status                  - show state and count

/whitelist help                    - show all commands

>>> /wl ...                            - short alias for /whitelist

pwl add <name|steamid>

pwl remove <name|steamid>

pwl list [page]

pwl on | pwl off

pwl enforce

pwl status

pwl help

powerfulwhitelist.view - Open the Whitelist section and read the list

powerfulwhitelist.manage - Add, remove, toggle on/off and enforce

powerfulwhitelist.bypass - Always allowed to connect, even when not listed

A default config is generated on first load (PowerfulWhitelist.json

{
  "Enabled": false,
  "AllowAdmins": true,
  "KickOnEnable": true,
  "ServerName": "",
  "InfoUrl": "",
  "Storage": "Json",
  "SyncInterval": 60,
  "MySql": {
    "Host": "127.0.0.1",
    "Port": 3306,
    "Database": "powerfulwhitelist",
    "User": "root",
    "Password": ""
  }
}

The shared database on/off state (the In database switch on the panel) is

stored in the database, not in this config.

Storage, MySQL credentials and these options can also be changed live from the

Settings page when PowerfulAdmin is installed.

1. Drop PowerfulWhitelist.cs into your plugins folder (Carbon: carbon/plugins/, Oxide: oxide/plugins/).
2. The plugin loads and uses a JSON data file by default. No setup is required to start whitelisting.
3. Grant the permissions above to your staff groups.
4. Add yourself and your players (/whitelist add <name|steamid>), then turn it on (/whitelist on).
5. (Optional) For a shared/network whitelist, open the config (or the Settings page), set Storage to MySql, fill in your credentials, and apply.
6. (Optional) Install PowerfulAdmin to get the in-game whitelist panel.

• For MySQL storage: MySQL 8.0+ or MariaDB 10.2+ (recommended).
• PowerfulAdmin is optional, needed only for the in-game panel.

English and Russian are included out of the box. Every message lives in the language files, so you can translate or reword anything for your community.