October 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 PCOctober 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 Install Custom Addons on a Garry’s Mod Server

A complete Garry's Mod dedicated-server addon guide covering manual folders, Workshop collections, individual ID files, gamemode and map startup, client downloads and troubleshooting.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install a downloaded addon by placing its real top-level folder in garrysmod/addons/, then restart the dedicated server. Install Workshop content by supplying a public or unlisted collection ID with +host_workshop_collection, or by listing individual IDs in garrysmod/cfg/srcds_workshop_ids.txt on supported recent versions. Server mounting and client downloads are separate: players also need maps, models, materials and sounds delivered through Workshop resources or FastDL.

Choose the installation method first

Garry’s Mod supports two addon workflows. A loose addon gives you direct control over files and is the right choice for a downloaded ZIP, a privately edited addon or source-level testing. A Workshop collection lets the server fetch and update subscribed items at startup with less manual copying.

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.
Workflow What you provide Strength Main risk
Loose addon An unpacked addon folder under garrysmod/addons/ Exact file control, easy local edits and the ability to pin a known copy Manual updates and a greater chance of placing the folder one level too deep
Workshop collection A public or unlisted collection ID in the startup command Automatic download, mounting and (when configured) client Workshop delivery Items can change when authors publish updates, and a private collection cannot be fetched
Workshop ID file garrysmod/cfg/srcds_workshop_ids.txt with individual IDs Central list of items without maintaining one collection The list-file method is documented as new in Garry’s Mod version 2026.09.22 or newer; confirm support on the live documentation before relying on it

Do not combine the methods accidentally. If the same addon exists as a loose copy and a Workshop copy, remove one while diagnosing conflicts so you know which files the server is mounting.

Prepare the dedicated server

  • Stop the server before copying files or changing startup parameters. A running process can keep old Lua or map data in memory.
  • Back up the current garrysmod/ directory, or at least garrysmod/addons/, garrysmod/cfg/ and any custom Lua files. A backup gives you a clean rollback when an update introduces a conflict.
  • Locate the installation’s garrysmod/ directory. A normal dedicated-server tree contains that directory beside the server executable and Steam runtime files.
  • Keep every custom addon in its own folder. Do not overwrite the base game tree or merge unrelated addon files into one directory; the Lua-folder guidance associates those practices with conflicts and unpredictable behavior.

Install a downloaded, non-Workshop addon

1. Obtain and inspect the archive

Download the addon from a source you trust and unpack it locally. Open the extracted folders until you can identify the addon itself. The folder you copy should contain the addon’s content directories, not merely another ZIP file or a GitHub-generated wrapper such as project-main.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

An addon may contain any combination of lua, maps, materials, models, particles, resource, scripts and sound. Preserve the directories it actually uses. Empty directories have no purpose and can be removed.

2. Put the real top-level folder in addons

Copy the addon folder to:

garrysmod/addons/<addon_name>/

Facepunch’s addon-creation documentation describes the rule this way: “All Addons, even those downloaded from the Steam Workshop, start as a folder placed in the garrysmod/addons/ folder of the Garry’s Mod installation.” In practice, the final path should look like garrysmod/addons/my_custom_weapons/lua/..., not garrysmod/addons/my_custom_weapons/project-main/lua/....

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

Use a simple folder name made from lowercase letters, numbers, underscores or dashes where possible. Avoid spaces and punctuation that can make shell commands, backups or troubleshooting harder.

3. Restart and keep the copy isolated

Start the dedicated server again after copying the folder. Leave the addon in its own directory so you can disable it by moving or renaming one folder instead of editing shared files. If you change the addon while testing, restart before deciding that a Lua change failed; files loaded during startup can remain active until the process is restarted.

Install Workshop addons with a collection

1. Build an accessible collection

Create a Steam Workshop collection and add every required addon. Set the collection to Public or Unlisted. A private collection cannot be accessed by the dedicated server, even if you can see it while logged into your own account. Record the numeric collection ID from the collection’s Workshop URL.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

2. Add the collection to the startup command

Append this parameter to the command that launches the server:

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

+host_workshop_collection <COLLECTION_ID>

For example, a launch line that also selects a map can contain +map <map_name> +host_workshop_collection <COLLECTION_ID>. Keep the plus signs and parameter spelling exactly as shown. At startup, the server downloads or updates the collection and mounts the downloaded addons; the Workshop-for-dedicated-servers documentation describes this as downloading the collection at startup and mounting all downloaded addons.

3. Decide how updates should work

By default, the server checks the collection at startup. To disable those startup updates, use:

host_workshop_autoupdate 0

Disabling updates can help you hold a tested content set, but it also leaves old map or addon versions in place. The documented warning is significant: stale content can prevent players from joining. If you pin updates, schedule a deliberate maintenance check and test the resulting files before changing the live server.

4. Restart and read the console

Restart after changing the collection ID or its visibility. Watch the startup console for Workshop download and mount messages. An error there usually points to an incorrect ID, inaccessible collection, Steam connectivity problem or an item that has been removed. Do not treat a successful server boot as proof that every client file was delivered; client distribution is a separate configuration step described below.

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.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Use srcds_workshop_ids.txt for individual Workshop items

Recent Garry’s Mod documentation describes a list-file approach in garrysmod/cfg/srcds_workshop_ids.txt. The documented structure groups IDs under a named block:

"my_workshop_addons" { "1" { "wsid" "123277559" } "2" { "wsid" "111412589" } }

Create the file manually with the same braces and quoted keys, replace the example numbers with the Workshop IDs you need, and save it under the server’s garrysmod/cfg/ directory. Restart the server so it reads the list. This method is identified as new with Garry’s Mod version 2026.09.22 or newer; version behavior can change, so check the current Facepunch documentation when deploying or upgrading a server. If your build does not recognize the file, use the collection parameter instead.

Start a gamemode or map supplied by an addon

Select the gamemode folder

Use the folder name, not the display name shown in a menu:

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.

+gamemode <folder_name>

The dedicated-server guide defines this name as the gamemode folder under garrysmod/gamemodes/ or under an addon’s gamemodes/ directory. For a Workshop gamemode, read the exact folder name in the item’s description or ask its author. A title such as “City Roleplay” may use a folder such as darkrp; only the actual folder name works.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Select the map without the extension

Set the map with:

+map <map_name>

Use the BSP filename without .bsp. For example, write +map rp_downtown, not +map rp_downtown.bsp. The map must be mounted and available to the server before the level change; if it comes from Workshop, include that item in the collection or ID file.

Apply a changed setting

Change the startup command, then fully restart the process. If you alter the map or gamemode while the server is already running, issue a level change or restart after confirming the new setting; otherwise the old map or gamemode can remain active for the current session.

Make custom content download to players

Mounting an addon on the server and delivering its assets to clients are different jobs. The server can load Lua and still leave players without a map, sound, model or material. Symptoms include a map-download failure, invisible props, checkerboard textures or missing sounds.

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

Workshop delivery

For Workshop-hosted content, add the item ID in server-side Lua with:

resource.AddWorkshop("WORKSHOP_ID")

Use the numeric ID of each Workshop item that clients must have. Put this call in a server-side Lua file loaded by your gamemode or addon, and include every dependency that is not already guaranteed by the main item. The server’s Workshop collection parameter handles server mounting; the resource call tells clients what to obtain.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

Non-Workshop files

For files you host yourself, use resource.AddFile or resource.AddSingleFile in server-side Lua to mark the required paths. Match the path and capitalization used inside the addon. Marking a file does not create an Internet download location; clients still need a server download route.

Choose a download route

Route Configuration When to use it Important limitation
Workshop resource.AddWorkshop("WORKSHOP_ID") The asset is published on Steam Workshop and should be obtained by clients from there Every required item must be listed; server-side mounting alone is not enough
Built-in server download Mark files with resource.AddFile or resource.AddSingleFile and enable sv_allowdownload 1 Small sets of files or a simple setup without a separate web host The built-in path is slower and still requires correctly marked files
FastDL Place files on a separate web server and set sv_downloadurl Larger custom-content sets where faster client downloads matter The web server is separate from the game server; its directory must mirror the downloadable file paths

Use one deliberate delivery plan and test it with a fresh client. A player who already has an asset cached can hide a missing resource declaration, so test with content removed or on a machine that has not previously joined the server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Verify that the server found and mounted the addon

Check the directory before checking the game

  • Confirm the addon folder is directly under garrysmod/addons/.
  • Open the folder and verify that lua, maps, materials, models, particles, resource, scripts or sound are at the expected level.
  • Remove an extra archive or wrapper directory if the content tree is one level too deep.
  • For Workshop content, confirm the collection is public or unlisted and that the numeric ID is correct.

Use the server console

After startup, run:

path

The command lists active search paths. Look for the addon or Workshop-mounted path in the output. Workshop startup messages also indicate which addons were mounted and which content was made available to clients. These checks prove discovery and mounting; they do not prove that every optional client file has reached every player.

Test the actual feature

Join with a client and exercise the addon: spawn its entity, use its tool, load its map or enter its gamemode. Test both a client that already subscribed to the Workshop item and a clean client. A server can report a successful mount while a client still lacks one dependency.

Troubleshoot the common failure modes

Symptom Likely cause Fix
The addon does not load at all The folder is nested inside a ZIP or GitHub wrapper, or it is outside garrysmod/addons/ Open the extracted tree, move the folder containing the real content directories directly into addons/, then restart
A Workshop addon is absent Wrong collection ID, private collection, misspelled parameter or Steam Workshop connectivity failure Check the numeric ID, set the collection to Public or Unlisted, verify +host_workshop_collection exactly, and inspect startup errors
The server loads it but players see a missing map, material or model Server mounting was configured without client delivery Add the Workshop resource declaration, mark non-Workshop files with resource.AddFile or resource.AddSingleFile, and configure built-in downloads or FastDL
The selected gamemode fails +gamemode uses a display name instead of the folder name, or the gamemode is not mounted Find the exact folder under garrysmod/gamemodes/ or the addon’s gamemodes/ directory, then restart
The selected map fails to change The BSP extension was included, the map item is not mounted, or the startup setting was never applied Use the filename without .bsp, ensure the map addon is downloaded, and restart or change level after correcting the command
Everything worked until an addon update Two addons now define the same files, or Workshop auto-update introduced an incompatible version Disable or isolate folders one at a time, review the update setting, and restore the last known-good backup or pinned copy
The ID file appears ignored The server version predates the documented list-file feature, the path is wrong or the syntax is malformed Confirm the build supports the feature, place the file at garrysmod/cfg/srcds_workshop_ids.txt, check braces and quoted keys, or fall back to a Workshop collection

Operate addons safely after installation

Separate content from configuration

Keep addon folders, server configuration and client-download declarations organized separately. This makes it possible to identify whether a failure comes from discovery, Lua execution, map mounting or download delivery instead of changing several systems at once.

Control update timing

Automatic Workshop updates are convenient for active projects but can change behavior between restarts. If reliability matters more than immediate updates, use host_workshop_autoupdate 0, retain a tested copy and update during a maintenance window. Re-enable updates when you intentionally want the latest collection content.

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

Retest dependencies, not just the headline addon

An addon may depend on separate models, materials, sounds or libraries. Test the complete feature on a clean client after every content change. A successful path result confirms that the server can search the mounted files; it does not validate optional dependencies or the client download list.

A repeatable installation checklist

  1. Stop the dedicated server and back up its custom directories.
  2. Choose loose files, a Workshop collection or the supported Workshop ID file.
  3. For a loose addon, remove wrapper folders and place the real addon directly under garrysmod/addons/.
  4. For Workshop content, make the collection Public or Unlisted and add +host_workshop_collection <COLLECTION_ID>, or create the documented ID file on a supported build.
  5. Set +gamemode and +map only after confirming the exact folder and BSP names.
  6. Configure client delivery with Workshop resources, built-in downloads or FastDL.
  7. Restart, inspect startup messages and run path.
  8. Join with a clean client and test the map, gamemode and every important asset.
  9. If something fails, isolate one addon or dependency at a time instead of editing the base game tree.

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.

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.