October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix NowOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Use Steam Workshop Maps on a Garry’s Mod Server

Install and serve Garry’s Mod Workshop maps correctly: configure a collection or Workshop-ID file, start the BSP map, verify client delivery and fix missing dependencies.
Length10 min Posted Quest giverVGSources Team

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.

To run a Steam Workshop map on a Garry’s Mod dedicated server, install or update the server with SteamCMD, make the map available through a public or unlisted Workshop collection (or a supported Workshop-ID file), then start the server with +host_workshop_collection and +map. When the active map is in that collection, Garry’s Mod can mark it for automatic client download. Server installation and client delivery are separate jobs: resource.AddWorkshop() does not install an addon on the dedicated server.

How Workshop maps reach a Garry’s Mod server

A working setup has three distinct stages:

  • Server installation: The dedicated server downloads the Workshop addon and mounts it.
  • Map selection: The server starts, or later changes to, the map using its BSP filename.
  • Client delivery: Players receive the active Workshop map through Garry’s Mod’s Workshop download path.

A player subscribing to a map in the regular Garry’s Mod client does not install that map on your dedicated server. The server needs its own Workshop collection or Workshop-ID 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.

Choose a collection or individual Workshop IDs

Facepunch documents two server-side ways to identify Workshop content. A collection is usually the simplest operational choice; an ID list is useful when you need to select items individually.

Configuration How it is supplied Visibility or access requirement Update and administration model Version support
Workshop collection Add the collection ID to the startup command with +host_workshop_collection COLLECTION_ID. The collection must be public or unlisted so the dedicated server can access it. Add or remove maps in one Workshop collection. The server downloads and mounts the collection’s addons at startup. Supported by the standard collection workflow.
Per-ID configuration Put Workshop IDs in garrysmod/cfg/srcds_workshop_ids.txt. No collection object needs to be published; the server reads the IDs from its local configuration. Provides item-by-item control instead of changing a collection. Use the syntax required by the server version in the file’s documentation. Facepunch identifies this file as new in Garry’s Mod version 2026.09.22 or newer.

Use a collection when staff want one shared list that is easy to maintain. Use the ID file when a server needs a deliberately curated set of individual items or when collection membership is not the desired administration model. In either case, the server must be able to access every item before it can mount the content.

#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter | 4Pack Type C Female to A Male Cable Converter for Apple Duo 17 16 15 14 Plus,iWatch Watch 12 11 10,iPad 9 8 Air,Airpods 5 4
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

Prerequisites before adding a map

  • A Garry’s Mod dedicated-server installation that you can stop, update and start with your normal srcds command.
  • SteamCMD, with the server installed or updated using app ID 4020.
  • The Workshop collection ID or the individual Workshop IDs you intend to use.
  • The map’s BSP filename. Garry’s Mod commands use the filename without the .bsp extension, not necessarily the map’s display title.
  • Any supported Source-game content required by the map, mounted through garrysmod/cfg/mount.cfg when applicable.

Keep the server stopped while changing its startup command or Workshop-ID configuration. A restart is also the normal way to make collection changes take effect, because the collection is downloaded and mounted during startup.

Install or update the dedicated server with SteamCMD

Open SteamCMD and run the Garry’s Mod dedicated-server update command:

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

Run this for a new installation and whenever you need to bring the dedicated server up to date. The command updates the server files; it does not by itself select a Workshop collection or choose a map. Those jobs are handled by the startup parameters described below.

Create a Workshop collection for the server

  1. Open the Garry’s Mod Workshop and create a collection for the server’s maps.
  2. Add each required Workshop map to that collection. If a map depends on additional Workshop items, include those items when the map’s distribution requires them.
  3. Set the collection to Public or Unlisted. A private collection cannot be accessed by the dedicated server through this workflow.
  4. Copy the collection’s numeric ID. You will place that value in the server startup command, not the collection’s display name.
  5. Save the collection before starting the server, so the server sees the intended membership on its first request.

An unlisted collection is not shown as openly as a public one, but it remains accessible by its ID. That makes it useful when you want server access without presenting the collection as a public directory.

Attach the collection to the server startup command

Add +host_workshop_collection followed by the collection ID. The same command should include the gamemode and the initial map. Facepunch’s example is:

Rank #2
Sale
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
srcds.exe +maxplayers 20 -console +host_workshop_collection 157384458 +gamemode sandbox +map gm_construct

In this example:

  • +maxplayers 20 sets the advertised player limit.
  • -console keeps the dedicated server in console mode.
  • +host_workshop_collection 157384458 tells the server which Workshop collection to download and mount.
  • +gamemode sandbox selects the gamemode.
  • +map gm_construct starts the server on the map named gm_construct.

Replace 157384458 with your collection ID and replace gm_construct with the target map’s BSP name. Do not append .bsp to the map argument.

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.

When this command runs, the server downloads the collection at startup and mounts all downloaded addons. If you change the collection, restart the server so the new membership is fetched and mounted during the next startup.

Use the Workshop-ID file instead of a collection

On Garry’s Mod versions 2026.09.22 and newer, Facepunch documents garrysmod/cfg/srcds_workshop_ids.txt for servers that need a list of Workshop IDs rather than a collection. Create or edit that file inside the server’s garrysmod/cfg directory and add the required Workshop items using the syntax supported by your build.

This approach keeps selection in the server’s configuration. It is useful when you want to add or remove one item without editing a shared collection. It does not change the map command: after the IDs have been made available to the server, start the desired map with +map MAP_NAME, still omitting .bsp.

If the server is older than 2026.09.22, use the collection workflow instead of assuming that srcds_workshop_ids.txt is supported.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter | 85W Max PD, 2 USB 3.0 & 1 USBC Data Ports, SD/TF Card Reader, for Laptops/Mac and Other Type C Devices (Charger Not Included)
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Start the map and change it later

Start on a Workshop map

Use the map’s BSP filename without its extension:

+map MAP_NAME

For example, +map gm_construct starts gm_construct.bsp. The Workshop item’s marketing title can differ from the filename, so use the actual BSP name expected by the server.

Change maps while the server is running

From the server console, issue:

changelevel MAP_NAME

Use the same no-extension BSP naming rule. Changing levels does not replace the server’s Workshop configuration; it only selects another map that the server has available.

Confirm that the server made the map available to players

Watch the server console during startup and map changes. When the running map is in the server’s Workshop collection, Garry’s Mod automatically marks it for client download. The console should contain this exact message:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Making workshop map available for client download

This message confirms that the active Workshop map has entered Garry’s Mod’s client-download path. It does not prove that every dependency is mounted or that a player’s local download completed successfully; those are separate checks.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

Server installation is not the same as client delivery

A frequent configuration mistake is using resource.AddWorkshop("WORKSHOP_ID") as though it installs the addon on the server. It does not. Facepunch explicitly distinguishes this client download declaration from the server-side Workshop installation workflow.

  • +host_workshop_collection or the supported Workshop-ID configuration lets the dedicated server download and mount server content.
  • resource.AddWorkshop() tells clients what to download; it does not install the Workshop addon on the dedicated server.
  • All resource.Add* functions share an 8,192 downloadable-file limit. This limit is relevant to client resource declarations and is not a substitute for server-side Workshop installation.

If the server has never downloaded the map, adding resource.AddWorkshop() will not repair the server. Fix the collection or ID configuration first, then verify the startup log.

Fix missing textures, models and other assets

A map can load on the server while players see missing textures, error models or other incomplete assets. The usual reason is that the map depends on content from another Source game or on additional files that have not been mounted or delivered.

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

Mount supported Source-game content

Use garrysmod/cfg/mount.cfg to mount installed folders from supported Source games such as Counter-Strike: Source and Team Fortress 2, when the map requires their assets. The game must actually be installed on the machine running the server, and the mount path must point to the correct directory.

Check Linux path capitalization

Linux paths are case-sensitive. A path that appears correct on a case-insensitive Windows installation can fail on Linux if a directory or filename uses different capitalization. Check every component of the path in mount.cfg and correct the case to match the filesystem.

Best Value
Sale
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display | 85W Max PD, 1 Powered USB-C 5Gbps & 2 Powered USB-A 3.0 5Gbps Data Ports, for MacBook Pro, MacBook Air, Dell and More (Black)
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

Separate dependency problems from download problems

  • If the server cannot change to the map, check the collection or ID configuration and the BSP name first.
  • If the server changes level but clients see missing assets, inspect mount.cfg and the map’s required game content.
  • If clients never begin downloading the map, look for the console message confirming Workshop client availability and verify that the active map is in the configured Workshop content.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

WorkshopDL, FastDL and ServerDL: which delivery path fits?

Facepunch separates WorkshopDL, FastDL and ServerDL. They are not interchangeable names for the same operation.

Delivery method Setup effort Transfer behavior Update handling Best fit
WorkshopDL Low additional setup when the content is already published on the Workshop and the server is configured with a collection or Workshop IDs. Clients obtain Workshop-hosted content through Garry’s Mod’s Workshop path after the server makes the active map available. Workshop item revisions are handled through the Workshop workflow; restart the server when changing the server’s collection or ID configuration. Workshop-hosted maps and addons.
FastDL Requires separate file hosting and synchronization of the downloadable files. Clients retrieve files from the configured HTTP download location rather than the Workshop item itself. You must update the hosted copy when the server content changes. Custom files that you host outside the Workshop or content for which you control a dedicated download mirror.
ServerDL Uses the game server as the delivery source, with no separate Workshop collection requirement for files that are served this way. Clients download directly from the server, consuming its available bandwidth. Replace or update the server-side files and configuration yourself. Situations where direct server delivery is acceptable, especially for limited or non-Workshop content.

For a map that is already on the Steam Workshop, WorkshopDL is the natural first choice. FastDL and ServerDL are alternatives with different hosting, bandwidth and update responsibilities; switching to one does not fix a missing server-side Workshop installation.

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

Troubleshooting by symptom

The server starts, but the map is not found

  • Confirm that the startup command contains +host_workshop_collection and the correct collection ID, or that the ID file is supported and populated.
  • Verify that the collection is public or unlisted rather than private.
  • Check the +map value or changelevel value. It must be the BSP filename without .bsp.
  • Restart after changing the collection so the server can download and mount the revised content.

The server has the map, but players are not prompted to download it

  • Make sure the active map is one of the Workshop items made available to the server.
  • Look for Making workshop map available for client download in the server console.
  • Do not rely on resource.AddWorkshop() to install the map on the server; it is a client-side declaration.
  • Check whether the content is actually being delivered through WorkshopDL, FastDL or ServerDL, and make sure the chosen method matches where the files are hosted.

Players join but see missing textures or error models

  • Identify whether the map depends on Counter-Strike: Source, Team Fortress 2 or another supported Source-game folder.
  • Mount the required game in garrysmod/cfg/mount.cfg.
  • On Linux, correct capitalization in every mount path.
  • Check whether the dependency itself is included in the Workshop configuration or is expected to be supplied through another download method.

The collection changed, but the server still uses the old content

Stop and restart the dedicated server after changing collection membership. The collection is downloaded and mounted at startup; changing the Workshop page while the process is running does not replace that startup step.

The ID-file method does not work

Check the server version first. Facepunch documents srcds_workshop_ids.txt as new in version 2026.09.22 or newer. On an older build, use +host_workshop_collection with a public or unlisted collection instead.

Recommended setup checklist

  1. Run SteamCMD and update the Garry’s Mod dedicated server with app_update 4020.
  2. Create a Workshop collection containing the maps and any required Workshop dependencies.
  3. Set the collection to Public or Unlisted.
  4. Copy the collection ID, or prepare garrysmod/cfg/srcds_workshop_ids.txt if the server is version 2026.09.22 or newer and you need individual IDs.
  5. Add the Workshop configuration to the startup command.
  6. Start the desired map with +map MAP_NAME, without .bsp.
  7. Confirm the console message Making workshop map available for client download.
  8. If assets are missing, inspect mount.cfg, dependency installation and Linux path capitalization.
  9. After changing collection membership or ID entries, restart the server and test a fresh client connection.

The dependable pattern is: configure Workshop content for the server, mount and start the map by its BSP name, then verify the separate client-download signal. Treating those as three checks makes it much easier to locate whether a failure is in server installation, map selection or player delivery.

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 quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

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.