This guide explains everything you need to install GMOD addons properly:
Workshop collection setup
Linking Collection ID
Manual .gma installation
Fixing addon conflicts
Performance optimization
Common problems and solutions
What is an addon?
Installing addons via Workshop
Creating a Workshop collection
Linking the Collection ID
Manual addon installation
Addon conflict issues
Performance optimization
Addons to avoid
Common errors
Recommended hosting
Addons are extra features added to GMOD such as:
Jobs, money systems
Roleplay systems
HUD & UI improvements
Vehicles & models
Maps
Lua scripts
They are essential for customizing your server.
Workshop is the most stable and recommended method.
Benefits:
✔ Automatic updates
✔ Easy syncing for players
✔ Reduces crashes
✔ Cleaner management
Steps:
Open GMOD Workshop
Click Create Collection
Enter title + description
Add addons
Save
The ID is in the URL:https://steamcommunity.com/sharedfiles/filedetails/?id=3234567890
ID: 3234567890
Edit:
garrysmod/cfg/autoexec.cfg
Add:
Then add Steam API key to server.cfg:
For private or non-workshop addons:
Download .gma file
Place it into:garrysmod/addons/
GMOD will load it automatically.
Most server crashes come from addon conflicts.
Symptoms:
Lua Panic
Console errors
Missing textures
Crash on map load
Fix:
Disable addons one by one
Remove duplicates
Delete corrupted scripts
Check console logs
Recommended addon count:
DarkRP: 50–120
Sandbox: 30–80
TTT: 20–60
Avoid overloaded collections.
Do NOT use:
Leaked / cracked addons
Old LUA scripts
Heavy, unoptimized maps
Abandoned addons
→ Wrong collection ID
→ Player doesn't download workshop
→ Map not on server
→ Broken addon
→ Missing dependency
→ Script errors
GMOD requires strong single-core performance.
Very high FPS
Low latency
NVMe Gen4
Full DDoS protection
Ideal for DarkRP & Sandbox