[{"data":1,"prerenderedAt":30},["ShallowReactive",2],{"doc-en-moderate-beammp-server":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":20,"docGroup":27,"docGroupIcon":27,"link_fr":28,"bodyHtml":29},"\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fmoderate-beammp-server","moderate-beammp-server","How to Moderate Your BeamMP Server (Kick, Ban, Whitelist)","Kick a player from the console, then ban players or restrict your BeamMP server to a whitelist with a small Lua plugin, at Winheberg.","jeux","beammp","tabler:shield-check","2026-11-01","Winheberg",103,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fmoderate-beammp-server.webp",[9,16,17,18,19],"moderation","kick","ban","whitelist",[21,22,23,24,25,26],"moderate beammp server","beammp kick","beammp ban","beammp whitelist","beammp console commands","ban player beammp","","\u002Fdocs\u002Fbeammp\u002Fmoderer-serveur-beammp","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>A player is disrupting games on your \u003Cstrong>BeamMP server\u003C\u002Fstrong> at Winheberg, or you want to keep the server for your community only? BeamMP provides a few moderation commands in the console, such as kicking a player, but \u003Cstrong>no ban or whitelist command\u003C\u002Fstrong>. For that, you need a server-side Lua plugin.\u003C\u002Fp>\n\u003Cp>This guide shows you the useful console commands, then how to set up a \u003Cstrong>ban list\u003C\u002Fstrong> and a \u003Cstrong>whitelist\u003C\u002Fstrong> with a small ready-to-use plugin.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cp>Before you start, make sure you have the following.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>An active \u003Cstrong>BeamMP server\u003C\u002Fstrong> on your Winheberg gaming panel\u003C\u002Fli>\n\u003Cli>The server \u003Cstrong>running\u003C\u002Fstrong>, so you can use the console\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Console moderation commands\u003C\u002Fh2>\n\u003Cp>Open your server&#39;s main page in the panel. Commands are typed in the \u003Cstrong>Type a command...\u003C\u002Fstrong> field under the console, \u003Cstrong>without a \u003Ccode>\u002F\u003C\u002Fcode> in front\u003C\u002Fstrong>, then sent with the Enter key. The \u003Ccode>help\u003C\u002Fcode> command shows the full list.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>list\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Shows the connected players and their information\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Shows the number of players, guests and cars on the server\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kick &lt;name&gt; [reason]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Kicks the given player, with an optional reason\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>say &lt;message&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sends a message to all players in the chat\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>help\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Shows every available command\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fmoderate-beammp-server-1793534407670-5de1045cd7a645b546c9e0c4.webp\" alt=\"Output of the list and status commands in the BeamMP console\" width=\"380\" \u002F>\n\n\u003Cp>For example, to kick a player and tell them why.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">kick Troublemaker Please respect the other players\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>A player kicked with \u003Ccode>kick\u003C\u002Fcode> \u003Cstrong>can reconnect\u003C\u002Fstrong> right away. To keep them out, ban them with the plugin from the next step.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The \u003Ccode>exit\u003C\u002Fcode> command \u003Cstrong>shuts the server down\u003C\u002Fstrong>. To restart or stop your server, use the panel&#39;s \u003Cstrong>Restart\u003C\u002Fstrong> and \u003Cstrong>Stop\u003C\u002Fstrong> buttons instead.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Install the ban and whitelist plugin\u003C\u002Fh2>\n\u003Cp>The plugin below checks every player when they connect. If they are banned, or if the whitelist is on and they are not on it, their connection is refused with a message.\u003C\u002Fp>\n\u003Col>\n\u003Cli>In the side menu, click \u003Cstrong>Files\u003C\u002Fstrong> and open the \u003Cstrong>\u003Ccode>Resources\u003C\u002Fcode>\u003C\u002Fstrong> folder, then \u003Cstrong>\u003Ccode>Server\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Create Directory\u003C\u002Fstrong> and name the folder \u003Ccode>AccessControl\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Open that folder, click \u003Cstrong>New file\u003C\u002Fstrong>, paste the following code and save it as \u003Ccode>main.lua\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cpre>\u003Ccode class=\"language-lua\">-- AccessControl: ban list and whitelist checked when a player connects\n\n-- Set to true to only let whitelisted players in\nlocal whitelist_enabled = false\n\nlocal whitelist = {\n    [&quot;PlayerOne&quot;] = true,\n    [&quot;PlayerTwo&quot;] = true,\n}\n\nlocal banned = {\n    [&quot;Troublemaker&quot;] = &quot;You are banned from this server&quot;,\n}\n\nfunction onPlayerAuth(player_name, player_role, is_guest, identifiers)\n    if banned[player_name] then\n        return banned[player_name]\n    end\n    if whitelist_enabled and not whitelist[player_name] then\n        return &quot;This server is whitelisted&quot;\n    end\nend\n\nfunction onInit()\n    print(&quot;AccessControl plugin loaded&quot;)\nend\n\nMP.RegisterEvent(&quot;onPlayerAuth&quot;, &quot;onPlayerAuth&quot;)\nMP.RegisterEvent(&quot;onInit&quot;, &quot;onInit&quot;)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Col start=\"4\">\n\u003Cli>Restart the server with \u003Cstrong>Restart\u003C\u002Fstrong> and check that the console shows \u003Ccode>[LUA] AccessControl plugin loaded\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>For details on how plugins work, see our guide \u003Cstrong>&quot;How to Install a Lua Plugin on Your BeamMP Server&quot;\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>3. Ban a player\u003C\u002Fh2>\n\u003Cp>Open the \u003Ccode>Resources\u002FServer\u002FAccessControl\u002Fmain.lua\u003C\u002Fcode> file and add a line to the \u003Ccode>banned\u003C\u002Fcode> block, with the \u003Cstrong>exact player name\u003C\u002Fstrong> and the message they will see when trying to connect.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-lua\">local banned = {\n    [&quot;Troublemaker&quot;] = &quot;You are banned from this server&quot;,\n    [&quot;Griefer42&quot;] = &quot;Banned for griefing&quot;,\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Save the file. You \u003Cstrong>do not need to restart\u003C\u002Fstrong> the server, BeamMP detects the change and reloads the plugin automatically.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fbeammp\u002Fmoderate-beammp-server-1793534408209-fe025e9950f10a8b2b64a1b3.webp\" alt=\"AccessControl plugin reloading automatically after an edit\" width=\"540\" \u002F>\n\n\u003Cp>To lift a ban, simply delete the player&#39;s line and save.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>To get a player&#39;s exact name before banning them, type \u003Ccode>list\u003C\u002Fcode> in the console while they are connected. The name is \u003Cstrong>case sensitive\u003C\u002Fstrong>, \u003Ccode>Griefer42\u003C\u002Fcode> and \u003Ccode>griefer42\u003C\u002Fcode> are two different players for the plugin.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Turn on the whitelist\u003C\u002Fh2>\n\u003Cp>To keep your server for a list of players, edit the top of the file.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Set \u003Ccode>whitelist_enabled\u003C\u002Fcode> to \u003Ccode>true\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Add one line per allowed player in the \u003Ccode>whitelist\u003C\u002Fcode> block\u003C\u002Fli>\n\u003Cli>Save the file\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cpre>\u003Ccode class=\"language-lua\">local whitelist_enabled = true\n\nlocal whitelist = {\n    [&quot;PlayerOne&quot;] = true,\n    [&quot;PlayerTwo&quot;] = true,\n    [&quot;PlayerThree&quot;] = true,\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Players who are not on the list see the \u003Ccode>This server is whitelisted\u003C\u002Fcode> message and cannot connect.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The plugin identifies players by their \u003Cstrong>name\u003C\u002Fstrong>. To stop a player joining as a guest, without a BeamMP account, from posing as someone else, set the \u003Ccode>AllowGuests\u003C\u002Fcode> line to \u003Ccode>false\u003C\u002Fcode> in \u003Ccode>ServerConfig.toml\u003C\u002Fcode>. This setting is explained in our guide \u003Cstrong>&quot;How to Configure Your BeamMP Server (Name, Players, Tags)&quot;\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Cp>Here are the most common situations with moderation.\u003C\u002Fp>\n\u003Ch3>❌ The banned player can still connect\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that their name is written \u003Cstrong>exactly\u003C\u002Fstrong> as in the \u003Ccode>list\u003C\u002Fcode> command, capital letters included\u003C\u002Fli>\n\u003Cli>Check that the console showed \u003Ccode>changed, reloading\u003C\u002Fcode> then \u003Ccode>AccessControl plugin loaded\u003C\u002Fcode> after your edit\u003C\u002Fli>\n\u003Cli>Check that every line in the \u003Ccode>banned\u003C\u002Fcode> block ends with a comma\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The console shows LUA ERROR after my edit\u003C\u002Fh3>\n\u003Cp>A syntax error slipped into the file, most often a missing comma, quote or brace. The message gives the line number to fix. As long as the error is there, \u003Cstrong>the plugin no longer protects the server\u003C\u002Fstrong>, so fix it quickly.\u003C\u002Fp>\n\u003Ch3>❌ The kick command cannot find the player\u003C\u002Fh3>\n\u003Cp>Type \u003Ccode>list\u003C\u002Fcode> to show the connected players and copy their exact name. If the name contains spaces, the command may not read it correctly, in that case use the plugin ban instead.\u003C\u002Fp>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Keep a copy\u003C\u002Fstrong> of the plugin&#39;s \u003Ccode>main.lua\u003C\u002Fcode> file, it holds your ban list and whitelist\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Write the reason\u003C\u002Fstrong> for each ban in the message, you will remember it later and the player will know why\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Read the console after every plugin edit\u003C\u002Fstrong> to confirm it reloaded properly\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Combine the whitelist with private mode\u003C\u002Fstrong> if you do not want to appear on the public list, see our guide \u003Cstrong>&quot;How to Make Your BeamMP Server Private&quot;\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>More complete plugins also exist in the BeamMP community, with permissions and temporary bans. Check that they work with your server version before installing them, and only use one ban system at a time.\u003C\u002Fp>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If the plugin does not load or does not block a player despite these checks, our team is here to help. Open a ticket with the \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area, fill in the \u003Cstrong>Related Product\u003C\u002Fstrong> field with the server concerned and attach the console logs.\u003C\u002Fp>\n\u003Cp>Your BeamMP server is now in good hands, enjoy the ride 🛣️\u003C\u002Fp>\n",1794526351770]