[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-install-mods-garrys-mod-workshop":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_fr":27,"bodyHtml":28},"\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop","install-mods-garrys-mod-workshop","How to install mods on your Garry's Mod server","Learn how to easily install mods on your Garry's Mod server hosted by Winheberg.","jeux","garrysmod","tabler:file-text","2026-07-24","Winheberg",46,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop.webp",[16,17,18],"Garry's Mod","Mods","Workshop",[20,21,22,23,24,25],"garry's mod server","install gmod mods","steam workshop gmod","workshop collection","pterodactyl gmod","winheberg","","\u002Fdocs\u002Fgarrysmod\u002Finstaller-mods-garrys-mod-workshop","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>Garry's Mod (GMod) is a sandbox game that draws all its strength from its community and its thousands of add-ons. Adding mods to your server lets you tailor your players' experience with new weapons, maps or game modes.\u003C\u002Fp>\n\u003Cp>On your server hosted with Winheberg, the installation is mainly done through the Steam Workshop. Linking a Workshop collection to your server greatly simplifies administration, since the server downloads the mods straight from Steam on every startup. You can also add files manually for your own custom development.\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>A Workshop collection is the most reliable method to ensure that all your players run the same mod versions as the server.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Requirements\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active Garry's Mod server on your Winheberg panel \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">https:\u002F\u002Fpanel.winheberg.com\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>A public Steam account with a ready Workshop collection\u003C\u002Fli>\n\u003Cli>The server must have been started at least once\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Create a collection on the Steam Workshop\u003C\u002Fh2>\n\u003Cp>Head to the Garry's Mod Steam community page and create a new collection. Add every mod you want to run on your server.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784576252076-6bda78d88bfb796e1702f92f.webp\" alt=\"Garry's Mod Steam Workshop page\" width=\"800\" \u002F>\n\n\u003Cp>Once the collection is created, make sure to click the « Publish » button to make it visible. Then note the numeric identifier (ID) of your collection, found in the page URL.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784577189144-3387638f079ddef85cd9cccb.webp\" alt=\"Published Steam Workshop collection with its ID in the URL\" width=\"800\" \u002F>\n\n\u003Ch2>2. Configure the server on the Winheberg panel\u003C\u002Fh2>\n\u003Cp>Log in to your Winheberg gaming panel at \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">https:\u002F\u002Fpanel.winheberg.com\u003C\u002Fa> and select your Garry's Mod server. Navigate to the startup configuration section (Startup tab).\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784585770185-19c071e1471123188aa05026.webp\" alt=\"Startup tab of the Garry's Mod server on the Winheberg panel\" width=\"800\" \u002F>\n\n\u003Cp>The Startup tab holds the variables read by the server at launch. Fill in the field below with your Steam collection identifier.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Setting\u003C\u002Fth>\n\u003Cth>Value to enter\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>Workshop Collection ID\u003C\u002Ftd>\n\u003Ctd>The numeric identifier of your Steam collection\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784585895064-99ae670882305b76dfe39b90.webp\" alt=\"Workshop Collection ID field filled in the Startup tab\" width=\"800\" \u002F>\n\n\u003Cp>Once this information is filled in, go back to the main page and restart your server. The console will show the download of each add-on from your collection.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784586138842-e93a3bd87a76b9388e2a3759.webp\" alt=\"Panel console showing the download of the Workshop add-ons\" width=\"800\" \u002F>\n\n\u003Cp>As you can see in the console, the mods were downloaded successfully.\u003C\u002Fp>\n\u003Ch2>3. Alternative with manual installation via SFTP\u003C\u002Fh2>\n\u003Cp>If you own custom mods or ones bought on third-party platforms, manual installation becomes necessary.\u003C\u002Fp>\n\u003Cp>Connect to your server files with an SFTP client such as FileZilla or WinSCP. The connection credentials are found in the Settings tab of your server.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784588040000-98d6847b28bc5510bbc54250.webp\" alt=\"Settings tab of the Garry's Mod server on the panel\" width=\"800\" \u002F>\n\n\u003Cp>They are grouped in the SFTP Details section, outlined in red (hidden here for privacy reasons).\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784588308869-cf53b148eff23060eb48d826.webp\" alt=\"SFTP Details section in the server settings\" width=\"800\" \u002F>\n\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>Your SFTP password is the same as the one you use to log in to the panel.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Then connect with this information. Navigate to your server's root directory, open the \u003Ccode>garrysmod\u003C\u002Fcode> folder then enter the \u003Ccode>addons\u003C\u002Fcode> subfolder. Drag and drop your mod folder directly into this location, then restart the server from the Winheberg panel to apply the changes.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fgarrysmod\u002Finstall-mods-garrys-mod-workshop-1784588674129-4f4462f46e11b719c6f149ea.webp\" alt=\"Addons folder opened in the SFTP client\" width=\"800\" \u002F>\n\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>Your mod folder must contain the right subfolders (\u003Ccode>lua\u003C\u002Fcode>, \u003Ccode>models\u003C\u002Fcode>, \u003Ccode>materials\u003C\u002Fcode>) and above all a valid \u003Ccode>addon.json\u003C\u002Fcode> or \u003Ccode>addon.txt\u003C\u002Fcode> file at its root. A wrong structure will prevent the mod from loading.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ The server does not download the Workshop mods\u003C\u002Fh3>\n\u003Cp>The console shows no add-on download on startup.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check that your Workshop collection is set to public mode\u003C\u002Fli>\n\u003Cli>Confirm that the collection ID you entered matches the one in the URL\u003C\u002Fli>\n\u003Cli>Make sure you restarted the server from the panel\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The manually installed mod does not appear\u003C\u002Fh3>\n\u003Cp>The add-on copied over SFTP has no effect in game.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check that the folder is not compressed (zip or rar format) before uploading it\u003C\u002Fli>\n\u003Cli>Verify the internal structure of the folder (\u003Ccode>lua\u003C\u002Fcode>, \u003Ccode>models\u003C\u002Fcode>, \u003Ccode>materials\u003C\u002Fcode>)\u003C\u002Fli>\n\u003Cli>Make sure a valid \u003Ccode>addon.json\u003C\u002Fcode> or \u003Ccode>addon.txt\u003C\u002Fcode> file sits at the root\u003C\u002Fli>\n\u003Cli>Restart the server after adding the files\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Players see giant « ERROR » signs or pink textures\u003C\u002Fh3>\n\u003Cp>The content shows up but some models or textures are missing.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Confirm that the mod in question does not require additional content to install\u003C\u002Fli>\n\u003Cli>Ask your players to verify the integrity of their game files on Steam\u003C\u002Fli>\n\u003Cli>Check in the server console that the add-on was properly downloaded\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Avoid adding hundreds of mods so you do not lengthen your players' connection time\u003C\u002Fli>\n\u003Cli>Always read a mod's description on the Workshop to check its dependencies\u003C\u002Fli>\n\u003Cli>Remove obsolete mods or those that generate errors in the server console\u003C\u002Fli>\n\u003Cli>Group your custom scripts into a single add-on folder when possible to optimise loading\u003C\u002Fli>\n\u003Cli>Keep track of your mod identifiers to make maintaining your collection easier\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If your mods refuse to load despite these checks, our support team is available. Open a ticket from your client area \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">https:\u002F\u002Fbilling.winheberg.com\u003C\u002Fa> by selecting the \u003Cstrong>Technique\u003C\u002Fstrong> department, then fill in your Garry's Mod server in the \u003Cstrong>Related Product\u003C\u002Fstrong> field.\u003C\u002Fp>\n\u003Cp>Enjoy your customised Garry's Mod server. 🎮\u003C\u002Fp>\n",1788993141244]