Pop Job modding

Version

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 Strata

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 Structure

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 trigger Conditions (Pop scope)	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.
should_apply_unemployment_penalties unemployment_penalties	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.
allow_resettlement 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 & Answers

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

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

Data Structure

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.
planet_modifier triggered_planet_modifier	Block of Modifiers to be applied to the Planet. Modifiers that add Amenities, Trade Value or decrease Crime go here.
country_modifier triggered_country_modifier	Block of Modifiers to be applied to the Empire. Modifiers that add Naval Capacity or Administrative Cap go here.
pop_modifier triggered_pop_modifier	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 & Answers

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 Modifiers

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.

Modding

Pops	Jobs • Factions

Leaders

Leaders • Leader Traits

Species

Species • Species Traits

Land Warfare

Armies • Bombardment Stance