Mandate Manager

— ATTENTION —
This mod needs DFHack to be installed. You can simply get it here (https://store.steampowered.com/app/2346660/DFHack__Dwarf_Fortress_Modding_Engine/)

Tired of creating new orders for endless nobles’ mandates again, and again, and again… ?
This tool will help you a little with this problem.

What this mod is offering to you:

• Separate screen where all mandates are displayed with all needed information: who, what, how much, time left.
• The most important thing: the button that will create an order with the needed amount — just select the material you want.
• Function to save the last selected material and use it in the future. If you save the material, instead of ‘Create order’, it will be your saved material. ‘Make leather quiver’, for example.
• Orders with already saved choices could be created with just one click!
• You can manage all your saved choices: change them, delete, or override from the Mandates Manager window by Ctrl+Click.
• Remembering the state of created orders, so you won’t create the same order for one mandate twice.
• A little automation! After saving a choice, you can turn automation on, and all future mandates with the same item will be created automatically.
• Notifications and statistics about your beloved automation 🙂

To open the Mandate Manager, you need to open the ‘Nobles and administrators’ screen and then press Ctrl+m or the button ‘Open Mandate Manager’.

Once every half game day, the script checks for new mandates, and if the type of the item in the mandate is marked for automation, it will create an order based on your last saved choice.
In other words, to activate automation, you need:

• Wait for the mandate to appear.
• Create an order for it through Mandate Manager screen.
• Save your choice for this order on Material Selector screen.
• Open Saved Choices and Automation screen.
• In the row with your saved choice, press the toggle Auto create.

That’s it! When the new mandate arrives, the automation will handle it for you and notify you that the order was successfully created.
The only thing you need to keep in mind, that the script is running once per half game day. So the order could be created with a little delay after the mandate bothered you.
It’s not perfect, but at least it won’t consume a lot of resources when running only every 600 ticks. You can imagine that the Mandate Manager just needs time to react like every dwarf does 🙂

This mod is not perfect (in the way of realization too :)), so there are things I want to add here in time:

• Possibility to remember the last selected type of order (for example, forge iron war hammer). Done in 1.1.0
• Possibility to create orders automatically based on the last remembered choice or with the cheapest available material.
• First part completed in 1.2.0
• Track the status of created orders. Partially done in 1.1.0
• Track already existing orders to see if they could match a mandate. Track them as well.
• Integration with Alert Manager, to open Mandate Manager or create an order right from notifications.
• Probably this integration will be replaced with Mandate Manager’s own overlays.

• The state of orders created by dwarfs with apostrophes in the name (or any other ó symbols) won’t be loaded correctly. Looks like it saved/loaded wrong by DFHack 🙁

Q&A

Q: Can I enable this mod in the existing save?
A: Sure thing, it will be automatically activated when you install/subscribe.

Q: I can create several orders for the same mandate. Is it ok?
A: For now, yes. The mod saves the created order but does not track it, so this possibility is left in case the user removes the already created order.

Q: I accidentally (or not) removed the order created by automation, but the new order is not created, though the automation is turned on for this type of mandate.
A: This is normal behaviour. The automation has already processed this mandate, so it won’t process it a second time even if the created order was removed. In the matter of code, the automation knows nothing about the orders. Maybe I’ll add the possibility for automation to handle such a scenario, but not for now.