Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
World desk10 min

How to Upload a Custom Map to an Unturned Server

A practical guide to installing a Steam Workshop map on an Unturned server, selecting it by name, handling dependencies, and troubleshooting PEI fallback.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To upload a Steam Workshop map to an Unturned server, add the map’s numeric Workshop ID to WorkshopDownloadConfig.json, let the server download the map and any dependencies, then set the map’s exact name in Commands.dat. Both files must be in the active server instance’s folder: U3DS/Servers/<ServerID>. The ID downloads the Workshop item; the name tells Unturned which installed map to load.

What you need before adding the map

You need access to the dedicated-server files for the specific Unturned instance you want to change. On a self-hosted machine, this normally means local file access. A managed host must provide FTP/SFTP or a web file manager with permission to edit the server configuration.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • An installed and updated Unturned Dedicated Server.
  • The server’s active ServerID folder.
  • The public Steam Workshop page for the map, unless you are following the separate private-file procedure.
  • The map’s numeric Workshop ID and its exact in-game name.
  • Permission to restart the server after changing configuration files.

Do not confuse a Workshop collection with a map item. The value placed in File_IDs must identify the map Workshop item itself. If the map depends on other Workshop files, the server can discover those dependencies during startup after the main item is configured.

Install or update the Unturned Dedicated Server

Linux with SteamCMD

Linux installations use Steam app ID 1110390 for the Unturned Dedicated Server. Run SteamCMD with the normal login and installation options for your host, then update that app. A typical SteamCMD command sequence is:

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
steamcmd +login anonymous +app_update 1110390 validate +quit

The exact SteamCMD executable path and installation directory depend on your Linux distribution and the account running the service. After installation, launch the server once with its chosen ServerID. Linux hosts commonly start the server through ServerHelper.sh. The first launch creates the per-server directory used for saves and configuration.

Windows

Windows hosts can use the standalone dedicated-server application. Start it once with the server’s ServerID so Unturned creates the matching directory before you edit files. If you maintain more than one instance, each instance has its own configuration and save data; changing one folder does not change another.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why the first launch matters

Unturned stores each instance under:

U3DS/Servers/<ServerID>

The placeholder is the actual ID you use when launching the server. The Workshop configuration and map command must be placed in that instance’s directory, not merely in the top-level game folder and not in a different server’s directory. A frequent reason for “the map did not install” is editing a folder that the running process never reads.

Find the Workshop ID and the exact map name

Copy the numeric Workshop ID

Open the map’s Steam Workshop page and copy the numeric value at the end of its URL. That number is the Workshop ID to put in the File_IDs array. Keep the complete number; do not paste the map title, a collection ID, or the URL itself.

For example, a URL ending in a number such as 1234567890 contributes only 1234567890 to the configuration. The example number is illustrative; use the number shown on your map’s page.

Record the map’s actual name

The Workshop ID and the map name perform different jobs:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.
  • Workshop ID: tells the server which Workshop item to download.
  • Map name: tells the server which installed map to load.

Use the name displayed by the map itself, preserving spelling, spaces, punctuation and capitalization where applicable. Do not use the numeric ID in the Map command. If the Workshop title and the in-game map name differ, the in-game name is the one that matters.

Add the map to WorkshopDownloadConfig.json

Open the active configuration file

In the server instance folder, locate:

U3DS/Servers/<ServerID>/WorkshopDownloadConfig.json

Stop the server before editing when possible. Stopping first prevents a running process from overwriting your changes and gives you a clean startup in which to observe the Workshop download. Make a backup copy of the file before changing it, especially if the server already uses several Workshop items.

Enter the ID in the File_IDs array

The file uses JSON syntax. A minimal configuration for one map looks like this:

{
  "File_IDs": [
    1234567890
  ]
}

Replace the example number with the map’s real numeric Workshop ID. For multiple items, separate each number with a comma:

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
{
  "File_IDs": [
    1234567890,
    2345678901,
    3456789012
  ]
}

Use numbers, not quoted strings, unless the file created by your installation already uses a different valid format. Every opening brace, bracket and quotation mark must have a matching closing character. A trailing comma after the final ID is invalid JSON and can prevent the configuration from loading.

Check that you edited the right instance

If you have several servers, verify all of the following before restarting:

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
  • The ServerID in the path matches the ID used by the startup script or launch command.
  • The file is named exactly WorkshopDownloadConfig.json.
  • The map ID is inside File_IDs, not in a note, comment or unrelated configuration file.
  • Your file editor did not append an extra extension such as .txt.

Start the server and wait for Workshop downloads

Start the same server instance after saving the JSON file. During startup, Unturned checks the configured Workshop items, updates them and detects dependencies. The official hosting guidance states that files are updated during startup, dependencies are detected at that stage, and players download the files while connecting.

Do not select the map immediately after clicking Start if the console is still downloading files. Allow the first startup to finish. The time required depends on the size of the map, its dependencies, disk performance and the server’s connection. A map can appear correctly configured while still being unavailable because its files have not finished downloading.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What a successful startup should show

  • The server reads WorkshopDownloadConfig.json without a JSON or file-access error.
  • The configured Workshop item is downloaded or updated.
  • Any dependencies discovered during startup are processed.
  • The server proceeds to its normal ready state instead of stopping during initialization.

If the process reports a download failure, leave the map selected in the configuration and resolve the underlying access, ID or network problem before trying to force the map through Commands.dat. The map command cannot load files that were never installed.

Select the custom map in Commands.dat

Edit the file in the same ServerID folder

After the Workshop download has completed, open:

U3DS/Servers/<ServerID>/Commands.dat

Add a line using the map’s exact name:

Map Exact Map Name

Replace Exact Map Name with the real map name. The command uses the name to search the installed Workshop items. It does not use the numeric Workshop ID.

Example Commands.dat

A server may contain other commands as well. Keep existing settings and add the map line as its own command:

Name My Unturned Server
Map Example Island
MaxPlayers 12

The other lines are examples only. Use the commands and values appropriate to your server. The important part for map selection is a separate line beginning with Map followed by the exact map name.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Restart after changing the map command

Save Commands.dat and restart the server. Map selection is applied during startup, so changing the file while the server is already running does not reliably switch the current session. Watch the console for the selected map and for any fallback behavior.

Verify that the server loaded the custom map

Use the startup console as the first verification point, then connect as a player. Check that:

  • The server completes Workshop processing before becoming ready.
  • The console identifies the intended map rather than the default PEI map.
  • A client can connect and begins downloading the configured Workshop files.
  • The map loads into the expected world instead of stopping at startup or returning to a default.

Players receive configured Workshop files while connecting. Warn players that the first connection can take longer, particularly when the map has large dependencies. Server bandwidth also matters: every connecting player may need to download the files before entering the world.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Why an Unturned server loads PEI instead

When a server starts on PEI instead of the custom map, work through these checks in order. Each check addresses a different stage of the process.

  1. Confirm the active folder. Make sure both files are under the ServerID used by the running process.
  2. Confirm the Workshop ID. It must be the numeric ID at the end of the map’s Workshop URL, not a collection ID or map name.
  3. Validate the JSON. Check commas, brackets, quotation marks and the spelling of File_IDs.
  4. Wait for the download. Let startup finish updating the map and discovering dependencies.
  5. Check the map line. Commands.dat must contain Map followed by the map’s exact installed name.
  6. Check availability. The normal ID workflow is for Workshop files the dedicated server can access. A private item requires the separate private-file procedure.
  7. Restart after corrections. Stop and start the server so both configuration files are read again.

A valid ID alone does not select a map, and a correct map name alone does not download one. Both stages must succeed.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Public server access: GSLT and port forwarding

Game Server Login Token

A public Internet server needs a valid Game Server Login Token (GSLT) to appear in the Unturned server list. This requirement is separate from Workshop installation. A map can load correctly on a server that is still invisible in the public browser if its token is missing or invalid.

Home-network hosting

If the server runs on a computer behind a home router, configure port forwarding so outside traffic reaches the server machine. Port-forwarding rules depend on your router and network layout; reserve the server computer’s local address when your router supports that option, then forward the ports required by your Unturned setup to that machine. Test from an external connection rather than relying only on a connection from inside the same network.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Bandwidth and connection time

Because players download Workshop files while connecting, a large map or dependency set increases the amount of data your server must deliver. Account for upload capacity and concurrent connections when deciding whether a home connection is suitable. Slow downloads do not necessarily indicate a bad map configuration; they can reflect the server’s available upstream bandwidth.

Self-hosting versus managed hosting

The map workflow is the same in principle, but the amount of control differs. Before choosing a host, confirm that you can reach the two files and perform restarts.

Capability Self-hosted server Managed host
Access to WorkshopDownloadConfig.json and Commands.dat Direct filesystem access, assuming you own the machine Must be provided through FTP/SFTP or a web file manager
Restart control Use your service, script or console Use the provider’s control panel or restart option
SteamCMD and version maintenance You install, update and troubleshoot the dedicated server The provider may handle the base installation; confirm what updates are automatic
Backups You schedule and store backups Check whether automatic backups exist, how often they run and how restoration works
Network exposure You configure GSLT, firewall rules and home-router port forwarding when applicable The provider normally supplies the public network endpoint; verify its port and access requirements
Workshop troubleshooting You can inspect the complete console and filesystem Confirm that logs and Workshop files are accessible to you

A provider guide may show the same pattern—put the Workshop ID in WorkshopDownloadConfig.json, put the map name in Commands.dat and restart—but provider-specific interfaces and terms vary. Confirm those details before moving an established world.

How private Workshop maps differ

A dedicated Unturned server cannot log in to a Steam account to download private Workshop files. Therefore, a private map cannot be handled by simply placing its ID in the normal public-map File_IDs workflow.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Private-map hosting follows Smartly Dressed Games’ separate private-file procedure. Use that procedure for the file transfer and access requirements, then apply the map-selection step appropriate to the resulting installed files. Do not expose a private item’s access credentials or assume that making the item public temporarily is equivalent to the private workflow.

Updating, replacing or removing a custom map

Updating an existing map

Leave the map’s Workshop ID in File_IDs and restart the server during a maintenance window. Workshop files are updated during startup. Let the update and dependency checks finish before allowing players to join, particularly when the map author has published a major revision.

Replacing the active map

  1. Stop the server and back up the active ServerID folder.
  2. Replace the old ID in WorkshopDownloadConfig.json with the new map’s numeric ID, or add the new ID while retaining other required items.
  3. Change the Map line in Commands.dat to the new map’s exact name.
  4. Start the server and wait for Workshop downloads and dependency detection.
  5. Read the console to confirm that the new map, rather than PEI or the former map, is selected.

Removing a map

To stop automatically updating a map, remove its ID from the File_IDs array and remove or replace its Map line. Keep a backup of the old configuration and save data before deleting any Workshop folders manually. The current official workflow is configuration-driven; manual copying under Bundles/Workshop/Maps is a legacy method and should be reserved for a provider or older installation that specifically requires it.

Complete upload checklist

  • Dedicated server installed or updated; Linux SteamCMD app ID is 1110390.
  • Server launched once with the intended ServerID.
  • Workshop ID copied from the end of the map’s URL.
  • WorkshopDownloadConfig.json edited in U3DS/Servers/<ServerID>.
  • ID placed inside the valid JSON File_IDs array.
  • Server started and allowed to finish downloading the map and dependencies.
  • Commands.dat edited in the same ServerID folder.
  • Map line uses the exact map name, not the numeric ID.
  • Server restarted and console checked for the selected map.
  • For public listing, a valid GSLT configured.
  • For home hosting, port forwarding configured and tested externally.
  • For private maps, the separate private-file procedure followed instead of the public-ID workflow.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.