Simple Addon Manager II

| Enable or disable multiple addons at once | Add tags to your addons | Easily cleanup your addons |

Tired of the slow and annoying addon manager included in Gmod? Here comes and easy to use and efficient alternative that allows you to handle even large addon collections.

About

Have you ever been annoyed by Garry's Mod's Addon list? Have you ever tried to clean up your 100+ addons by uninstalling them one by one? Do you wish you could categorize them to easily enable and disable different play styles?

You just found the solution!

Getting started: Download & Installation

This mod requires a manual installation and it will overwrite 1 file from your Garry's Mod installation.

1. Click here to download the latest release.[github.com]
   
2. Either extract the ZIP-Archive to your Garry's Mod main directory (where the HL2.exe file is located: <your Steam dir>\SteamApps\common\GarrysMod)
   
3. You will be prompted to overwrite "menu.lua". Be sure to confirm the dialog.

You can also manually copy the files "menu.lua" and "lf_simple_addon_manager.lua" to
<your Steam dir>\SteamApps\common\GarrysMod\garrysmod\lua\menu

If your menu.lua is already modified you can also just add the following line to the end of the file:

include( "lf_simple_addon_manager.lua" )

CAUTION:
If you run "Verify game files" in Steam, you'll have to reinstall this mod. The same goes for some Garry's Mod updates.

Please do not ask for a Workshop upload. GMA addons can NOT change Garry's Mod's menu code. Therefore, this mod CAN NOT and WILL NOT be uploaded to the Workshop!

Getting started: How to access

While in the Garry's Mod main menu (you must NOT be connected to a server / in single player), open the developer console (F10 by default) and type in:

addons

If your console is not enabled, click on Options -> Advanced -> Enable developer console. Also make sure, that "Toggle Console" is binded to a key.

Overview: Selecting your addons

The majority of your screen will show your addons. Each entry will look like this:

• Top-Left: Name of the addon (can be changed)
  
• Top-Right: Unique workshop ID (or 0 for manually installed gma files)
  
• Bottom-Left: List of tags that you can add to your addon
  
• Bottom-Right: Addon type (set by author on the workshop)
  
• Checkbox: Shows if the addon is currently enabled

Line operations:

• Clicking anywhere on the line will select the addon for further operations. Selected lines will be highlighted in blue.
  
• Unlike previous version, clicking on another line will not deselect the previous line. This allows for comfortable selection.
  
• You can hold SHIFT to multi-select addons.

You can see how many addons you have currently selected at the top left of the toolbar:

• Select All:
  Clicking this button selects all addons which are currently visible in the list. If all of them are already selected it will deselect all. Addons currently not shown due to applied filters will not be (de-)selected!
  
• Undo Selection:
  This will deselect all addons regardless of any filter.

CAUTION:
Always keep an eye on your selection counter! Remember, that currently hidden addons can still be selected and will not be deselected by the "Select All" button. If in doubt, use the "Undo Selection" button to start over!

Overview: Using filters

If you have many addons you might want to filter them for easier selection. This tools are available:

Available options:

• Sorting
  By default your addons are sorted alphabetically. You can also sort by your tags you have given your addon as well as showing the enabled addons on top. No matter what you choose, there will always be correct sorting regardless of capital letters.
  
• Type Filter
  Here you can choose to show only a specific addon type. That's the same function you can find on the Steam Workshop website, with the options: Gamemode, Map, Weapon, Vehicle, NPC, Tool, Effects, Model, Entity, ServerContent.
  
• Search
  You can search for any addon by entering it's name. You can enjoy an advanced search function that will search as you type, ignore capital letters and allow you to find multiple words that are not in conjunction.

Things to consider:

• When you have found multiple addons that fit your criteria, click on "Select All" to quickly work with them.
  
• Selected addons stay active regardless of the filter. You can easily search for one addon, select it, search for another and add that one to the selection too.
  
• Don't forget you can reverse select too! If you want to apply something to all but a few addons, simply click "Select All", filter your addons and deselect them one by one or "Select All" again to only deselect those currently filtered.

CAUTION:
Don't forget addons you have selected before you applied any filter! Any operations such as enabling/disabling and uninstalling will affect all selected addons, not those currently filtered.

Overview: Using tags

While the filters are a confident way to find single addons, using tags is the real meat of the Simple Addon Manager. On the right side of your screen you will find this:

Line operations:

• Clicking anywhere on the line will select the tag for further operations. Selected lines will be highlighted in blue.
  
• You can hold SHIFT to multi-select tags.
  
• The checkbox allows you to filter addons. Once at least one checkbox is clicked, only addons that have those tag will be shown.

Adding and removing tags:

• Create new tag
  First of all, you will need to have some addons selected. Take advantage of the filters to find them!
  Once you're ready, enter the name of the new tag into the text field. Press enter or click on "Create new tag" for tag to be created.
  • Once you have created a new tag, it'll show up in the list below the buttons.
• Add tags
  This button allows you to add existing tags to your addons. Select one or more tags from the list below like you would do with the addons. Those tags selected will be highlighted in blue. Finally click the button and your changes will be applied.
  
• Remove tags
  Same as before, but this will allow you to remove one or more tags from the selected addons.
  • Tags which are no longer on any addons will be removed from the list.

CAUTION:
Unlike version 1, the selection will not be removed after performing any action! If you want to perform further actions on different addons / tags you must undo the selection first! This applies to both addons and tags.

CAUTION:
Always keep an eye on your selection counter! Remember, that currently hidden addons can still be selected and will not be deselected by the "Select All" button. If in doubt, use the "Undo Selection" button to start over!

Overview: Enabling / Disabling Addons

The core functionality of the Simple Addon Manager is to provide an easy way of toggling your addons in order to reduce loading times and prevent conflicts.

CAUTION:
Makes sure you have read and understood how selecting and tagging addons work, before you perform any batch operations detailed here.

Toggling addons by selection:

1. Select any addon you want to toggle from your list so that they are highlighted in blue.
   • Take advantage of the filter function for easier selection.
     
   • Don't forget that hidden addons keep their selection. Look at the counter!
2. Click on the "Enable Selected" or "Disable Selected" button to perform the desired action.

Toggling addons by tags:

1. Select as many tags as you want from your tag list so that they are highlighted in blue.
   • It doesn't matter if you have any addons selected.
2. Click on the "Enable by Tag" or "Disable by Tag" button to perform the desired action.
   
3. All addons that have one or more of the selected tags will be effected.

CAUTION:
Unlike version 1, the selection will not be removed after performing any action! If you want to perform further actions on different addons / tags you must undo the selection first! This applies to both addons and tags.

Overview: Addon Names and Details

You might notice that some addon names are incorrect or weird. That's because the Simple Addon Manager doesn't download the titles from the Workshop (that would be just as slow as the default Gmod manager) but instead reads the title from the .gma files metadata. Unfortunately some addons author didn't enter proper names there, so you might end up with "Test", "MyAddon", "abc" or other crap.

Right-clicking on any addon will provide some additional tools:

• Open Workshop
  The easiest way to get more information is to open the workshop page of the addon. Clicking this button, will open it in the Steam Overlay.
  
• Copy URL
  Your're Steam Overlay is disabled? No problem. Use this button to copy the addon's url to your clipboard and paste it into a web browser of your choice.
  
• Copy ID
  This copies the addon's unique ID to your clipboard. For example, you can use it to search for the .gma file in your Garry's Mod's addon folder.
  
• Add custom name
  You have an addon with a weird name? Use this function to change it's name. Simply enter the new name and click OK.
  • Both the sorting as well as the search function will use your new name.
    
  • The original name will still show up in curly braces and is still searchable.
• Remove custom name
  This will remove an existing custom name.

Overview: Advanced functions

Want to have an easy way to clean up your addons? Look no further! You can find additional options by clicking on the "More" button.

Enable / Disable All

Using those option will simply perform the selected action on every addon, regardless of any selection or filters.

CAUTION:
Makes sure you have read and understood how selecting and tagging addons as well as performing batch operations on them work, before you try any options detailed here.

CAUTION:
All of the following option can not be undone!

Uninstalling addons:

1. Select any addon you want to uninstall from your list so that they are highlighted in blue.
   • Take advantage of the filter function for easier selection.
     
   • Don't forget that hidden addons keep their selection. Look at the counter!
2. Click on the "More" -> "Uninstall Selected" button to perform the desired action.
   
3. You will be prompted with a confirmation dialog that will show the number of affected addons. This is your last chance to check if the number is right!
   
4. Confirm your action. You might have to wait a few seconds before the button becomes available.
   
5. Wait for the operation to be completed. Depending on your computer's speed and the number of addons this may take a while.

CAUTION:
Always keep an eye on your selection counter! Remember, that currently hidden addons can still be selected and will not be deselected by the "Select All" button. If in doubt, use the "Undo Selection" button to start over! YOU MIGHT LOOSE YOUR ADDONS!

CAUTION:
Unlike version 1, selected addons are not automatically unselected after enabling / disabling them! Make absolutely sure you don't have any addons still selected from previous actions! YOU MIGHT LOOSE YOUR ADDONS!

Liking addons:

Show the authors of your favorite addons some support and give them a LIKE! Now it's possible without any efforts.

1. Select any addon you like from your list so that they are highlighted in blue.
   • Take advantage of the filter function for easier selection.
     
   • Don't forget that hidden addons keep their selection. Look at the counter!
2. Click on the "More" -> "Give LIKE to Selected" button to support the creators.
   
3. You will be prompted with a confirmation dialog that will show the number of affected addons.
   
4. Confirm your action.

Uninstalling addons:

1. Select any addon you want to uninstall from your list so that they are highlighted in blue.
   • Take advantage of the filter function for easier selection.
     
   • Don't forget that hidden addons keep their selection. Look at the counter!
2. Click on the "More" -> "Uninstall Selected" button to perform the desired action.
   
3. You will be prompted with a confirmation dialog that will show the number of affected addons. This is your last chance to check if the number is right!
   
4. Confirm your action. You might have to wait a few seconds before the button becomes available.
   
5. Wait for the operation to be completed. Depending on your computer's speed and the number of addons this may take a while.

CAUTION:
There is no way to "unlike" an addon, even manually on the workshop besides disliking it, which is not encouraged. Be sure you have the right addons selected!

CAUTION:
Always keep an eye on your selection counter! Remember, that currently hidden addons can still be selected and will not be deselected by the "Select All" button. If in doubt, use the "Undo Selection" button to start over! YOU MIGHT LOOSE YOUR ADDONS!

FAQs

• Is Version 2 compatible with old data?

  
  Yes. As soon as you start Garry's Mod for the first time after updating, your old savefile will be automatically converted to the new format.
  
  Please be aware that the new file is not compatible with version 1. The old file will be preserved but settings will no longer be synchronized if you keep using both versions.
  
  

• Can I backup my tags and custom names?

  
  Yes. Those are located under:
  <your Steam dir>\SteamApps\common\GarrysMod\garrysmod\data\lf_addon_manager\addons.txt
  
  Just make a copy of this file. Future version may provide an automatic backup function, but not for now.
  
  

• The addon name is not always correct!

  
  The name is taken from the .gma file of the addon, rather then downloaded from the Workshop, like the Gmod menu does. Unfortunately some lazy addon authors just put stuff like "My Addon" or "Test" in their addon.json files.
  
  I'm not going to download the information, since that would slow down my menu almost as much as the standard menu. If you want to know which addon that is, right-click on it choose "Open Workshop" to open it's Workshop page in your Steam Overlay (which must be enabled for this).
  
  Once you figured out which addon that is, you can change it's name by right-clicking and choosing "Add custom name". For more details, see the Addon Names and Details section.

Download

Although this mod has been tested on my Garry's Mod installation, I can not guarantee full functionality for every user. There might be bugs not found yet. As always, proceed on your own risk.

Version 2.0 now available for beta testing!

Please report any bugs you might find!

Latest Version: 2.0 beta

Download Now[github.com]

View source code[github.com]
You can report any bugs here or at the GitHub repository.

If you like this mod, please leave a rate or favorite this guide.
You can also check out my Workshop addons, available here.

[Reichstaube]

Make these modifications to add a "Open Addon Manager" button to the "Addons" section in main menu:

https://rentry.co/addonmanager-menu (external link because [code] tags are not supported in comments for some reason)

[:3]

jokes on you its tuesday

[colton]

WARNING! Carry on reading! Or you will die, even if you only looked at the word warning! Once there was a little girl called Clarissa, she was ten-years-old and she lived in a mental hospital, because she killed her mom and her dad. She got so bad she went to kill all the staff in the hospital so the More- government decided that best idea was to get rid of her so they set up a special room to kill her, as humane as possible but it went wrong the machine they were using went wrong. And she sat there in agony for hours until she died. Now every week on the day of her death she returns to the person that reads this letter, on a monday night at 12:00a.m. She creeps into your room and kills you slowly, by cutting you and watching you bleed to death. Now send this to ten other profiles on this one site, and she will haunt someone else who doesn't. This isn't fake. apparently, if u copy and paste this to ten comments in the next ten minutes u will have the best of your life.

[Pyrite]

Is there any chance this could be detected as a cheat by VAC?

[Gamyr]

This mod would be great on NexusMods. Any chance of hosting it there as well?

[Bamsy]

this still looks better than the offical one lol

[Demoham]

it wont work at all....
i tried everything
and nothing

[orangeninja27]

Are you able to update this mod?

[V92]

@korz

Tags can do that.

[krozbot]

any ability to have mod 'setups' where i can have certain sets of mods enabled/disabled and save those setups so i can swap between them depending what i'm gonna do in gmod? would be great for people who have thousands of addons like me