How to Install Workshop Content and RocketMod Plugins on Your Unturned Server

Unturned has two separate modding routes. Steam Workshop content adds maps, items and vehicles, and every player needs it. RocketMod plugins are server side code that adds commands and behaviour, and players need nothing.

Part 1: Steam Workshop content

1. Find the workshop item and copy the numeric ID from the end of its URL.
2. Stop the server.
3. In the panel open Files and go to:

   Servers/<InstanceName>/

4. Open or create WorkshopDownloadConfig.json and list your IDs:

   {
     "File_IDs": [
       2483365400,
       2325216802
     ],
     "Ignore_Children_File_IDs": []
   }

5. Save and start the server. It downloads each item before the map loads, so the first start takes longer.

To play a workshop map, also set the map name in Commands.dat:

Map/TheMapFolderName

The name is the map's folder name, which the workshop page will tell you. It is case sensitive.

Your players do not have to subscribe manually. Unturned downloads the server's workshop content for them on connect, which is why the first join takes a while.

Part 2: RocketMod plugins

Unturned ships with RocketMod support built in, so there is nothing to install for the framework itself. Plugins are DLL files.

1. Stop the server.
2. In Files, go to:

   Servers/<InstanceName>/Rocket/Plugins/

3. Upload the plugin .dll.
4. Start the server. RocketMod creates a folder per plugin holding its configuration and translation files.
5. Stop the server again, edit the configuration that appeared, and start it.

Editing before the first run does not work, because the plugin writes its default config over the top.

RocketMod permissions

Plugin commands are gated by permissions in:

Servers/<InstanceName>/Rocket/Permissions.config.xml

Groups are defined there with a list of allowed commands and the Steam IDs that belong to them. The default group covers everyone, so put a command there only if you want all players to have it.

Reloading without a restart

From the panel console:

rocket reload
p reload

reloads plugins and permissions respectively. A plugin that fails to load reports the reason in the console.

Common problems

• A plugin built for a much older Unturned version will throw a type error on load. Check the plugin page for a current release.
• If a workshop item fails to download, the console names the ID. That usually means the item was made private or removed.
• Workshop content is downloaded to the server as well as the client, so a large map pack costs disk space on both.