Logistics reference

From Hearts of Iron 3 Wiki
Revision as of 19:07, 4 July 2013 by Meneth (talk | contribs) (Updated version template)
Jump to navigation Jump to search

This article describes the logistics system in HoI3, focusing on the mechanics of supply depots, the supply network, and supply throughput. For strategic advice on logistics, visit the Logistics strategy article. Note that the Semper Fi expansion adds a new, optional game mode called "Arcade" where the entire supply system is circumvented. In this game mode, supplies are simply drawn directly from a national stockpile.

Supply Depots

Supply depots (aka "supply sources" or "supply centers"), are a physical location on the map where a nation's supplies are automatically stored. All supplies created for the national stockpile are either stored in supply depots, in transit in the supply network, or are actively consumed by units. In this sense, the supply counter in the main screen toolbar is only an abstract aggregate: there is no single national stockpile.

  1. Every country has a primary supply source located in its capital.
  2. The overseas supply source for any territory not connected to a nation's main land is a port.
  3. Supplies are automatically distributed from the supply source to all core national provinces with IC.


Apart from supply sources, any province that has received more supplies than the units in that province used will temporarily store these supplies. Thus, these supplies can be captured if the province is captured. After a short period of time, any provinces with surplus supplies (other than a supply depot) will send them back to a supply depot along the supply network. There is no throughput cap on supplies heading back to the center, and no supply tax.

Supply Network

The game has one principle supply network method used for transporting supplies on land and overseas:

  1. All units draw supply by requesting it from the province they are located in.
  2. If a province cannot supply a local unit, it will request supply from an adjacent province:
    1. The first province asked will be the one located closest to the supply source.
    2. Every other adjacent province will be asked if a previously asked province cannot provide supply.
    3. If one adjacent province cannot meet the total supply need, multiple adjacent provinces may be used.
    4. Each province between the requestor and a supply source will carry the request for supplies forward, aggregating other supply requests as appropriate.
    5. Supply moves one province per day.

Manual Control

There are three ways for a player to manually manipulate the supply network:

  1. Transport planes: While transport planes are very expensive, carry limited supplies, and generally require air superiority, they can surgically augment areas with supply problems.
  2. Convoys: AI control of convoy creation and destruction can be turned off, allowing a player to manually create convoys.
  3. Supply re-route: Starting in Semper Fi, it is possible to create sea convoys to improve the supply flow to areas already connected via land to the supply depot (Lenningrad and Vladivostock: in addition to a land connection, can also have a sea connection). This can happen so long as the provinces involved are separated by at least 10 provinces.

Supply Map

The supply map effectively shows that the supply network is not a static network, but instead a constantly changing network based on unit needs. Thus, this map mode is a snap shot in time, not a comprehensive view of what your supply network might be capable of in different circumstances.

  • Green shows it is receiving all of its requested supplies and every unit is in supply.
  • Blue shows a supply surplus.
  • Black shows zero supply, zero requests
  • Brown shows province has a supply deficit: demand is higher than throughput. Effected by infrastructure level, terrain, or tech level.
  • Red hatching shows limitation being imposed on the infrastructure.
  • Red shows demand draw is greater than required, province may or may not have supply, throughput is zero.

For more details, view this post by potski on the HOI3 forums explaining the supply map and many intricacies and implications of supply draw.

Allies & Puppets

When units are in an allied nation, supplies will be drawn from the allied supply network. Meanwhile, an automatic and invisible trade route will be created between the two nations, where the exact amount of supplies and fuel will be sent from the nation with its troops abroad to the allied nation hosting those troops. As a result of this system, supplies, fuel, or resources cannot be transferred through a puppet or ally. For example: consider that Japan is fighting near Beijing and has existing supply through north-eastern ports in China. Japan will not get supplied through Manchuoko by the Korean supply network. Note also that the "transit rights" agreement is only applicable to unit movement and stationing, and does not have a bearing on supplies.

Supply Throughput

There are several factors that limit the distribution of supplies:

  1. Infrastructure: The supply throughput a province can funnel depends on its infrastructure (see below for details).
  2. Supply Tax: Moving supplies costs a base tax of 0.1 supplies (decreased by Supply Transportation techs) per province moved through.
  3. Port Size: For overseas supply sources, the size of the port (each level equals 4 supplies) limits the amount of supplies that can be convoyed.
  4. Air Base Size: Each level can support 4 supply units. Thus, a level 10 airbase can supply 40 air wings maximum.
  5. Partisan Activity: Partisans will disrupt your supply in any province with partisan activity, decreasing your supply throughput.

Supply Throughput can be improved through the following methods:

  1. Supply Transportation research reduces the supply tax per province.
  2. Laws can also affect supply throughput. Mixed Industry gives 5% bonus to throughput while Heavy Industry gives a 10% bonus to throughput.
  3. Less draconian occupation policies will decrease partisan activity and improve supply throughput in occupied territory.
  4. The Army Group HQ will improve logistics by 5% based on each skill level of its commander.
  5. Building new infrastructure will increase the throughput of that province.
  6. Building IC in a core province without IC will create a new supply source and possibly improve nearby supply distribution.

Effect of Infrastructure

The exact workings of the supply system are not fully known. Maximum throughput has been determined to be:

4 * (1 + modifiers) * OAC * infra²


  • infra is a number between 1 and 10. The infrastructure percentage gets divided by 10 and rounded down to a whole number. So a province with 29.9% infrastructure and one with 20% both have an infra of 2.
  • OAC is 2 if the province is Owned And Controlled by the same nation, otherwise 1.
  • modifiers are given by ministers, technology and strategic effects.

This was tested in a "linear" situation, that is a non-branching path of provinces. Maybe this limit is averaged over 2 days. It is unknown what happens when paths branch and merge.

Due to the quadratic dependence, it is more efficient to build up a single supply path to level 10 infrastructure than to have several paths at lower level, though there is also the strategic weakness of being vulnerable with only one supply path.

Ports and Supply Convoys

Wherever possible, a supply route will be created over land instead of a sea route. This is true even when the land route may be much longer than a sea route (e.g. when wrapping around the Mediterranean Sea, for example). In Semper Fi, it is possible to avoid this problem and manually route supplies via the sea.

Ports: Overseas supply functions with an origin port and a receiving port. The most efficient origin port is a national core province with IC, thus acting as a supply depot, with high infrastructure and port level. While an origin port can theoretically send an unlimited number of convoys, a receiving port overseas can only receive one supply convoy and send out one resource convoy. Manually trying to game the system and make two supply convoys by ticking the appropriate boxes does not work. The supplies an overseas port can receive is limited by port level, with 4 supplies per day per port level. A level 10 port can thus receive no more than 40 supplies per day which can, for example, support about 15 infantry divisions with artillery. Therefore, large overseas forces require more ports in areas linked to your port ( = more possible supply convoys) or supply them by air.

Supply Convoys: Supply convoys use a number of transports equal to the length of the route (measured in terms of sea provinces) in order to operate at maximum capacity for the receiving port (determined by port level, as described above). Starting in Semper Fi, if units overseas need more supplies than the local supply depot can provide, additional supply convoys can be sent to other overseas ports. This will not create new supply depots overseas, but these will overcome the bottleneck introduced by the port size of the supply depot. Thus, all additional ports opened will funnel supplies to the local supply depot, which will then disperse supplies as needed.

Lack of Supplies

Every unit has a 30 days reserve of supplies and fuel. If there are not enough supplies available, it will begin consuming that reserve and you will notice the out-of-supply-icon warning you that this unit is beginning to draw on its reserve. The unit immediately suffers from a reduced combat effectiveness, with a penalty induced relative to your reserve level. For example, with 20 days supply left (66%), the unit will suffer 50%*(1-(66/100)) = 16.7% combat penalty.

If the 30-day-reserve is completeley exhausted, a unit will no longer be able to move. The penalties then are:

  1. -50% combat modifier
  2. Can not move
  3. out of fuel = slower movement (only applies if you have still have supplies)
  4. you do not get reinforcements or upgrades

Units out of supply will not reinforce, regain organization or upgrade, hence attrition will occur resulting in a strength loss. Combined with tactical bombing, this can reduce the strength of any fortified province to be enable an assault. Note that different units draw varying levels of supplies. Infantry will always draw less supplies than motorized divisions, for example. When strategically redeploying units, supply draw is doubled.

Research that effects supply

  • Large Front: reduces supply consumption -0.1
  • Guerrilla Warfare: reduces supply consumption -0.1
  • Airborne Warfare Equipment: reduces supply consumption -0.1 (paratroopers only)
  • Supply Transportation: each level reduces transfer cost by .01
  • Supply Organization: each level increases throughput by .05
  • Port Efficiency: Base supply per port level is increased up to 25% (e.g. each level base can support 5 supply)

Modding Supply

Due to issues some players have with constraints in the supply system, simple modifications can be made to the game's text file to change the way supply is handled. In the "Defines.Lua" file in the Common folder, the following variables are key:

  • SUPPLY_TAX = 0.1 [the additional cost per "node"]
  • MUDDYNESSSUPPLYTAXMODIFIER = 0.25 [additive to Supply tax for provinces in muddy conditions]
  • OWNED_AND_CONTROLLED_THROUGHPUT_CAP_BONUS = 2 [Maximum bonus possible for throughput in a nation's controlled provinces]
  • INFRA_THROUGHPUT_IMPACT = 4, [Number of supplies that can be moved per infrastructure level]
  • SUPPLYPOOL_DAYS = 30 [Number of days a unit has local supply stocks without needing the supply system]


  • A supply network cannot draw supplies from another supply network. It can only draw supplies from a naval base which is supplied by convoy from the capital. Ports do not have to be in supply to provide supplies to a convoy but they do have to be connected via land to the capital.
  • Units carry supplies with them. As the units advance the local supply stockpile also advances. Thus units can start a campaign with 30 days of supplies and march through poorly supplied areas until that stockpile runs out.
  • HQs consume supplies. Higher HQs could remain further away, and still be in range of the Divisions. As the front advances, then this is less likely, and you need to make a decision between the combat and other advantages provided by the HQs, and the limited supplies. Adding Corps to the hierarchy (which is generally seen as a "good thing") actually adds to your overall supply consumption in an offensive. In some countries, the supply usage of a large force, say an Army Group, may be increased by 10-20% by all of the HQs. It is probably not a good idea for some countries to create Corps HQs as they need to remain close to the front and consume supplies that might otherwise go to the combat Divisions.
  • Supply/resources can only travel once across water, not counting straits. Supply will sadly only trace from the depot. Putting more supply in other ports will help supplying those port provinces but little else. It will flood backwards into the system when units move through though. Every non-contiguous to your capital area is consider "overseas" and will have it's own depot. This can be as small as a single hex island or as large an area as several land connected continents. The larger the area overseas, the more difficult it is to supply. An overseas supply depot is treated by the AI just like your capital meaning that all supply to the overseas area will try to flow from the depot to where it is needed.
  • While it is correct that the size of the departure port has no bearing on the outbound supply capacity, the infrastructure of the provinces between the capital and that port does affect supply throughput, as well as supply transfer cost for each province you move supplies thru. If at all possible, and not taking into account the vulnerability of a supply line being raided, you want to send supplies either directly from your capital or a hex adjacent to a capital (remember, all hexes adjacent to a capital have MAX throughput). In Italy's case this means manually using Civitavecchia as your outbound port is the optimal choice, as it is adjacent to Rome.
  • Supply received via trade is handled exactly like mineral resources. It is delivered directly to your capital, magically skipping across provinces. This happens each day BEFORE supply need is calculated. It is then distributed back into your supply network. Computer programming here, nothing happens simultaneously.
  • Same for supply created at your factories, it magically skips to your capital, with the following exceptions; If the factory is isolated it stays in the factory hex; and if the capital is isolated it stays in the factory hex. Once that determination is made supply will flow according to supply system demands, barring isolation.
  • Another thing that WILL screw up your supply is SRing a bunch of units. While your units may hop a train and move at warp speed to their destination, their supply won't. If you Sr a bunch of units into a region, it will take some time for supply to catch up. You should never ever strat-redeploy in areas where you have low supply and have divisions fighting. The redeploying units will carry off their own supply pool when they move (even if it means leaving the province dry for other units).
  • You can use transport aircraft to dump supplies as close as they can get along a supply route and they'll still be useful. They don't have to be dropped on the troops or an airfield or port for them to get in to the supply system. Anywhere on the route will do. Base them somewhere they have access to a decent amount of supply (supply depot if possible) and select the hex where you want supplies delivered. Watch them, though, as the AI will intercept them if it can.