/RimWorld-Macros

Primary LanguageC#GNU General Public License v3.0GPL-3.0

This mod allows you to create custom macros for automating frequent actions. For instance, you can create a macro that will make your colonists equip specified weapons and armor, pick up some items from storage and then go to a defensive position in your killbox. All in just two clicks.

USAGE

I. Creating macros

  1. Select a single colonist

  2. Queue up any number of jobs by Shift+Right-Click

  3. Press the "Macros" button. It should be located at the bottom of the screen

  4. Provide a name for your new macro. If you check the "Macro shared between colonists" the newly created macro will be available to all colonists, otherwise it will only appear for the currently selected colonist. Macro name needs to be unique, however non-shared macro name can appear for multiple different colonistssa.

  5. Press OK, your macro is now created!

II. Executing macros

To execute your macro simply Right-Click your Macros button. If you want to execute the macro for multiple colonists, there are four ways to do that:

  1. Right-Click on Macros button: it will find a macro with the specified name on all selected Colonists and execute it. If a selected colonist doesn't have a macro with that name, nothing will happen.

  2. Ctrl+Alt+Right-Click on Macros button: it will find a macro with the specified name on all colonists (both selected and not selected) and execute it. If a colonist doesn't have a macro with that name, nothing will happen.

  3. Alt+Right-Click: it will execute the selected macro on all currently selected colonists. It doesn't matter if other colonists have a macro with that name or not, it will always use the currently selected macro and ignore all macros on other colonists.

  4. Alt+Right-Click: it will execute the selected macro on all colonists (both selected and not selected). It doesn't matter if other colonists have a macro with that name or not, it will always use the currently selected macro and ignore all macros of other colonists.

III. Macro list

Right-Clicking a colonist that has at least one macro defined will show "Macro List" as an option. This list allows you to manage your macros. Available options allow you to:

  • Rename existing macros
  • Convert a pawn macro into a shared macro (and vice-versa)
  • Delete macros
  • Reorder macros
  • Copy-paste existing macros. This also allows you to paste copied macros onto other colonists when you open their macro list.

IV. Recommended mods

Steam Workshop: https://steamcommunity.com/sharedfiles/filedetails/?id=2631512949