0 of 0

File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

About this mod

SMM provides an easy way to add custom menus and makes said menus automatically disappear on uninstall (without breaking your build menu!)

Permissions and credits
Settlement Menu Manager provides a safe, easy way to add custom categories to the settlement menu. As a user this means you can install SMM enabled mods without worrying about ending up with a broken build menu should you choose to uninstall them.

Are you a mod author? Skip down to the Author Section.
User FAQ:
Q: If I install SMM can I still use mods that set their own menus up?
A: Yes. SMM is designed to play nicely with other mods.

Q: If I install this does it mean that I can install/uninstall anything without worrying about menus disappearing?
A: No, you will still need to run the uninstaller for any mod which is not using SMM.

Q: If I want to stop using SMM can I just disable it? (Can SMM uninstall itself automatically?)
A: No, it isn't actually possible for a mod to automatically clean up after itself once it has been uninstalled. In order to properly uninstall SMM you will have to activate the "Safe Mode" feature SMM has, save, close your game, and then remove it from your load order. Obviously, uninstalling SMM will break any mod that relies on SMM.

Q: What is "Safe Mode" and how do I enable it?
A: Safe Mode temporarily removes everything that SMM has added to the build menu. The next time you load your game or open and close the build menu everything will be re-added. To activate Safe Mode run the Settlement Menu Manager Holotape that was added to your inventory when you installed SMM and select "Enter Safe Mode".

Q: A non-SMM enabled mod broke my build menu. Can I use SMM to fix it?
A: Yes, select the "Settlement Menu Rescue" option in the SMM holotape. It will scan through the build menu and remove every invalid category/menu (without clobbering the valid ones).  If that didn't work see additional details below:

Q: Can I use SMM with SKE?
A: Yep.

Q: Where should I put SMM in my load order?
A: Anywhere should be fine.

Q: I can't find the holotape after installing SMM, how do I get it?
A: This is a known problem that happens when installing SMM before exiting the vault on a new game. To get the holotape via console follow the instructions in the spoiler below.

Q: I have a mod whose menu isn't showing up for me, how do I fix it?
A: The most common problem is a broken workshop menu from incorrectly uninstalling a mod that requires an uninstall chem. Try running the Settlement Menu Rescue option from your holotape.  If that didn't work, there is a more involved step you can try next:

Have a question that wasn't answered here? PM me or post it in the comments!

Author Section:
If you're the author of a mod which adds things to the build menu with a script it is pretty much a given that you've seen at least one bug report like this:
I tried your mod and now my menus are gone! You broke my game! HELP!

-- every user who forgot to run your uninstaller
Ok, maybe they didn't yell, but you get the idea. Sooner or later someone will either not read the instructions or simply forget to follow them. At this point they have two options:

  1. Reinstall your mod, run the uninstaller, and then disable it again.
  2. Install one of the menu fixer mods floating around and restart the game a few times.

Kind of a pain, right?

SMM makes the uninstall happen automagically. When you register your menus with SMM it remembers the plugin that added each menu. If it ever notices that the plugin was removed (that is to say the mod was uninstalled) it will remove them.

How to add SMM support to your mod:

  1. Create a quest and check "Start Game Enabled"
  2. Attach SettlementMenuManager:MenuInstaller.psc to it.
  3. Set the PluginName, ModName, and Author properties on the script.
  4. Add a struct for each menu you want SMM to add to the game. The ModMenu value in each struct needs to be either a keyword or a formlist. TargetMenu is where SMM will put your menu.

Alternatively you can simply copy the quest from SMM_Example_Plugin.esp and change properties as in steps 3 and 4 above.

Once you have done that you will want to add the following (or something like it) to your mod description:
This mod uses Settlement Menu Manager to add custom settlement menu categories. This means that you don't need to worry about running a special holotape/chem before you uninstall it: just remove it from your load order and you're done.
In addition to a notice, it would probably be a good idea for you to add SMM as a requirement on your mod page.

For mod authors needing more hands on help adding SMM to their mod we now have a tutorial in the Files tab made by Whisper/Bionicyardiff which covers making menus in general and adding SMM specifically.

Author FAQ:
Q: Can't I just include your code in my mod and not depend on my users installing SMM?
A: No! The whole point is having a separate, always installed bit of code that does everything. If each mod tried to do that they'd end up stomping all over one another.

Q: How many menus can my mod add using SMM?
A: As many as you want; however, there is a global limit of 1024 custom menu categories. I can increase this if necessary, but I can't imagine a situation where you'd need more.

Mods using SMM:
Are you using it too? Send me a PM or drop a comment to let me know!
Like most of my mods, the full source of SMM is available on GitHub.

Special thanks to kinggath who was nice enough to make a logo for SMM.
Additionally, without timtimman I might never have came up with the workaround code for enabling more than 128 submenus in each menu.