[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-install-mods-unturned-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\u002Funturned\u002Finstall-mods-unturned-workshop","install-mods-unturned-workshop","How to install mods (Workshop) on your Unturned server","Easily install mods on your Winheberg Unturned server using the WorkshopDownloadConfig.json file and the Steam Workshop.","jeux","unturned","tabler:file-text","2026-07-24","Winheberg",47,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop.webp",[16,17,18],"Unturned","Mods","Workshop",[20,21,22,23,24,25],"unturned server","install unturned mods","unturned workshop","workshopdownloadconfig","pterodactyl unturned","winheberg","","\u002Fdocs\u002Funturned\u002Finstaller-mods-unturned-workshop","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>Unturned offers a vast catalogue of community-made content to enrich its post-apocalyptic universe. Adding mods to your server lets you bring in new maps, original vehicles or custom weapons for your players.\u003C\u002Fp>\n\u003Cp>On your server hosted with Winheberg, the installation is fully automated through a dedicated configuration file. The server takes care of downloading and updating Steam Workshop items on every startup. Instead of manually transferring heavy files, you simply tell the server which items to fetch.\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>This method guarantees that your server always runs the latest version of the mods and forces your players to download exactly the same files when they connect.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Requirements\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active Unturned server on your Winheberg panel\u003C\u002Fli>\n\u003Cli>A Steam account to browse the Workshop\u003C\u002Fli>\n\u003Cli>A server that has been started at least once to generate its configuration files\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Get the mod identifier on Steam\u003C\u002Fh2>\n\u003Cp>Head to the Steam Workshop page dedicated to Unturned and look for the mod you want to install. In our example, it is the mod « KJ Police Vehicles ».\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784554393942-e854ac0fbece7a6b26ae5f68.webp\" alt=\"Mod page on the Unturned Steam Workshop\" width=\"800\" \u002F>\n\n\u003Cp>Look at the page URL at the top of your browser. The mod's unique identifier is the string of digits located at the very end of the link, right after \u003Ccode>?id=\u003C\u002Fcode>. Copy this string of digits.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784554434938-467285d3d74b80b37eebc601.webp\" alt=\"URL containing the Steam Workshop mod identifier\" width=\"800\" \u002F>\n\n\u003Ch2>2. Open the configuration file\u003C\u002Fh2>\n\u003Cp>Log in to your Winheberg gaming panel \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">https:\u002F\u002Fpanel.winheberg.com\u002F\u003C\u002Fa> and open the file manager of your Unturned server.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784554766386-9e3fc322e55be84e9f31793f.webp\" alt=\"File manager of an Unturned server on the panel\" width=\"800\" \u002F>\n\n\u003Cp>Open the \u003Ccode>Servers\u003C\u002Fcode> folder.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784557398888-d8c01abcd441e3ca1e755b1d.webp\" alt=\"Servers folder of an Unturned server\" width=\"800\" \u002F>\n\n\u003Cp>Then enter your instance folder, usually named \u003Ccode>PterodactylUnturned\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784555150364-56c55b72039fbeb162abcd07.webp\" alt=\"PterodactylUnturned instance folder\" width=\"800\" \u002F>\n\n\u003Cp>Locate the file named \u003Ccode>WorkshopDownloadConfig.json\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784557524546-0760a4c70d8c111f4da1bc5b.webp\" alt=\"WorkshopDownloadConfig.json file in the file manager\" width=\"800\" \u002F>\n\n\u003Cp>Click on it to open it in the panel's text editor.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784557681709-3709299c4e823efdb972fc1b.webp\" alt=\"Panel text editor showing the JSON file\" 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>If this file does not exist, start your server at least once since its installation so that it gets generated.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Add the mods to the file\u003C\u002Fh2>\n\u003Cp>The file opens in JSON format. Insert the identifier you copied in the previous step into the \u003Ccode>File_IDs\u003C\u002Fcode> section.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784557776254-efebead954df3dffc0c20733.webp\" alt=\"Adding the mod identifier to the File_IDs section\" width=\"800\" \u002F>\n\n\u003Cp>To install several mods, separate each identifier with a comma. The last identifier in the list must not have any comma after it.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">{\n  "File_IDs": [\n    123456789,\n    987654321\n  ],\n  "Ignore_Children_File_IDs": [],\n  "Maximum_Dependencies": 10,\n  "Maximum_Download_Retries": 3\n}\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Then click the save button to apply your changes.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Funturned\u002Finstall-mods-unturned-workshop-1784558469103-89ef906db0cf59cdacffb4ea.webp\" alt=\"Save button of the configuration file\" width=\"800\" \u002F>\n\n\u003Cp>Finally, restart your server. On the next startup, it will automatically download the listed mods from the Steam Workshop.\u003C\u002Fp>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ The WorkshopDownloadConfig.json file is nowhere to be found\u003C\u002Fh3>\n\u003Cp>The file does not appear in your instance folder.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Make sure your server has been started at least once since its installation\u003C\u002Fli>\n\u003Cli>Check that you are browsing the right folder, \u003Ccode>Servers\u003C\u002Fcode> then the \u003Ccode>PterodactylUnturned\u003C\u002Fcode> instance\u003C\u002Fli>\n\u003Cli>Reload the file manager page to refresh the display\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The server does not load the mods after editing\u003C\u002Fh3>\n\u003Cp>A syntax error in the JSON file prevents it from being read correctly.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check that no comma remains after the last identifier in the list\u003C\u002Fli>\n\u003Cli>Make sure each identifier is separated from the next by a comma\u003C\u002Fli>\n\u003Cli>Confirm that the \u003Ccode>[\u003C\u002Fcode> and \u003Ccode>]\u003C\u002Fcode> brackets of the \u003Ccode>File_IDs\u003C\u002Fcode> section are properly closed\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A mod does not download on startup\u003C\u002Fh3>\n\u003Cp>The server starts but the expected content is still missing.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check that the copied identifier matches exactly the digits located after \u003Ccode>?id=\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Confirm that the mod is still available and public on the Steam Workshop\u003C\u002Fli>\n\u003Cli>Restart the server to trigger the download phase again\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If the download of your mods keeps failing 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 Unturned server in the \u003Cstrong>Related Product\u003C\u002Fstrong> field.\u003C\u002Fp>\n\u003Cp>Your players can now discover brand new content on your Unturned server. 🎮\u003C\u002Fp>\n",1788993143184]