Open main menu

Pop Job modding


Outliner top.png
Please help with verifying or updating older sections of this article. At least some were last verified for version 2.6.

This article is for the PC version of Stellaris only.

This page is about how to modify existing and how to create new Jobs.


Social StrataEdit

A Social Stratum is the position of a group of Pops in a society. They are defined at "common/pop_categories/xxx.txt".

In the planet population view, Jobs are grouped by Strata and Strata are sorted based on the order they are defined in files.

Data StructureEdit

Property Description
rank = <int> Marks the social rank of this Stratum.
clothes_texture_index = <int> The clothes index the portrait of this Pop will use. Only relevant to species portraits with clothes.
change_job_threshold = <float> If a Pop of this Stratum is employed, a new Job must have at least this many times the weigth of the former Job to make this Pop switch to the new Job.
keep_from_former_job = <yes/no>
demotion_time = <int>
Determines should a Pop of a Job of this Stratum will still be considered of this Stratum if unemployed.

If so, how many days until the Pop will demote its Stratum after unemployed.

pop_modifier A block of Modifiers to be applied to a Pop of this Stratum. Modifiers that affect base   Amenities and   Housing usage go here.
resources An Economy Units to determine the resource upkeep and production of a Pop of this Stratum. Upkeep costs like   Food and   Consumer Goods and resource productions by some Lithoid traits go here.
triggered_planet_modifier A block of Modifiers with a potential to be applied to the Planet. Modifiers that add   Trade Value based on the living standard go here.

Pop Strata do not support the unconditional planet_modifier.

The former block of Conditions (Pop scope) to determine should the later block of Modifiers be applied to the Pops of this Stratum after they are unemployed.

The condition also determines should a Pop of this Stratum trigger the unemployment empire alert. Vanilla usually disable unemployment alert for Pops of high living standard, being able to produce resources if unemployed.

unemployment_resources An Economy Units to determine the resource upkeep and production of this Pop while it is unemployed.
assign_to_pop A block of Conditions to determine should a Pop be assigned to this Stratum. This is called when a Pop is created, moved to another planet, or got a new owner.
resettlement_cost = { <resource> = <int> }
The former block of Conditions determines can a Pop of this Stratum be resettled, and if so, the later block determines the cost.
weight Determines the weight of this Stratum.

Questions & AnswersEdit

Why is a Specialist Pop never attracted to a Worker job?

The   Specialist Stratum has higher rank than the   Worker Stratum, making it unwilling to take any Worker jobs.

The   Complex Drone Stratum has the same rank as the   Menial Drone Stratum, making them willing to take Menial Drone jobs if the mastermind so desire.

How does demotion work?

If a Stratum has keep_from_former_job = yes, a Pop of this Stratum will still be of this Stratum after unemployment, until a number of days equal to the demotion_time have been passed.

For example, the   Specialist Stratum is ranked 2 with a demotion time of 1800 days, making an unemployed Pop that is formerly a Specialist job to still consider itself a Specialist and will only accept a Specialist or Ruler job, until 1800 days have been passed and it will finally stop hiding itself from reality and demote itself to   Worker Stratum, or "reset" its Stratum by technical.

The   Complex Drone Stratum does NOT have keep_from_former_job = yes or demotion_time, making Pops of this Stratum to immediately reset the Stratum after unemployment.

How does slavery work?

A Slave might take jobs from   Specialist or   Worker Stratum, but a Slave will never receive the same amount of   Consumer Goods upkeep of a Specialist or a Worker. Actually,   Slave is a special Stratum with no Jobs specifing itself of it, while it has a higher weight than any of the common Strata. It also has a custom assign_to_pop.

The actual Stratum of a Pop is selected from all Strata with a custom assign_to_pop plus the current Stratum of the Job the Pop is working in. For example, a Pop with Indentured Servitude slavery type working as an   Artisan will choose its Stratum from   Specialist,   Worker and   Slave, with Slave being with the highest weight, making this Pop a Slave beyond all. (Worker do also have a custom assign_to_pop.)

During the days an unemployed   Specialist Pop wait for a Specialist or Ruler job until its demotion, it still "sees" the   Worker Stratum and view it as a lower weighted Stratum, making it unwilling to reconsider itself a Worker. If you enslave it now, it will "see" the   Slave Stratum being with higher weight than the Specialist Stratum, and it will now be forced to consider itself a Slave.

What if some parameters were changed?

If the   Specialist Stratum and the   Worker Stratum had the same rank, an unemployed Specialist Pop will happily take a Worker job after unemployment and will instantly become a Worker, and if there was no Worker jobs available, the Pop will become an unemployed Specialist and needs time to demote until a Worker job is available.

If the Specialist Stratum had lower weight than the Worker Stratum, a Pop in Specialist job will still be a Worker, consuming the same amount of   Consumer Goods as a Worker, and it will be of needing no time at all to demote.


Jobs are defined at "common/pop_jobs/xxx.txt".

Data StructureEdit

Property Description
is_capped_by_modifier = <yes/no> Default yes. If no, this job is always considered available if other conditions are met. If there is a job uncapped by modifiers available that's open to all pops, no pops will become unemployed.
category = <pop category key> The Stratum this Job is binded to. A pop will be considered of this Stratum for as long as they are employed under this job and there isn't any Strata with a custom assign_to_pop and with higher weight than this one.
condition_string = <localisation key> A localisation key to briefingly describe what kind of Pop can be employed on this Job.
building_icon = <building key> Determines the building icon of this Job to be shown in the planet population view behind the Pop portrait. For example, the   Researcher job will use the science lab for a building icon. Nonexistant buildings can be specified and the texture file "gfx/interface/icons/buildings/<building key>.dds" will be used.
clothes_texture_index = <int> Optional. Determines the clothes index of a Pop working on this Job, overwritting the setting of the Stratum.
icon = <pop job key> Optional. Makes this Job to use the icon of another Job. For example, the   Science Director uses the same icon as   Researcher.
possible_pre_triggers A block of Pseudo-Conditions to determine can a Pop work in this Job. Only the following yes-or-no questions are allowed. Without the pre-triggers, the whole set of conditions will be evaluated once for each of the thousands of Pops in the galaxy, which can be performance intensive.
  • has_owner
  • is_enslaved
  • is_being_purged
  • is_being_assimilated
  • has_planet
  • is_sapient
possible A block of Conditions to determine can a Pop work in this Job. (Pop scope)
resources An Economy Units to determine the resource upkeep and production of this Job.
Block of Modifiers to be applied to the Planet. Modifiers that add   Amenities,   Trade Value or decrease   Crime go here.
Block of Modifiers to be applied to the Empire. Modifiers that add   Naval Capacity or   Administrative Cap go here.
A block of Modifiers to be applied to the Pop. Modifiers that add defense armies go here. See Army modding for details of Pop-spawned defense armies.
weight A Pop will attempt to take Jobs with higher weight for it. (Pop scope)

Questions & AnswersEdit

How to have a Job to produce something more or less without overwritting it?
  • If you are asking about how to make a Job to produce more resources of a certain type, head to the resource block and find its economy category, then head to the "common/economy_categories" to find what kind of modifiers are generated for this economy category.
    • For example,   Researcher has its own economy category that "produces_mult" modifiers would be generated, making modifiers like job_researchers_physics_research_produces_mult usable. However, since "produces_add" modifiers won't be generated, it's impossible to have researchers produce resources they originally can't, unless you overwrite the economy categories and force it to generate your required kind of modifiers.
    • Also,   Miner has its own economy category that both "produces_mult" and "produces_add" modifiers would be generated, making job_miners_minerals_produces_add usable. You can also use the modifier job_miners_minor_artifacts_produces_add = 1 to make Miners produce   Minor Artifacts +1, just do what you want.
    • If the job in question does not have its own economy category, for example, the   Clerk, then it's impossible to make them produce more resources by modifiers without affecting other jobs at all.
  • If you are asking about how to make a Job to produce more modifiers, like   Amenities,   Naval Capacity,   Crime Reduction,   Trade Value, or   Administrative Cap, then you have to overwrite the Jobs and use triggered_(country/planet)_modifiers to implement this. There are no modifiers to modify modifiers produced by Jobs.
    • However, most of the modifiers produced by Jobs are _add. You can use _mult modifiers to multiply the overall Empire stat or Planet stat, effectively making relevant Jobs more effective.
    • Despite the trait   Bureaucrat having a modifier that reads planet_bureaucrats_produces_mult, don't be confused, because this modifier has no effect and all it does is to confuse you.

Relevant ModifiersEdit

All jobs will generate the following modifiers for use.

  • job_<key>_add = <int> - This modifier adds that many jobs to the planet.
  • job_<key>_per_pop = <float> - This modifier adds X jobs to the planet, where X is the number of Pops multiplied by the value here.
  • job_<key>_per_crime = <float> - This modifier adds X jobs to the planet, where X is the planet crime multiplied by the value here.
Empire EmpireEthicsGovernments • Civics • OriginsMandatesAgendasTraditions • Ascension PerksEdictsPoliciesRelicsTechnologiesCustom Empires
Pops JobsFactions
Leaders LeadersLeader Traits
Species SpeciesSpecies Traits
Planets PlanetsPlanetary Feature • Orbital DepositBuildings • DistrictsPlanetary Decisions
Systems SystemsStarbasesMegastructuresBypassesMap
Fleets FleetsShips • Components
Land Warfare ArmiesBombardment Stance
Diplomacy Diplomacy • Federations • Galactic CommunityOpinion ModifiersCasus Belli • War Goals
Events EventsAnomaliesSpecial projectsArchaeological Sites
Gameplay GameplayDefinesResources • Economy
Dynamic modding Dynamic moddingEffectsConditionsScopesModifiersVariablesAI
Media/localisation Maya exporterGraphicsPortraitsFlagsEvent picturesInterfaceIconsMusicLocalisation
Other Console commandsSave-game editingSteam Workshop