[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-fr-plugin-lua-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":19,"docGroup":26,"docGroupIcon":26,"link_en":27,"bodyHtml":28},"\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp","plugin-lua-serveur-beammp","Comment installer un plugin Lua sur son serveur BeamMP ?","Installez un plugin Lua côté serveur sur votre serveur BeamMP chez Winheberg, dans Resources\u002FServer, et vérifiez son chargement dans la console.","jeux","beammp","tabler:code","2026-11-01","Winheberg",101,"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp.webp",[9,16,17,18],"plugin","lua","resources server",[20,21,22,23,24,25],"plugin beammp","plugin lua beammp","resources server beammp","script serveur beammp","lua error beammp","installer plugin beammp","","\u002Fen\u002Fdocs\u002Fbeammp\u002Fbeammp-server-lua-plugin","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>Vous voulez ajouter des fonctionnalités à votre \u003Cstrong>serveur BeamMP\u003C\u002Fstrong> chez Winheberg, comme un message de bienvenue, des commandes d&#39;administration ou un système de course ? Tout cela passe par des \u003Cstrong>plugins Lua côté serveur\u003C\u002Fstrong>, qui s&#39;exécutent sur votre serveur et non chez vos joueurs.\u003C\u002Fp>\n\u003Cp>Ce guide vous explique \u003Cstrong>où placer un plugin\u003C\u002Fstrong>, comment \u003Cstrong>vérifier qu&#39;il se charge\u003C\u002Fstrong> et comment réagir si la console affiche une erreur de ce type.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">[LUA ERROR] Failed: &quot;Resources\u002FServer\u002FMonPlugin\u002Fmain.lua&quot;: [string &quot;Resources\u002FServer\u002FMonPlugin\u002Fmain.lua&quot;]:3: &#39;)&#39; expected (to close &#39;(&#39; at line 2) near &#39;end&#39;\n\u003C\u002Fcode>\u003C\u002Fpre>\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 \u003Cstrong>plugin\u003C\u002Fstrong> que vous voulez installer, sous forme de fichiers \u003Ccode>.lua\u003C\u002Fcode> ou d&#39;une archive à décompresser sur votre ordinateur\u003C\u002Fli>\n\u003C\u002Ful>\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>Un plugin serveur exécute du code sur votre serveur. Téléchargez vos plugins \u003Cstrong>uniquement depuis des sources de confiance\u003C\u002Fstrong> (forum officiel BeamMP, dépôt GitHub d&#39;un créateur reconnu) et lisez le README fourni avec le plugin avant de l&#39;installer.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Plugin serveur ou mod client ?\u003C\u002Fh2>\n\u003Cp>BeamMP sépare deux types de ressources, chacune dans son propre dossier.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Dossier\u003C\u002Fth>\n\u003Cth>Contenu\u003C\u002Fth>\n\u003Cth>Exécuté par\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>Resources\u002FClient\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Mods \u003Ccode>.zip\u003C\u002Fcode> (voitures, maps)\u003C\u002Ftd>\n\u003Ctd>Le jeu de chaque joueur, qui les télécharge à la connexion\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>Resources\u002FServer\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Plugins Lua, un sous-dossier par plugin\u003C\u002Ftd>\n\u003Ctd>Votre serveur uniquement\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>Ce guide traite uniquement du dossier \u003Ccode>Resources\u002FServer\u003C\u002Fcode>. Pour les mods, consultez nos guides \u003Cstrong>« Comment ajouter des voitures moddées à son serveur BeamMP ? »\u003C\u002Fstrong> et \u003Cstrong>« Comment installer une carte moddée sur son serveur BeamMP ? »\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>1. Créer le dossier du plugin\u003C\u002Fh2>\n\u003Cp>Chaque plugin doit avoir \u003Cstrong>son propre dossier\u003C\u002Fstrong> dans \u003Ccode>Resources\u002FServer\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Connectez-vous à votre \u003Cstrong>panel gaming Winheberg\u003C\u002Fstrong> et sélectionnez votre \u003Cstrong>serveur BeamMP\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Dans le menu latéral, cliquez sur \u003Cstrong>Files\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>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 donnez au dossier le nom du plugin, par exemple \u003Ccode>WelcomeMessage\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp-1793494976681-0a7be731b90d3686d973998d.webp\" alt=\"Dossier Resources\u002FServer et bouton Create Directory dans Files\" width=\"770\" \u002F>\n\n\u003Ch2>2. Ajouter les fichiers du plugin\u003C\u002Fh2>\n\u003Cp>Ouvrez le dossier que vous venez de créer et envoyez-y les fichiers \u003Ccode>.lua\u003C\u002Fcode> du plugin avec le bouton \u003Cstrong>Upload\u003C\u002Fstrong>. Si le plugin contient plusieurs fichiers ou sous-dossiers, gardez exactement l&#39;arborescence fournie par son créateur.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp-1793494977020-76d5913c91bcc450a1d1a3a4.webp\" alt=\"Fichier main.lua dans le dossier du plugin\" width=\"770\" \u002F>\n\n\u003Cp>Le chemin final doit ressembler à ceci.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">Resources\u002FServer\u002FWelcomeMessage\u002Fmain.lua\n\u003C\u002Fcode>\u003C\u002Fpre>\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>BeamMP charge automatiquement les fichiers \u003Ccode>.lua\u003C\u002Fcode> placés \u003Cstrong>directement\u003C\u002Fstrong> dans le dossier du plugin, par ordre alphabétique. Les fichiers placés dans un sous-dossier ne sont chargés que si le plugin les appelle lui-même avec \u003Ccode>require()\u003C\u002Fcode>. Un \u003Ccode>main.lua\u003C\u002Fcode> rangé dans \u003Ccode>Resources\u002FServer\u002FWelcomeMessage\u002FWelcomeMessage\u002F\u003C\u002Fcode> ne sera donc jamais exécuté.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Redémarrer et vérifier dans la console\u003C\u002Fh2>\n\u003Cp>Un nouveau plugin n&#39;est pris en compte qu&#39;au démarrage du serveur.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Retournez sur la page principale de votre serveur\u003C\u002Fli>\n\u003Cli>Cliquez sur \u003Cstrong>Restart\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Surveillez la \u003Cstrong>console\u003C\u002Fstrong> pendant le démarrage\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>Les messages écrits par vos plugins apparaissent avec le préfixe \u003Ccode>[LUA]\u003C\u002Fcode>. Si le plugin affiche un message au chargement, vous le verrez juste après la ligne \u003Ccode>PluginMonitor started\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp-1793495108746-590b08163356e84d7c93c28c.webp\" alt=\"Ligne LUA WelcomeMessage plugin loaded dans la console\" width=\"540\" \u002F>\n\n\u003Ch2>Exemple, un plugin de bienvenue\u003C\u002Fh2>\n\u003Cp>Pour tester le fonctionnement sans rien télécharger, vous pouvez créer vous-même un petit plugin. Dans le dossier \u003Ccode>Resources\u002FServer\u002FWelcomeMessage\u003C\u002Fcode>, cliquez sur \u003Cstrong>New file\u003C\u002Fstrong>, collez le code suivant et enregistrez-le sous le nom \u003Ccode>main.lua\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-lua\">-- WelcomeMessage: greets every player who joins the server\n\nfunction onInit()\n    print(&quot;WelcomeMessage plugin loaded&quot;)\nend\n\nfunction onPlayerJoin(player_id)\n    local name = MP.GetPlayerName(player_id)\n    MP.SendChatMessage(-1, &quot;Welcome &quot; .. name .. &quot; to the server!&quot;)\nend\n\nMP.RegisterEvent(&quot;onInit&quot;, &quot;onInit&quot;)\nMP.RegisterEvent(&quot;onPlayerJoin&quot;, &quot;onPlayerJoin&quot;)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Après un redémarrage, la console affiche \u003Ccode>[LUA] WelcomeMessage plugin loaded\u003C\u002Fcode>, et chaque joueur qui rejoint le serveur est salué dans le chat. La liste complète des fonctions et événements disponibles se trouve dans la documentation officielle de BeamMP, rubrique scripting serveur.\u003C\u002Fp>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Cp>Voici les situations les plus fréquentes avec les plugins Lua.\u003C\u002Fp>\n\u003Ch3>❌ La console affiche LUA ERROR Failed\u003C\u002Fh3>\n\u003Cp>Le fichier indiqué contient une \u003Cstrong>erreur de syntaxe Lua\u003C\u002Fstrong>. Le message précise le fichier, le numéro de ligne et ce qui manque.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Ffr\u002Fgaming\u002Fbeammp\u002Fplugin-lua-serveur-beammp-1793495109122-840b04783ff54b64e0b1e129.webp\" alt=\"Erreur LUA ERROR Failed dans la console\" width=\"740\" \u002F>\n\n\u003Cul>\n\u003Cli>Ouvrez le fichier mentionné et allez à la \u003Cstrong>ligne indiquée\u003C\u002Fstrong> (ici la ligne 3, avec une parenthèse non fermée à la ligne 2)\u003C\u002Fli>\n\u003Cli>Si vous n&#39;avez pas écrit le plugin, téléchargez-le à nouveau, le fichier a pu être abîmé pendant l&#39;envoi\u003C\u002Fli>\n\u003Cli>Vérifiez que le plugin est compatible avec votre version de BeamMP, affichée dans la console au démarrage (\u003Ccode>BeamMP Server v3.9.3\u003C\u002Fcode> par exemple)\u003C\u002Fli>\n\u003C\u002Ful>\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>Une erreur dans un plugin \u003Cstrong>n&#39;arrête pas le serveur\u003C\u002Fstrong>. Il continue de tourner et les autres plugins se chargent normalement, d&#39;où l&#39;importance de lire la console après chaque installation.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch3>❌ Aucune ligne LUA n&#39;apparaît pour mon plugin\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Vérifiez que le plugin est bien dans \u003Ccode>Resources\u002FServer\u003C\u002Fcode> et \u003Cstrong>pas\u003C\u002Fstrong> dans \u003Ccode>Resources\u002FClient\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Vérifiez qu&#39;il a son \u003Cstrong>propre sous-dossier\u003C\u002Fstrong> et que ses fichiers \u003Ccode>.lua\u003C\u002Fcode> ne sont pas rangés un niveau trop bas\u003C\u002Fli>\n\u003Cli>Gardez en tête que certains plugins n&#39;écrivent rien dans la console au démarrage, consultez leur README pour savoir comment vérifier qu&#39;ils fonctionnent\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Le plugin demande aussi un fichier côté client\u003C\u002Fh3>\n\u003Cp>Certains plugins sont livrés avec une archive \u003Ccode>.zip\u003C\u002Fcode> destinée aux joueurs (interface, sons, etc.). Celle-ci se place dans \u003Ccode>Resources\u002FClient\u003C\u002Fcode>, et la partie Lua dans \u003Ccode>Resources\u002FServer\u003C\u002Fcode>. Suivez les instructions du README du plugin.\u003C\u002Fp>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Installez un plugin à la fois\u003C\u002Fstrong> et lisez la console après chaque redémarrage, vous saurez immédiatement lequel pose problème\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Créez une sauvegarde\u003C\u002Fstrong> depuis l&#39;onglet \u003Cstrong>Backups\u003C\u002Fstrong> avant d&#39;installer un plugin qui modifie des données de votre serveur\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Supprimez le dossier\u003C\u002Fstrong> d&#39;un plugin que vous n&#39;utilisez plus plutôt que de le laisser en place\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Gardez une copie\u003C\u002Fstrong> des fichiers de configuration de vos plugins avant de les mettre à jour\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d&#39;aide ?\u003C\u002Fh2>\n\u003Cp>Si votre plugin ne se charge pas 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 démarrage.\u003C\u002Fp>\n\u003Cp>Votre serveur BeamMP est prêt à accueillir vos plugins, bonne route 🛣️\u003C\u002Fp>\n",1794526345648]