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 DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk9 min

How to Add a Workshop Addon to a Garry’s Mod Server

Set up Garry’s Mod Workshop addons correctly with a startup collection, server-side client downloads, the newer srcds_workshop_ids.txt method, and fixes for common loading failures.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Adding a Garry’s Mod Workshop addon requires two separate configurations: make the dedicated server load the addon, then tell connecting clients to download it. Add +host_workshop_collection <COLLECTION_ID> to the server’s startup command for server-side loading. In a server Lua file under lua/autorun/server/, add one resource.AddWorkshop("<ADDON_ID>") line for every addon clients must receive. Servers running Garry’s Mod version 2026.09.22 or newer can also use cfg/srcds_workshop_ids.txt to list addon IDs.

What you need before adding an addon

Have the Workshop item’s numeric ID, access to the server’s startup command, and permission to edit the server files. The ID is the number in the item’s Steam Workshop URL. A collection has its own ID, which is different from the IDs of the addons inside it.

As an Amazon Associate I earn from qualifying purchases.

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.

Addon ID versus collection ID

Use an addon ID when you are referring to one Workshop item. Use a collection ID when you want the server to load all items grouped in a Steam collection. Do not substitute an individual addon ID for a collection ID in +host_workshop_collection; the startup parameter expects the collection identifier.

Check the server build

The newer cfg/srcds_workshop_ids.txt method is available on Garry’s Mod builds dated 2026.09.22 and later. If the server is older, use the startup collection parameter and the Lua download list instead. Check the build shown by your server before choosing the text-file method.

#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.

Method 1: load a Workshop collection at server startup

The official Garry’s Mod server configuration uses +host_workshop_collection followed by a collection ID. The server reads the collection during startup, downloads its contents, and mounts the addons it can load.

Step 1: copy the collection ID

  1. Open the Steam Workshop collection that contains the addons.
  2. Copy the numeric collection ID from the collection URL.
  3. Confirm that the collection contains the exact addons and versions you intend to run.

Step 2: add the startup parameter

Add this argument to the same startup command that specifies the game and server settings:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
+host_workshop_collection <COLLECTION_ID>

For example, the relevant portion of a startup command looks like this:

srcds ... +host_workshop_collection 1234567890

Replace 1234567890 with your real collection ID. Keep the plus sign, use no angle brackets in the final command, and place the argument on the command line used to launch the dedicated server rather than in a server-side Lua file.

Step 3: restart and watch the console

Stop the server completely and start it again. A restart is required for the startup argument to be read. Watch the startup console for Workshop download or mounting messages. If the server starts without any sign that the collection was read, recheck the command used by the service manager, panel, batch file, or shell script; editing a different launch shortcut does not change the command that actually runs the server.

Step 4: test the addon on the server

Join the server as an administrator and test the addon’s expected behavior. A collection being downloaded does not prove that every item is compatible with the current game mode or map. Test any entities, weapons, scripted tools, maps, or content that the addon is supposed to provide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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.

Method 2: make connecting players download the addons

Server-side loading and client delivery are separate. Loading a collection lets the server mount its addons, but it does not give you a reliable client-download configuration. Put each required Workshop item ID in a server-side Lua file with resource.AddWorkshop.

Step 1: create the autorun directory and file

Inside the server’s Garry’s Mod directory, create this path if it does not already exist:

lua/autorun/server/

Create a clearly named file in that directory, such as:

lua/autorun/server/workshop_downloads.lua

The filename can be different, but it must end in .lua and be inside the server autorun directory. Keeping all required Workshop entries in one file makes later audits easier.

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

Step 2: add one line per addon

Use the numeric Workshop item ID as a quoted string:

resource.AddWorkshop("1111111111")
resource.AddWorkshop("2222222222")
resource.AddWorkshop("3333333333")

The quotation marks matter because resource.AddWorkshop receives a string. Do not paste a full Workshop URL, a collection URL, or an unquoted number. Add one line for every addon that a player must have to see or use the server correctly.

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.

Step 3: save, restart, and connect with a clean client

Save the file, restart the server, and connect from a client that does not already have the items cached. The client should begin downloading the listed Workshop content while connecting. Existing subscribers may appear to download nothing because the files are already present; test with an unsubscribed account or a cleared local copy when you need to verify delivery.

Step 4: keep the list synchronized

Whenever you add or remove an item from the Steam collection, make the corresponding change in workshop_downloads.lua. Editing a collection does not update this Lua file automatically. A server can therefore mount a newly added addon while clients still lack it, or continue requesting an item that has been removed from the collection.

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.

Using cfg/srcds_workshop_ids.txt on newer servers

Garry’s Mod’s wiki documents a newer option for servers running version 2026.09.22 or later: create cfg/srcds_workshop_ids.txt manually and list the Workshop addon IDs in it. This file can be used instead of, or alongside, a Workshop collection.

Verify compatibility first

Do not create the file and assume an older server will read it. Confirm that the running dedicated-server build is 2026.09.22 or newer. If your host’s control panel reports only a branch name, check the startup console or update the server before relying on this feature.

Create and maintain the file

Create the cfg directory if necessary, then create:

cfg/srcds_workshop_ids.txt

List the addon IDs using the layout documented for your installed build, normally one numeric ID per line. Do not put collection names, Workshop URLs, or Lua function calls in this text file. Because this is a newer feature, follow the exact formatting example in the official wiki for the server branch you run.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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

Decide whether to combine methods

You can continue using +host_workshop_collection for a collection while maintaining individual IDs in the text file or Lua download list. Avoid accidental duplicates: keep a written inventory of which method supplies each addon and remove obsolete entries when you change the collection.

Which setup should you choose?

Setup Server loading Client delivery Maintenance Build requirement
+host_workshop_collection only Loads the collection at startup Not a dependable replacement for an explicit client download list Collection is easy to edit, but client configuration can drift Supported by the standard collection method
Collection plus resource.AddWorkshop Loads the collection Requests every listed addon for connecting players Two lists must be kept synchronized Works when the server supports the collection method and Lua autorun
cfg/srcds_workshop_ids.txt Reads individual addon IDs from the configuration file Use the Lua download list as well when clients must receive the files One ID list is straightforward to review; exact file syntax follows the installed build Garry’s Mod 2026.09.22 or later

For most established servers, the practical arrangement is a collection for server loading plus a server-side Lua file for client downloads. The newer text file is useful when you prefer to manage individual IDs without putting them in a collection, provided the server meets the version requirement.

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

Common failures and how to fix them

The server starts, but no Workshop addon appears

  • Check that the startup command actually contains +host_workshop_collection and the correct collection ID.
  • Confirm that you restarted the dedicated server after changing the command.
  • Look for a typo in the ID; one missing digit points to a different item or an invalid collection.
  • Verify that the process has permission to write its Workshop and addon directories.
  • Make sure you edited the launch script or panel profile that starts this server instance, not a dormant batch file.

If the collection is not being read at all, solve the startup configuration before troubleshooting Lua downloads. The two mechanisms fail independently.

Players join without required models, sounds, or entities

  • Open the server’s lua/autorun/server/ directory and confirm the download file is in that exact path.
  • Check that the file extension is .lua, not .lua.txt.
  • Confirm every call follows the form resource.AddWorkshop("ID"), with the ID in quotation marks.
  • Restart the server after editing the file.
  • Test with a client that does not already have the Workshop item cached.

An older issue report on the Facepunch issue tracker stated that +host_workshop_collection did not automatically make clients download every item. That report is old and may not describe current behavior, but it is a reason to retain explicit resource.AddWorkshop entries when the content is required.

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

A newly added collection item works for the server but not for players

Compare the collection with workshop_downloads.lua. The collection controls what the server loads; the Lua file controls the IDs requested from connecting clients. Add the new ID to the Lua file, save it, and restart the server.

The text-file method has no effect

First check the server build. cfg/srcds_workshop_ids.txt requires version 2026.09.22 or later. On an older build, use the collection startup parameter and Lua download file. On a supported build, verify the filename, capitalization, location under cfg, and the ID format required by that branch’s official documentation.

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.

Only some addons download

Compare every item ID against the Workshop URL and remove spaces or extra characters from the Lua lines. A collection can also contain an item that has been removed, made unavailable, or changed independently of your server configuration. Test each ID separately by checking whether the corresponding item appears in the client’s download activity.

The collection does not load at all

Check the collection’s visibility and ownership settings. Community guides commonly state that a server must be able to read a public or unlisted collection, but that visibility requirement is not confirmed here by a primary source and can change with Steam behavior. If changing visibility is not possible, use individual addon IDs through the supported text-file or Lua methods and observe the server console for the exact failure.

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

Maintaining Workshop content over time

Keep a single inventory

Record each addon’s name, Workshop ID, purpose, and the configuration method that supplies it. This prevents a collection edit from silently disagreeing with the Lua file and makes it easier to remove abandoned content.

Update in a controlled order

  1. Edit the collection or ID list.
  2. Update workshop_downloads.lua if clients need the item.
  3. Restart the server so it reads the new configuration.
  4. Check the startup console for download or mount errors.
  5. Join with a client that lacks the addon and verify the download and in-game behavior.

Remove obsolete entries

When an addon is retired, remove it from the collection and every individual ID list. Leaving stale entries can trigger unnecessary downloads, confuse troubleshooting, and make it unclear which content the server actually requires.

A reliable installation checklist

  • Identify the numeric collection ID and each individual addon ID.
  • Add +host_workshop_collection <COLLECTION_ID> to the real server startup command, if using a collection.
  • Restart and confirm that the server reads and mounts the collection.
  • Create lua/autorun/server/workshop_downloads.lua.
  • Add one quoted resource.AddWorkshop("ID") line for every required client addon.
  • Restart again and test from a client without cached files.
  • If using cfg/srcds_workshop_ids.txt, verify the server is version 2026.09.22 or later and follow that build’s documented file format.
  • Keep the collection, text file, and Lua list synchronized whenever content changes.

Why the two-step model matters

A Garry’s Mod server can successfully load an addon while a player still lacks the files needed to render it. Conversely, a client can download an item that the server never mounted. Treat server loading and client delivery as separate checks: the startup collection or supported ID file answers “what does the server load?”, while resource.AddWorkshop answers “what should connecting players download?” Configuring both sides is what produces a predictable connection and gameplay experience.

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
Windows Errors? Fix Them Before They SpreadFree repair 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.