Efficiency

Efficiency is a metric used to help determine if your Villagers are being put to use in most effective way possible given the constraints of the game mechanics. The primary constraints that impact Efficiency are the production and consumption of Soup, the current rate of increase/decrease of raw materials, and the maximum storage capacities of your buildings.

An overview of your Efficiency is available in the Predicted Progress screen, accessed by tapping the resource icons in the top-right of the game screen. The floating tooltips above a working Villager will also alert you when a Villager is not currently working at 100% Efficiency.

### Efficiency Inputs

#### Soup, the Pumpkin Patch and Hunger

Soup is gained by assigning a Villager to work on a Pumpkin Patch, where they will harvest Pumpkins to convert into Soup at the Village Kitchen. A Pumpkin takes 80 seconds to harvest, and each Pumpkin converts to one Soup once it is then walked to the Kitchen (walking time is on top of the 80 seconds). The rate at which a Villager harvests Pumpkins can be increased by studying at the Farmers' Guild, or by the use of Potions of Farming.

Soup is consumed by any Villager that is assigned tasks in your Village such as building, resource gathering, crafting or researching. A Villager's hunger increases at a rate of 40% per minute of work, and once it reaches 100% they will walk to the Village Kitchen to consume Soup. Hungry Villagers can be assigned to the Pumpkin Patch without needing to consume Soup, as harvesting Pumpkins does not consume any Soup. A Villager's Hunger only increases during the time spent actually performing their assigned task. Hunger is not increased when walking between the Village Kitchen or a Storage building.

Soup can also be obtained by converting Food items stored in the Pantry. Different ingredients and foods convert to different amount of Soup, which can then be used to supplement a Villager farming Pumpkins. As such, if you have a surplus of Food, you can use this conversion capability to get more work done around your Village by having less (or even zero) villagers assigned to Pumpkin Patches.

#### Gathering, Crafting and Storage Capacities

With the exception of Research at the Study, all tasks that Villagers undertake can be grouped into those that produce resources and those that consume them. A Villager's Efficiency is calculated differently depending on which group the task it belongs to, though all tasks are impacted by the necessity of consuming Soup. For simplicity, the rest of this section ignores Hunger.

For tasks which only produce resources (including harvesting Pumpkins), a Villager's Efficiency is determined by whether there or not there is sufficient storage capacity available for the resource they are gathering. As long as there is storage capacity remaining to be used, that Villager's tooltip will be green and display the time until that resource's storages are full. Once at capacity, the Villager's Efficiency will drop to 0% and their tooltip will turn Red unless another Villager is currently working on something that consumes that resource. In that case, their tooltip will turn orange and display a reduced Efficiency score that factors in how long they have to wait for storage space to become available.

Building is the only Village task which **only** consumes other resources (besides Research which only consumes Soup), and Builder Efficiency is considered to be at 100% as long as there is either:

* More of the resource being consumed currently held in storage than is required to complete the building, or
* The rate at which the resource is being consumed is lower than the rate it is being produced

If one of these conditions are true, then the Builder's tooltip will be green and display the time until the building is complete. If storages of a required resource are depleted, then the Builder's Efficiency is determined by whether or not that resource is currently being produced by other Villagers. If not currently being produced, then the Builder's Efficiency is 0% and their tooltip will turn red and indicate what resource they need to start working again. If it is being produced, but the builder is using it faster than it can be produced, then their tooltip will turn orange and show a reduced Efficiency that factors in how long they need to wait for the resource to be produced and taken to storage for use.

Tasks that both produce and consume resources (i.e. buildings where other ingredients/materials are crafted) simply combine the above for the purposes of determining Efficiency. Accordingly, the Villager will show an orange/red tooltip when the input resources aren't available (at all or fast enough) or storage space isn't available (or becoming available fast enough). For example, a Brick Maker is impacted by there being Clay made available fast enough for Bricks to be made, the storage capacity of Bricks, and whether or not Bricks are currently being consumed by a building project.