Unturned Mod and Plugin Installation

This guide covers how to install Steam Workshop mods and RocketMod/LDM plugins on your Unturned server. For initial server configuration, see the Unturned Server Setup Guide.

Workshop Mod Installation

Unturned uses the Steam Workshop for mods including custom maps, items, skins, and gameplay modifications. Your server downloads workshop content automatically on startup using a configuration file.

Workshop Configuration File

The workshop config file is located at:

Servers/default/WorkshopDownloadConfig.json

You can edit this file through the GPanel file manager or via SFTP.

Adding Workshop Mods

To find the Workshop ID for a mod, open its Steam Workshop page and look at the URL — the number after ?id= is the Workshop ID.

Edit WorkshopDownloadConfig.json and add Workshop IDs to the File_IDs array:

{
  "File_IDs": [
    1234567890,
    9876543210
  ],
  "Ignore_Children_File_IDs": [],
  "Query_Cache_Max_Age_Seconds": 600,
  "Max_Query_Retries": 2,
  "Use_Temporary_Token": false,
  "Steam_Token": ""
}

Removing a Workshop Mod

To remove a mod, delete its Workshop ID from the File_IDs array and restart the server. The downloaded mod files will remain on disk but will no longer be loaded.

Workshop Maps

Workshop maps are installed the same way — add the Workshop ID to WorkshopDownloadConfig.json. After the server downloads the map, set the map folder name as the Map value in Commands.dat. The map folder name is typically visible in the server console output during startup.

Workshop Mod Tips

• Players also need to subscribe to the same workshop items on Steam to see custom content (skins, maps, objects).
• Official curated maps (PEI, Washington, Russia, etc.) are included with Unturned and do not need Workshop IDs.
• If a mod fails to download, check the server console log in GPanel for Steam download errors.
• Some mods have dependencies on other workshop items — check the mod's workshop page for required items and add those IDs as well.

RocketMod / LDM Plugin Framework

RocketMod (and its community-maintained fork LDM — Legally Distinct Mod) is the most widely used plugin framework for Unturned. It provides a server-side API for plugins including economy systems, kits, home commands, permissions, teleportation, and much more.

Plugin Directory

Rocket plugins are .dll files placed in:

Rocket/Plugins/

Installing a Plugin

1. Download the plugin .dll file from the plugin author's release page or repository.
2. Upload the .dll file to Rocket/Plugins/ using the GPanel file manager or SFTP.
3. Restart the server from GPanel.
4. On first run, RocketMod generates a configuration file for the plugin (e.g., Rocket/Plugins/PluginName/PluginName.configuration.xml).
5. Edit the generated config as needed, then restart the server again to apply your changes.

Rocket Permissions

Player permissions for Rocket plugin commands are managed in:

Rocket/Permissions.config.xml

This file defines permission groups, their members, and which commands each group can use. Example:

<Group Id="vip" DisplayName="VIP" Color="yellow" Prefix="" Suffix="" Priority="1">
  <Members>
    <Member>76561198000000001</Member>
  </Members>
  <Permissions>
    <Permission Cooldown="0">home</Permission>
    <Permission Cooldown="120">kit vip</Permission>
  </Permissions>
</Group>

Key fields:

Popular RocketMod Plugins

Related Articles

• Unturned Server Setup Guide — Initial configuration, GSLT, maps, and connecting.
• Unturned Admin Setup — Permissions, admin list, and in-game admin commands.
• Unturned Troubleshooting — Common server issues and solutions.
• How to Find Your Server IP and Port
• How to Upload Files via SFTP

Need Help?

If you need assistance with mods or plugins, our support team is happy to help.