[{"data":1,"prerenderedAt":30},["ShallowReactive",2],{"doc-fr-moderer-serveur-beammp":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_en":28,"bodyHtml":29},"\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fmoderer-serveur-beammp","moderer-serveur-beammp","Comment modérer son serveur BeamMP (kick, ban, whitelist) ?","Expulsez un joueur depuis la console, puis bannissez ou réservez votre serveur BeamMP à une whitelist grâce à un petit plugin Lua, chez Winheberg.","jeux","beammp","tabler:shield-check","2026-11-01","Winheberg",103,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fmoderer-serveur-beammp.webp",[9,16,17,18,19],"modération","kick","ban","whitelist",[21,22,23,24,25,26],"modérer serveur beammp","kick beammp","ban beammp","whitelist beammp","commandes console beammp","bannir joueur beammp","","\u002Fen\u002Fdocs\u002Fbeammp\u002Fmoderate-beammp-server","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Un joueur perturbe les parties sur votre \u003Cstrong>serveur BeamMP\u003C\u002Fstrong> chez Winheberg, ou vous voulez réserver le serveur à votre communauté ? BeamMP fournit quelques commandes de modération dans la console, comme l&#39;expulsion d&#39;un joueur, mais \u003Cstrong>aucune commande de bannissement ni de whitelist\u003C\u002Fstrong>. Pour cela, il faut un plugin Lua côté serveur.\u003C\u002Fp>\n\u003Cp>Ce guide vous montre les commandes utiles de la console, puis comment mettre en place un \u003Cstrong>bannissement\u003C\u002Fstrong> et une \u003Cstrong>whitelist\u003C\u002Fstrong> avec un petit plugin prêt à l&#39;emploi.\u003C\u002Fp>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cp>Avant de commencer, assurez-vous d&#39;avoir les éléments suivants.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Un \u003Cstrong>serveur BeamMP\u003C\u002Fstrong> actif sur votre panel gaming Winheberg\u003C\u002Fli>\n\u003Cli>Le serveur \u003Cstrong>démarré\u003C\u002Fstrong>, pour pouvoir utiliser la console\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Les commandes de modération de la console\u003C\u002Fh2>\n\u003Cp>Ouvrez la page principale de votre serveur dans le panel. Les commandes se tapent dans le champ \u003Cstrong>Type a command...\u003C\u002Fstrong> sous la console, \u003Cstrong>sans \u003Ccode>\u002F\u003C\u002Fcode> devant\u003C\u002Fstrong>, puis se valident avec la touche Entrée. La commande \u003Ccode>help\u003C\u002Fcode> affiche la liste complète.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Commande\u003C\u002Fth>\n\u003Cth>Rôle\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>list\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Affiche les joueurs connectés et leurs informations\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>status\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Affiche le nombre de joueurs, d&#39;invités et de voitures sur le serveur\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>kick &lt;nom&gt; [raison]\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Expulse le joueur indiqué, avec une raison facultative\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>say &lt;message&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Envoie un message à tous les joueurs dans le chat\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>help\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Affiche toutes les commandes disponibles\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fmoderer-serveur-beammp-1793534407670-5de1045cd7a645b546c9e0c4.webp\" alt=\"Résultat des commandes list et status dans la console BeamMP\" width=\"380\" \u002F>\n\n\u003Cp>Par exemple, pour expulser un joueur en lui donnant la raison.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">kick Troublemaker Merci de respecter les autres joueurs\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>Un joueur expulsé avec \u003Ccode>kick\u003C\u002Fcode> \u003Cstrong>peut se reconnecter\u003C\u002Fstrong> immédiatement. Pour l&#39;empêcher de revenir, il faut le bannir avec le plugin de l&#39;étape suivante.\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>La commande \u003Ccode>exit\u003C\u002Fcode> \u003Cstrong>arrête le serveur\u003C\u002Fstrong>. Pour redémarrer ou arrêter votre serveur, utilisez plutôt les boutons \u003Cstrong>Restart\u003C\u002Fstrong> et \u003Cstrong>Stop\u003C\u002Fstrong> du panel.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Installer le plugin de bannissement et de whitelist\u003C\u002Fh2>\n\u003Cp>Le plugin ci-dessous vérifie chaque joueur au moment de sa connexion. S&#39;il est banni, ou si la whitelist est activée et qu&#39;il n&#39;y figure pas, sa connexion est refusée avec un message.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Dans le menu latéral, cliquez sur \u003Cstrong>Files\u003C\u002Fstrong> et ouvrez le dossier \u003Cstrong>\u003Ccode>Resources\u003C\u002Fcode>\u003C\u002Fstrong>, puis \u003Cstrong>\u003Ccode>Server\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Cliquez sur \u003Cstrong>Create Directory\u003C\u002Fstrong> et nommez le dossier \u003Ccode>AccessControl\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Ouvrez ce dossier, cliquez sur \u003Cstrong>New file\u003C\u002Fstrong>, collez le code suivant et enregistrez-le sous le nom \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>Redémarrez le serveur avec \u003Cstrong>Restart\u003C\u002Fstrong> et vérifiez que la console affiche \u003Ccode>[LUA] AccessControl plugin loaded\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Pour le détail du fonctionnement des plugins, consultez notre guide \u003Cstrong>« Comment installer un plugin Lua sur son serveur BeamMP ? »\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>3. Bannir un joueur\u003C\u002Fh2>\n\u003Cp>Ouvrez le fichier \u003Ccode>Resources\u002FServer\u002FAccessControl\u002Fmain.lua\u003C\u002Fcode> et ajoutez une ligne dans le bloc \u003Ccode>banned\u003C\u002Fcode>, avec le \u003Cstrong>nom exact du joueur\u003C\u002Fstrong> et le message qu&#39;il verra en essayant de se connecter.\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>Enregistrez le fichier. Vous n&#39;avez \u003Cstrong>pas besoin de redémarrer\u003C\u002Fstrong> le serveur, BeamMP détecte la modification et recharge le plugin automatiquement.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fmoderer-serveur-beammp-1793534408209-fe025e9950f10a8b2b64a1b3.webp\" alt=\"Rechargement automatique du plugin AccessControl après modification\" width=\"540\" \u002F>\n\n\u003Cp>Pour lever un bannissement, supprimez simplement la ligne du joueur et enregistrez.\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>Pour connaître le nom exact d&#39;un joueur avant de le bannir, tapez \u003Ccode>list\u003C\u002Fcode> dans la console pendant qu&#39;il est connecté. Le nom est \u003Cstrong>sensible à la casse\u003C\u002Fstrong>, \u003Ccode>Griefer42\u003C\u002Fcode> et \u003Ccode>griefer42\u003C\u002Fcode> sont deux joueurs différents pour le plugin.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Activer la whitelist\u003C\u002Fh2>\n\u003Cp>Pour réserver votre serveur à une liste de joueurs, modifiez le début du fichier.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Passez \u003Ccode>whitelist_enabled\u003C\u002Fcode> à \u003Ccode>true\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Ajoutez une ligne par joueur autorisé dans le bloc \u003Ccode>whitelist\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Enregistrez le fichier\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>Les joueurs absents de la liste voient le message \u003Ccode>This server is whitelisted\u003C\u002Fcode> et ne peuvent pas se connecter.\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>Le plugin identifie les joueurs par leur \u003Cstrong>nom\u003C\u002Fstrong>. Pour éviter qu&#39;un joueur connecté en invité, sans compte BeamMP, ne se fasse passer pour un autre, passez la ligne \u003Ccode>AllowGuests\u003C\u002Fcode> à \u003Ccode>false\u003C\u002Fcode> dans \u003Ccode>ServerConfig.toml\u003C\u002Fcode>. Ce réglage est expliqué dans notre guide \u003Cstrong>« Comment configurer son serveur BeamMP (nom, joueurs, tags) ? »\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Cp>Voici les situations les plus fréquentes avec la modération.\u003C\u002Fp>\n\u003Ch3>❌ Le joueur banni peut toujours se connecter\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Vérifiez que son nom est écrit \u003Cstrong>exactement\u003C\u002Fstrong> comme dans la commande \u003Ccode>list\u003C\u002Fcode>, majuscules comprises\u003C\u002Fli>\n\u003Cli>Vérifiez que la console a bien affiché \u003Ccode>changed, reloading\u003C\u002Fcode> puis \u003Ccode>AccessControl plugin loaded\u003C\u002Fcode> après votre modification\u003C\u002Fli>\n\u003Cli>Vérifiez que chaque ligne du bloc \u003Ccode>banned\u003C\u002Fcode> se termine par une virgule\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ La console affiche LUA ERROR après ma modification\u003C\u002Fh3>\n\u003Cp>Une erreur de syntaxe s&#39;est glissée dans le fichier, le plus souvent une virgule, un guillemet ou une accolade manquante. Le message indique le numéro de ligne à corriger. Tant que l&#39;erreur est présente, \u003Cstrong>le plugin ne protège plus le serveur\u003C\u002Fstrong>, corrigez-la rapidement.\u003C\u002Fp>\n\u003Ch3>❌ La commande kick ne trouve pas le joueur\u003C\u002Fh3>\n\u003Cp>Tapez \u003Ccode>list\u003C\u002Fcode> pour afficher les joueurs connectés et recopiez son nom exact. Si le nom contient des espaces, la commande peut ne pas l&#39;interpréter correctement, préférez alors le bannissement par le plugin.\u003C\u002Fp>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Gardez une copie\u003C\u002Fstrong> du fichier \u003Ccode>main.lua\u003C\u002Fcode> du plugin, il contient votre liste de bannis et votre whitelist\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Notez la raison\u003C\u002Fstrong> de chaque bannissement dans le message, vous vous en souviendrez plus tard et le joueur saura pourquoi\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Lisez la console après chaque modification\u003C\u002Fstrong> du plugin pour confirmer qu&#39;il s&#39;est bien rechargé\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Combinez la whitelist avec le mode privé\u003C\u002Fstrong> si vous ne voulez pas apparaître dans la liste publique, consultez notre guide \u003Cstrong>« Comment passer son serveur BeamMP en privé ? »\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Des plugins plus complets existent aussi dans la communauté BeamMP, avec des permissions et des bannissements temporaires. Vérifiez leur compatibilité avec votre version du serveur avant de les installer, et n&#39;utilisez qu&#39;un seul système de bannissement à la fois.\u003C\u002Fp>\n\u003Ch2>Besoin d&#39;aide ?\u003C\u002Fh2>\n\u003Cp>Si le plugin ne se charge pas ou ne bloque pas un joueur malgré ces vérifications, notre équipe est là. Ouvrez un ticket dans le département \u003Cstrong>Technique\u003C\u002Fstrong> depuis votre espace client, renseignez le champ \u003Cstrong>Produit lié\u003C\u002Fstrong> avec le serveur concerné et joignez les logs de la console.\u003C\u002Fp>\n\u003Cp>Votre serveur BeamMP est maintenant entre de bonnes mains, bonne route 🛣️\u003C\u002Fp>\n",1794526345613]