Workshop Addon Creation (2023)

This article will teach you how to prepare and upload an addon to the Steam Workshop.

There are a few rules before you start uploading addons.

Please see this page for complete set of rules:Steam Workshop Rules

You can use alternative tools such as GUIs (graphical user interfaces) made by community members to create, extract and upload addons to Steam Workshop.

Links to such known tools: (feel free to expand)

Alternatively, the guide below describes how to upload addons to the Steam Workshop using Garry's Mod's shipped tools, gmad.exe and gmpublish.exe.

To upload an addon to workshop you will need the following things:

  • A folder anywhere on your computer containing addon files
  • A 512x512 .jpg icon for your addon.

If you're going to make your addon public, please make sure it's unique and will add something new to Garry's Mod. Don't upload addons you didn't make, even fixed versions, without the author's consent.

Folder with addon files

The structure of addon for Steam Workshop is the same as the classic addon system of Garry's Mod 12, except for those differences:

You addon folder structure must look somewhat like this: (below is just an example)


Here's all the folder names that your addon may contain, next to the addon.json file:

(Video) How to Create a Steam Workshop Collection

mapsbackgroundsgamemodesmaterialsluascenesmodelsscriptsparticlessound - This is not a typo, there is no 's' for sound folder.resource

my_addon is the folder you will need to input to gmad.exe or any other Workshop uploader and its name could be anything, addon's name is defined on the Workshop Page for that addon and NOT by the folder name.


Workshop Addon Creation (1)

Sample Addon is the folder you will need to provide to the gmad.exe to convert it to .gma.

Before uploading - test your addon

It is generally a good idea to do a final test of your addon before uploading it to workshop to make sure everything works properly.

Doing so is easy, simply put your addon folder (in this example it would be called my_addon) into the game's steamapps/GarrysMod/garrysmod/addons/ folder and load up the game.

The icon

This must be a 512x512 Baseline JPEG image ( Progressive JPEG or a PNG image will NOT work! ).If gmpublish.exe does not accept your icon, try reexporting it with Paint or Paint.NET, that should convert it to Baseline. The chroma must be 4:2:0, for instance Photoshop and GIMP can use 4:2:2 or 4:4:4, which are not accepted.

Do not use an image unrelated to your addon - this is stupid and will get your addon removed. Express your addon in image form.

Make it relevant to your addon. Please don't just stitch together something horrible in MS Paint. It should look good, otherwise you'll be making the workshop look dirty. Besides, who wants to download something that looks like a three-year-old made it?


When creating an addon the folder should have an addon.json - which looks like this..

{"title":"My Server Content","type":"ServerContent","tags":[ "roleplay", "realism" ],"ignore":["*.psd","*.vcproj","*.svn*"]}

(Video) How to upload a Garry's Mod Addon to the Steam Workshop [NEW]

title is the name of your addon.

type is the type of addon, one of:


tags is up to two of these:


Ignore is a simple wildcard list of files to ignore. You can have as many of these as you want - and they don't have to be wildcarded, they can be specific files.

For Windows, you can simply navigate to your GMad.exe in <STEAM LOCATION>/steamapps/common/garrysmod/bin and drag'n'drop your addon folder ( my_addon in this example'' ) onto GMad.exe.

GMad.exe will now create your .gma. It will place it to the same location where your folder is, with the same name.

Do not move GMad.exe anywhere!

Alternatively You can open the command prompt (cmd.exe), cd to the gmod bin folder

(<tt>cd "<STEAM FOLDER>/steamapps/common/garrysmod/bin"</tt>, include quotes), then enter the following command (including quotes):

gmad.exe create -folder "<FULL PATH TO ADDON FOLDER>" -out "<FULL PATH TO OUTPUT .gma FILE>"

(Video) Garry's Mod Addon Creator Banned, Then Spreads Goatse...

Windows users can also create a .bat file to automate this process:

"C:\Program Files (x86)\Steam\steamapps\common\garrysmod\bin\gmad.exe" create -folder %1pause

Just make sure to insert correct path to your GMad.exe.

Common Errors

[Files does not pass whitelist]

You have either dragged a wrong folder onto GMad.exe, your addon contains forbidden files or your addon has incorrect folder structure. See example above for correct addon folder structure and file whitelist.

Couldn't parse json

Your JSON file is missing or it is invalid. Use any JSON validators to find and fix errors.

There are multiple ways of doing that, we are going to cover only the most convenient way of doing this, if you are on Windows.

At this point you should have a .gma file and a .jpg file. For the sake of making this easy, rename both files to have the same name, for example my_addon:

  • my_addon.jpg
  • my_addon.gma

Next you want to create a .bat file somewhere and put these commands in the .bat file:

"C:\Program Files (x86)\Steam\steamapps\common\GarrysMod\bin\gmpublish.exe" create -addon "%~dpn1.gma" -icon "%~dpn1.jpg"pause

Save it as something like gmpublish_create.bat.

Once you got the .bat file ready, simply drag'n'drop your .gma or your .jpg onto that .bat file. It is essential that both files must have the same name.

Now gmpublish.exe will go through the process of compressing and uploading the addon to Steam Workshop.

(Video) How to Create Addons and Update them for Garry's Mod's Workshop

Once that process is completed, open your Garry's Mod Steam Workshop, go to "My Shared Files" ( You can also get there from your profile ) and change visibility of your addon to Public.

You are done. Your addon is now live. You can now change the title, description, images and videos for your addon.

Note that rules also apply to your title, description, images, icon and videos:

  • No questionable content
  • No racism or offensive language/material

Common Errors

Compression Failed

This is simple - your addon is too big. This is usually solved by downscaling your .vtf textures. Note that some video cards may not even support 4096x4096 textures! 1024x1024 or 512x512 are usually more than enough.

Make sure that if you are uploading a particularly texture-heavy addon that you use DXT5 texture compression. DXT5 is exponentially smaller than RGBA or BGRA, saving not only time downloading and uploading but cloud space.

Ran out of quota

If this happened to you, contact for help.

Addon has invalid type!

Your addon.json has the "type" tag set to an invalid value. You can see a list of allowed values above.

PublishWorkshopFile failed! (8)

This error happens when the addon.json contains invalid UTF-8 sequences. This happens if you use an upload script (.cmd, .bat, etc) that cannot create the addon.json with the UTF-8 character set. Please fix your addon.json by editing it as UTF-8 or use a title using only US-ASCII characters (latin characters with no accents).

This error only happens after the upload because the addon.json is packed inside of the sent GMA file.

PublishWorkshopFile failed! (9)

An icon must be provided.

PublishWorkshopFile failed! (X)

If you encountered an error with a number that is not listed on this page, you can find a list of all Steam related error codes on this handy website:

Please note - that website is not associated with Steam, Valve or Facepunch in any way, and may be incomplete.

(Video) Making a DarkRP server: Extracting Workshop Addons with Gmad cannot open shared object file: No such file or directory

This is an error that may happen on Linux when gmpublish fails to find its Steam API dependency. You can resolve this by copying the dependency from the game's bin/ folder to /usr/lib/, or by setting the LD_LIBRARY_PATH environment variable appropriately. See #4542 for more info.

Please make sure your addon isn't creating errors for people. If your addon is creating too many errors it will be removed.

You can learn how to update existing workshop addons in this article:Workshop Addon Updating


How do I add an addon to Steam Workshop? ›

For Windows, you can simply navigate to your GMad.exe in <STEAM LOCATION>/steamapps/common/garrysmod/bin and drag'n'drop your addon folder ( my_addon in this example'' ) onto GMad.exe. GMad.exe will now create your . gma. It will place it to the same location where your folder is, with the same name.

How do I extract a .GMA file? ›

Go to -/steamapps/common/GarrysMod/bin, copy "gmad.exe" (or just "gmad", depending on your settings), and paste it in -steamapps/common/GarrysMod/GarrysMod/addons, then drag and drop a gma file on top of it. This will create a folder with the same name as the gma file, containing the contents of it.

How do you add a GMOD map to the Steam Workshop? ›

How to upload & use Garry's Mod Workshop Maps on your server
  1. Find a map you would like on the Steam Workshop.
  2. Create a Steam Workshop Collection with your Map Mod.
  3. Add the Steam Workshop collection to your server.
  4. Inside gmod. ...
  5. Press Save at the bottom of the page and restart your server.

How do I add workshop content to my GMOD server? ›

Start the Steam Launcher, and click on the game you want to create a collection for. Here you can browse through collections created by other users, or start your own Workshop collection by selecting the blue "Create Collections" button on the right side of the screen.

Are NSFW mods allowed on Steam workshop? ›

They aren't allowed on workshop. PG only. You can use Nexus Mod Manager with Steam Workshop. You'll have to register with Nexus (which you have to do to download adult stuff anyway).

Is NSFW content allowed on the Steam workshop? ›

Not allowed. You are not to post ANY content that is against the Steam Rules of Conduct.

How do I convert GMA to VPK? ›

Just extract everything from the . vpk into a folder and drag that folder into gmad.exe.

How do you rip a GMod addon model? ›

  1. Create a new folder.
  2. Find the addon you want to extract and copy the gma-file in your folder.
  3. Drag the gma file on your gmad.exe shortcut. A command prompt run and the selected addon file should be extracted in a new folder, with the name of the extracted workshop addon.
17 Feb 2017

Where are GMod addons stored? ›

This could be different on any computer. However, it is usually under C:\Program Files\Steam . From this directory, navigate down two levels to [Steam Install Directory]\steamapps\common\GarrysMod\garrysmod\addons .

Does GMod use GPU or CPU? ›

Garry's Mod game details

The system requirements are low, so you'll only need a DX9 capable GPU and a 2GHz CPU. This physics playground is one of the best sandbox games on PC.

Is GMod OK for 9 year olds? ›

Yes Gmod is safe for kids. If you do not like blood, there are many addons that disable it.

What is the max map size for GMod? ›

There is no maximum map size, however the power and resources available to your PC will dictate how big your map can be before you notice a performance reduction.

Are GMod mods legal? ›

Putting it short, Garry's Mod runs Valve Games, but isn't owned by VALVE. Garry's Mod is owned by someone else (Thus the name " Garry's Mod") in which any textures from Valve Games ported from that BOUGHT game to Garry's Mod without the permission of the developers is ILLEGAL and counts as piracy.

How do you add FNAF to GMod? ›

How Do We Download FNAF? To download the Five Nights at Freddy's GMod game mode, like many other mods and maps for Garry's Mod, you need to “subscribe” to the addon on the steam workshop.

Where is the workshop mod ID? ›

In order to get the id of a workshop mod, go to its workshop site, and look at the last number of its URL. That's your mod's id. So for, the ID would be 1682700568.

Will Steam ban me for using WeMod? ›

We are not aware of any bans resulting from having WeMod installed. You should never use WeMod in any multiplayer game mode. If you have the ability to play the game offline, we recommend doing so for extra safety. We also recommend closing WeMod entirely before going into any online game.

Will Steam ban you for using cheat engine? ›

The VAC system reliably detects cheats using their cheat signatures. Any third-party modifications to a game designed to give one player an advantage over another is classified as a cheat or hack and will trigger a VAC ban. This includes modifications to a game's core executable files and dynamic link libraries.

Can you get banned for exploiting Steam? ›

You only get banned when you knowingly use a exploit in a online game to get a advantage. If you find out a exploit and report this and never use the exploit again, so long the exploit stays in the game, than you should not get banned.

Can a 12 year old play Steam? ›

Since the game requires kids to be at least 13, we agree – age 13 is the minimum. The App store rating is too low and we agree with age 13 only as long as parents are highly involved in the gaming, have stated their expectations about networking with strangers, and have enabled Steam Family View.

Are all games on Steam legal? ›

Valve is making a major change to how it decides which games are allowed on its platform: Going forward, all games are allowed on Steam.

How do you make VPKs? ›

VPKs can be created with the command line tool vpk.exe . The tool can be located in the bin folders for most Source games, such as the ones below. The tool is not game dependent, however it is suggested that you use the tool that corresponds to the game you are creating the vpk for.

Can you edit VPK files? ›

Its filename consists of a bunch of numbers. The VPK with the same set of numbers is the one you want, so cut+paste that into addons then unsubscribe from it on the workshop. Either way, find the VPK you want to edit and double-click that biznatch. Drag and drop the "root" folder wherever you want (I recommend addons).

Does Florida have virtual VPK? ›

Using the proven teaching methods and curriculum used at Pacesetter Academy, combined with the Florida State Standards for the VPK age group, Online VPK gives parents the resources necessary to ensure their child is ready for Kindergarten.

Is there anti cheat in GMod? ›

Description. Must have. Leys Serverside AntiCheat (LSAC) is the final Anti-Cheat for gmod you will need! It offers a clean and sleek user-interface.

How do you clean dead bodies in GMod? ›

Hold C, click where it says NPC and then click "Keep Corpses". Now when you spawn a new NPC and kill it, you should be able to delete the corpse by clicking Z.

What does Garry mod do? ›

Garry's Mod is a physics sandbox. There aren't any predefined aims or goals. We give you the tools and leave you to play. You spawn objects and weld them together to create your own contraptions - whether that's a car, a rocket, a catapult or something that doesn't have a name yet - that's up to you.

Is GMod a real game? ›

Garry's Mod is a 2006 sandbox game developed by Facepunch Studios and published by Valve.

What is the max addons for GMod? ›

The current limit seems to be 4096.

Is GMod 2 a thing? ›

"It's not going to be Garry's Mod 2," Garry Newman writes in the game's About page. "My hope is that it will eclipse what is possible in Garry's Mod rather than simply be a modern version of it." It seems it'll be a good while yet before we get our hands on s&box, mind.

Can 4gb RAM run GMOD? ›

My old laptop had 4gb ram a 2.00GHz and Intel HD and gmod ran fine on medium settings will it be the same for my new pc? It should be fine. Older Source-based games tend to do fine on most machines. Edit: Just make sure you can run DirectX 9 and you're good to go.

Is 64 bit GMOD better? ›

100% recommend it. Improves performance including loading and addons should work fine. 64 bit= twice the calculations, twice the application processing power.

Can GMOD run on 8gb RAM? ›

The minimum memory requirement for Garry's Mod is 4 GB of RAM installed in your computer. If possible, make sure your have 8 GB of RAM in order to run Garry's Mod to its full potential. Provided that you have at least an Intel HD 3000 graphics card you can play the game.

Are 10 year olds allowed Roblox? ›

On Roblox, certain safety settings and parental controls are enabled by default for children under 13. However, you should still review the settings to ensure they've been set up correctly. Not all games on Roblox will be appropriate for your child.

Does Roblox allow 7 year olds? ›

What age rating is Roblox? Roblox is rated suitable for 7 years and over in the UK by PEGI for "frequent scenes of mild violence and scenes that younger children may find frightening." The game is aimed at 7-to-18 year-olds, but anyone can use the platform.

Can a 7 year old have Roblox? ›

There is no official age that kids can play Roblox, but Common Sense Media rates the platform safe for users 13+ "based on continuing challenges with problematic content.

How much ram should I allocate to GMod? ›

Having 2 cores and 4 GB of RAM is a minimum to ensure satisfactory load speeds. However, if your project expands, you will need to allocate more resources.

Can GMod run on 2GB ram? ›

Try it, but make sure you aren't using anything else or have your settings too high. i have a 2GB ram and the game is realy fine can play online call on skype and even navigate with steam navigator!

Are Minecraft mods legal? ›

Basically, Mods are okay to distribute; hacked versions or Modded Versions of the Game client or server software are not okay to distribute. Within reason you're free to do whatever you want with screenshots and videos of the Game.

Is Garry's mod violent? ›

Violence: The game is derived from half-life 2 a bloody, violent, and gory mess of a game. There are multiple kinds of enemies and gun you can shoot, and yes there is blood, lots of blood.

Can you get viruses on GMod? ›

Luckily, unless you received the 'virus' from a bad Lua module, it is impossible for it to have infected other files in your computer. GMOD's Lua engine does not allow the file I/O functions to write or read outside of the Garry's Mod folder.

Can a 7 year old play FNAF security breach? ›

It's rated 12+, so it's not quite suitable for many preteen players. That said, the series forgoes the blood, gore, and violence typically associated with the horror genre in favor of innocent (if still pretty terrifying) shocks.

Why was FNAF 6 Cancelled? ›

It's all moot anyway, he told fans, as he has been forced to cancel the game in progress. Speaking in his update on 'the project,' the series creator cited mounting pressure as the biggest reason behind his decision.

Is FNAF security breach ok for 11 year olds? ›

This game has received a PEGI 12 because it features moderate violence to fantasy characters and scenes of moderate horror that younger players may find disturbing. Not suitable for persons under 12 years of age.

Can you download Steam Workshop mods without game? ›

Do I need to own the game that the mod is made for? Yes. Mods alter or add to the game they're created for, so you must have that game in your Steam library to utilize them.

Can you mod Steam games? ›

The central hub for downloading mods is the Steam Workshop. Login to Steam in a browser or your Steam Client, navigate to the workshop and subscribe to mod. The mod will be automatically downloaded.

Can you mod grounded? ›

To have more control of their Grounded experience, players can install mods. Mods allow players to add or remove features from Grounded and tailor the game to their own playstyle.

How do I manually add AddOns? ›

Once you locate your AddOns folder open it up. Go to your the Zipped AddOn file and open it. Select all the files in the Zipped File, and drag and drop the AddOn's folders from the zip into your _retail_\Interface\AddOns folder. Make sure you do not drop them into a folder of an AddOn already installed.

How do you add mods to workshop? ›

Run SCS Workshop Uploader tool from your steam client.
  1. Select the game that is compatible with your mod.
  2. Select New from the dropdown. ...
  3. In the Mod data section - browse for your mod data folder. ...
  4. If you select folder, browse for mod preview image.
  5. In next step fill mod name.
  6. Select mod visibility in steam workshop.

Can you manually install Steam workshop mods? ›

Open your favourite webbrowser and go to the Steam workshop page. You don't need to be logged in to view the workshop. Next, browse to the mod you like to have, and copy the URL from the top bar. Select 'No Extraction' & 'Direct URL', paste the URL of the workshop item and download the mod.

How do I add AddOns to a build? ›

Prepare to Install Kodi Addons on Builds
  1. Launch Kodi and this is the home screen you see with Element Reborn Build. ...
  2. Select System.
  3. Now, click System Settings or System on the list of options.
  4. Select Add-ons on the left side of the next window. ...
  5. Click Yes to continue.
5 Sept 2022

How do I install non Workshop Add-ons? ›

Installing Non-Workshop Addons on your Garry's Mod server
  1. Download the add-on you wish to install to your computer.
  2. Extract the add-on by right-clicking the ZIP file and select Extract All from the menu that appears.
  3. Identify that add-on folder.

How do I install an addon in SAP? ›

Installing the ABAP Add-On
  1. On a machine from which you can access the SAP Server, insert the SAP Interfaces installation DVD.
  2. Navigate to the folder \\ABAP Add-on\Installation.
  3. Navigate to the subfolder ECC6, and copy the . ...
  4. On the SAP Server, paste the copied file into the folder \\usr\sap\trans\eps\in.

Can friends see your workshop mods? ›

This is the place where you upload your games or download them for free. You can make your mods available to the public, for your friends only, or completely hidden where only you can see them.

Why are my workshop mods not working? ›

Opt-out of Steam Beta Programs. Many users reported that the Steam Workshop not downloading subscribed mods issue occurs when accessing the Steam Beta too frequently. So, you can opt out the Steam Beta and re-subscribe to the mods to fix the issue.

Do workshop items update automatically? ›

Yes, as long as you added the mod with its ID through ARK WebInterface, it will then be automaticly updated.

Do Steam workshop mods install automatically? ›

The central hub for downloading mods is the Steam Workshop. Login to Steam in a browser or your Steam Client, navigate to the workshop and subscribe to mod. The mod will be automatically downloaded and updated.

How do you install mods without Minecraft? ›

  1. Make sure your Minecraft client is closed.
  2. Press the Windows Key (Start)
  3. Type in %appdata% and press enter.
  4. Open the . minecraft folder and then enter the mods folder.
  5. From here, just drag in the mods that you wish to add.
  6. Open Minecraft again and click Play, and the mods should now be loaded.
23 Mar 2022

How do I download mods on Steam without an account? ›

How to download Steam Workshop mods without a steam account
  1. Visit the Door Kickers steam community website at
  2. Copy the link to the steam mod you wish to download from the URL bar, for example ... =
18 Sept 2014

Does titanium build still work? ›

Update: Titanium Build is no longer available. Please try one of the other available builds from our list of Best Builds for Kodi. 5. Select the input box under Enter a name for this media source.

How do I install an addon pack in minecraft? ›

Go to the Settings app and select Storage > Explore (at the bottom). If you do not have a settings app, you can install a file explorer app like ES File Explorer. Select the directory where you saved the file, usually "Download". Select the file & the Add-On should open in Minecraft.

How do I add addons to my repository? ›

How do I install addons from the Kodi repository?
  1. From Kodi's home screen, click Add-ons in the list on the left-hand side.
  2. Click on the box icon in the top-left of the screen.
  3. Select Install from repository.
11 Sept 2022


1. How to Create and Upload Gmod Workshop Addons! BEST WAY!
2. Engineer's Workshop Tutorial - FTB Beyond - Mods A to Z
3. How to upload a Garry's Mod addon to the workshop
(Jackwebb1112 “Jackwebb1112”)
4. TUTORIAL Total Tank Simulator Unit Creator Update
(Plastic Scot)
5. Fastest Way to Upload a Garry's Mod Addon To Workshop - 2021 - Windows - NEW
6. [Workshop Recording] Test Automation Addons Ninja Workshop
Top Articles
Latest Posts
Article information

Author: Tish Haag

Last Updated: 12/21/2022

Views: 6123

Rating: 4.7 / 5 (47 voted)

Reviews: 94% of readers found this page helpful

Author information

Name: Tish Haag

Birthday: 1999-11-18

Address: 30256 Tara Expressway, Kutchburgh, VT 92892-0078

Phone: +4215847628708

Job: Internal Consulting Engineer

Hobby: Roller skating, Roller skating, Kayaking, Flying, Graffiti, Ghost hunting, scrapbook

Introduction: My name is Tish Haag, I am a excited, delightful, curious, beautiful, agreeable, enchanting, fancy person who loves writing and wants to share my knowledge and understanding with you.