Population

Consumption

The do_population_consumption function is at 0x00527D40.

At 0x00672860 there is a table that contains the daily consumptions for 100 citizens of every population type:

If a town is not under siege and a ware is in oversupply, more of it is consumed. TODO clarify TODO pitch consumption (sieged and unsieged), winter/famine/plague modifiers

Satisfaction

P3's setting "Needs of the citizens" changes how easy it is to increase the satisfaction, and how fast it changes. The satisfaction classes are displayed in-game: Very happy, happy, very satisfied, satisfied, dissatisfied, and annoyed. The satisfaction for each population type is stored in the town's satisfactions array at offset 0x300, holding an i16 for every population type except Beggars. The function prepare_citizens_menu_ui at 0x0040B570 calculates the satisfaction classes by converting the i16 into an f32, and picking the highest applicable class:

The function update_citizen_satisfaction at 0x0051C830 calculates the current satisfaction each population type would have. The satisfaction is then increased or decreaseed by the respective step size, depending on whether it was bigger or smaller than the current satisfaction, but it won't go beneath -40 or above 80. At 0x006736AC there is a table that contains for every difficulty the step sizes for increments and decrements to the satisfaction:

At 0x006736A0 there is a table that contains for every difficulty the base satisfaction for every population type:

Within update_citizen_satisfaction 6 situational modifiers are implemented:

At 0x00672938 there is a table that defines ware satisfaction weights for every population type:

The current satisfaction is calculated as follows:

def get_ware_satisfaction(ware_id, population_type):
    if wares[ware_id] >= 2 * weekly_consumption[ware_id]:
        return satisfaction_weights[population_type][ware_id]
    else:
        return (wares[ware_id] - weekly_consumption[ware_id])
            * satisfaction_weights[population_type][ware_id]
            // weekly_consumption[ware_id]

current_satisfaction = 2 * (
    base_satisfaction
    + situational_modifiers
    + unknown_modifiers # 9 total, 8 capped at 4
    + ware_satisfactions
)