Garry's Mod

Garry's Mod

32 ratings
How to Use: Modest Map Manipulator
By lime
A guide for how to use Modest Map Manipulator, a tool that lets you edit map entities and place new ones while playing in any gamemode.
It covers both basic and advanced topics and provides examples of its uses.
2
   
Award
Favorite
Favorited
Unfavorite
The Interface
Using the interface is quick and easy. The best way to do so is to bind a key using the console.
  1. Open the console using the tilde( ~ ) key. Look under your "ESC" key.
  2. Type "bind mouse3 +mmm" (without quotes) and press enter.
This will bind your middle mouse button, which you may already have bound, so here are some other keys you may use instead of "mouse3":
  • "mouse4" or "mouse5" - Extra buttons on some(but not all) mice.
  • "alt" - Your left ALT key. Normally it is used to walk slowly.
  • "g" - Your G key. It's often used to spray images.
  • Any programmable buttons you may have on your mouse. Use the included software and set one of them to PAGE UP or PAGE DOWN and then bind the "pgup" or "pgdn" keys ingame.
Once you have the key bound you may press the button at any time(except while in the main menu) and access the interface. To keep it from closing, click on the bar up top or bind a key instead to:
  • mmm_cl_toggle
Object Permanence
Probably the most important feature to you is the ability to spawn new props or edit existing ones and have your changes persist between restarts. Unlike other addons, this can be done while playing any gamemode. A toolgun or physgun is not required.
  1. Open the addon's interface.
  2. Right click on what you want to save. (such as a prop you've spawned)
  3. Press "Make Permanent" in the context menu.
  4. Make any other changes you want(disable collision, set color, and so on).
  5. Click "Save" at the top left of the interface.
To prove that your changes were made permanent you can open the interface, click "Commands", and then click "Cleanup Map". This will auto-load the map's default state.

NOTE: If Editor Mode is enabled, auto-loading is disabled. Disable it or press "Load" to test.
Removing Entities
Along the way you may find something that you prefer were not there. It may be a button that does something to bother your players. It may be clutter that eats up framerates. It could even be something you find offensive. Whatever it is, if it's an entity then we can get rid of it. Permanently.

There are two ways of doing this. The first way is the Context Menu, but this only works on entities that exist on map start, which doesn't always apply. The second way is the Entity Blacklist.

Context Menu
  1. Right click the entity while the interface is open.
  2. If it's an on-start map entity, you'll see "Auto-Delete". Press it.
Entity Blacklist
  1. Right click the entity while in the interface to get its name. Click to copy.
  2. Click the "Commands" button at the top left, then "Open Blacklist".
  3. Paste or type the name at the bottom and then press "Add".
  4. Make sure to press "Save" before your progress is lost.
The blacklist is a way to make sure anything which spawns with a certain name - at any point - will be immediately removed. It is particularly useful when getting rid of NPCs, like in HL2.
The Entity List
The Entity List is a way to edit or remove any entity, even ones that only exist on the server or have no collision so you cannot click on them, such as traitor buttons in TTT. It is also a way to get the name of those entities so that you can add them to the blacklist.
  1. In the interface, click on "Commands" and then "Open Entity List".
  2. Navigate to the class of the entity(such as ttt_traitor_button) and click it.
  3. Click through the entities and use "Look At" until you find the one you're looking for.
  4. Press "Auto-Remove" to get rid of it permanently, or "KeyValues" to edit those.
  5. Make sure that there's a "(P)" next to it, to show that's it's persistent. Press "Persist" if not.
Spawning Props
Spawning props is no longer something you can only do in the Sandbox gamemode. Now you can spawn any model anytime, anywhere.
  1. Open the interface and click on the "Tool" button at the top left.
  2. Press "Prop Spawner" and then press R to open the model menu.
  3. Navigate to the model you want to spawn and click it.
  4. Then click on the spot in the world you want to spawn it.
Spawning Entities
Weapons, NPCs, entities from the workshop.. now included with every gamemode.
  1. Open the interface and click on the "Tool" button at the top left.
  2. Press "Entity Spawner" and then press R to open the entity selector.
  3. Type in the filter box or click on the columns to order the entries.
  4. Click on the line of the entity you want to spawn.
  5. Then click on the spot in the world you want to spawn it.
You can also type in exactly what you want to spawn, but only if you know what you're doing.
Moving Objects
So you've spawned your props and entities. Now it's time to put them into place.
  1. Open the interface and click the "Tool" button, then "Grabber".
  2. Left-click on something to start dragging it around.
  3. Hold E and press your movement keys to rotate its pitch and yaw.
  4. While holding E, you can also use your mousewheel to roll it.
  5. While holding E, hold SHIFT to snap the prop's angles.
  6. While dragging an object, press your right mouse button to freeze it.
  7. To make sure it never moves, right-click it and press "Freeze".
The Grabber can move things that the physgun is blocked from moving. If you move something on accident you should use the "Reset Position" button in the right-click menu.
Copying Data Files
While you can make changes live on your multiplayer server(if you have one) as people are playing, you may instead want to make these changes in singleplayer and then put them on your multiplayer server. Or you may just want to keep your data safe by backing it up.
  1. Press "Save" in the interface to create the data file.
  2. Go to the this folder on your computer:
    garrysmod/data/mmm/maps
  3. On your server, navigate to the same folder.
  4. If those folders don't exist then you must create them.
  5. Select the map file(s) you want to copy over and upload/paste.
Unless you are hosting the multiplayer server on your own computer then you'll most likely be logging into an FTP server. Log in to your server's control panel and it should teach you how to do so. If not then use Google or contact tech support.

Having trouble finding the garrysmod folder?
  1. Press "Library" at the top left of the Steam window.
  2. Find "Garry's Mod" then right click it and press "Properties".
  3. Press "Local Files" and then press "Browse".
Get the Addon
If you don't yet have it and this all sounds good to you, go ahead and get it here:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2966527753
32 Comments
>KB> >KEKSQUAD 22 May @ 6:31pm 
Hey so I'm pretty sure the map file isn't automatically loading; is there a way to get that going?
TooManyCharacter 20 Apr @ 12:16am 
Is it possible to make a door retain its locked attribute after a map reset?
Epik Berm 13 Aug, 2023 @ 3:26pm 
Roger that, if I notice this persisting I will report it ASAP. Thanks for the help! :lunar2019wavingpig:
lime  [author] 13 Aug, 2023 @ 3:22am 
I used both the toolgun weld and the MMM weld and they properly attached to both walls and objects when loaded. Alternatively you could use the "Freeze" state if the walls don't move. It's possible that your physics are loading too slowly which would prevent constraints, like maybe if you have too many objects. That's mostly an engine bug. They should normally save.

As for entities not belonging to you not saving, the code does not check for ownership, and I am unable to reproduce that issue. Try it again with just a few props and let me know if that really is an issue.
Epik Berm 12 Aug, 2023 @ 10:31pm 
No I manually went around the map ensuring each of them were perma'd (the auto mark was discovered). I'm unsure how but upon closer examination it just seems the last save was not.. saved, so everything simply didn't save, not sure why that was.
While I'm at it, I can't tell if welding is also saved when using this, as we put a lot of things on walls and they seem to just drop down on load up, but other things seem to be fine.
lime  [author] 12 Aug, 2023 @ 5:57pm 
If you want other users to have their changes saved then you should mark their props as permanent yourself, or have them be superadmin and enable "Auto-Mark Spawned" in settings through the interface according to this guide.
lime  [author] 12 Aug, 2023 @ 5:52pm 
It should save whatever has been marked as permanent(manually) by superadmins.
Epik Berm 12 Aug, 2023 @ 4:23pm 
Does this not save other player's content? Made a map with friends and only my props saved.
Cider 1 Jul, 2023 @ 6:59am 
Thanks
lime  [author] 1 Jul, 2023 @ 3:39am 
If flags are not being loaded then Editor Mode is most likely turned on, which prevents auto-loading of data. Pressing "Load" or turning it off should fix that.
Props with the "Freeze" flag should always remain frozen, while simply "freezing" it with the physgun/grabber won't.