Subscribe to download
Caravan Formation Improvements

A few features that should help forming/managing a caravan.

• Change the caravan formation spot: Essential if your caravan needs to load stuff from stockpiles that are not close to each other. Let them load stuff at a spot, then switch the spot.
  This can be done either while being in the "form caravan" dialog (new button "set a spot" at the bottom, next to "send") or per gizmo.
  
  
• Select a exit spot: Sometimes you may want your caravan to exit at a specific spot
  This can be done either while being in the "form caravan" dialog (new button "set a spot" at the bottom, next to "send"), per gizmo or per building "exit spot".
  
  
• Select a arrival spot: Select a spot for your caravan where it should enter the map.
  This can be done when you are on the world map and tell your caravan to enter a settlement/temporary map (the map needs to be created already). The dropdown menu will have a new option called "enter at specific spot". Or per building "arrival spot".
  
  
• Pause the caravan formation: Helpful when the caravan can not safely exit the map or when your pawns need to get their mood improved before leaving.
  This can be done per gizmo.
  
  
• Leave immediately: Mostly everything is loaded, but one unnecessary item on the other side of the map is missing. Your pawns are close to a mental break. Just tell them to leave now.
  This can be done per gizmo.
  
  
• Next caravan member: Clicking on that gizmo will jump to the next caravan member and select it. Hovering is pointing to every caravan member.
  This can be done per gizmo.
  
  
• Rope on arrival: If set to true, animals will be roped on arrival if they would not otherwise. So if there is no available pen, instead of running free, the mod tries to bring the animals to a hitching spot. If that fails, it will rope the animals to the ground. Mod default is true.
  Mod setting.
  
  
• Rope when caravan gets paused: If set to true, animals roped by a pawn are roped to the ground instead of running free when the caravan formation gets paused. Mod default is true.
  Mod setting.
  
  
• Distance to next ropeable animal: When roping a animal, pawns check if in the radius of 10 cells there is another animal to rope. Mods default is 20 cells.
  Mod setting.
  
  
• Maximal animals to rope at once: When gathering the caravan animals, pawns can collect 10 animals at once. You may want to increase that number. Mods default is vanilla.
  Mod setting.
  
  
• Cancel caravan confirmation: If set to true, there will be a confirmation window if you click the vanilla gizmo "cancel forming caravan". Mod default is true.
  Mod setting.
  
  
• Dont add newborns to caravan: If set to true, animals that are born during caravan formation are not automatically added to the caravan which leads to all animals getting unroped.
  Mod setting.
  
  
• Mod defines exit tile: If set to true, the mod defines on which side of the map the caravan will be spawned on the world map.
  If you are heading to the north, but set the exit spot for this caravan to be south, the caravan should be spawned south of your map on the world map.
  Mod setting.
  
  
• Default caravan arrival/exit spot: Mod setting to enable/disable. Priority for defining the arrival/exit spot of a caravan is as following: Manually selected spot per caravan > exit/arrival spot building > vanilla.
  
  
• Pawns respect their assigned zone when formation is paused: Mod setting. Disabled by default.
  
  
• Downed pawns and ropeable animals are brought simultaneously to the exit spot: Mod setting. Disabled by default.
  
  
• Gizmos can be disabled: There is a section in the mod settings to disable the ones you do not need.

Performance should be absolutely no problem, since mostly all of the code runs only once when you use one of the gizmos or when a caravan leaves/arrives at a map.
I checked the impact using "Dubs Performance Analyzer", but please tell me if you experience otherwise!


When the caravan includes downed pawns and you change the exit spot when they are already brought to the map edge, the downed pawns will be automatically removed from the caravan.
Furthermore there seems to be a vanilla bug where it might happen that downed pawns are left behind at the map edge when the caravan leaves the map.

Roping on arrival: Animals are getting roped to the spot where they entered the map if there is no pen/hitching spot, but pawns assigned to handling will try to unrope them. So make a hitching spot or a pen before they do so, so the animals are brought there.

Not every gizmo can be used at all times. If you can not use them at the moment, they are disabled (greyed out).

• Probably not compatible with mods that do the same/something similar.
  I am only aware of "Caravan Journey Spot" by leeh and "Caravan Entry Spot" by Cocock which are doing something similar and are probably incompatible.
  
  
• There is a patch for Boundary Training by Owlchemist integrated so that animals that have learned 'boundaries' will not be roped to the ground.
  
  
• Vehicle caravans introduced by Vehicle Framework by Smash Phil:
  You can use both mods, but my mod only applies to the vanilla caravans.
  
  
• Tell me if you find something else.

Please dont tell me "it does not work".
Tell me which feature did not work in which circumstances, post a hugslib log and, if possible, tell me how to recreate the problem/error.


Should be absolutely no problem. You may get a red error after removing which is harmless.


Source of the mod is included.

Credits and Thanks to:
Ratzinger for beta testing and giving feedback.
Brrainz for Harmony.
Dubs for Dubs Performance Analyzer.
Marnador for the RimWorld font, used in the preview pictures and for the gizmos.
Tynan and Ludeon for RimWorld. Some of the textures/parts of the previews are modified versions of vanilla textures.

License [creativecommons.org]