Editing v0.31:Immigration

{{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}

Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 seem typical in early seasons, followed by a large wave in the low double digits in the second Spring, one year after embark.  It may be the case that the first 2 migrant waves are special and possibly generated out of thin air, like all waves used to be. Even if your parent civilization is extinct, two waves will still show up. Each group of migrants will often include domestic animals, either as a pet or unclaimed livestock. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things.  Max wave size reported to date is 32.

Migrants will have skills that match your fortress' needs: Migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production and basic crafting according to Toady) are weighed more heavily than other skills.<sup>[http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 Source]</sup>

Migration waves are generally a good thing. However, in future versions, vampires disguised as immigrants will arrive at your fortress to cause trouble.



== Labor preference bug ==

Each migrant can arrive with a wide collection of often unrelated skills, far greater than possible with one of the [[starting build|starting 7 dwarves]], and [[experience]] levels as high as Legendary.
Any and all skills might be represented, including obscure military skills (like [[blowgunner]]), high levels of one or more [[social skill]]s, [[crutch walker]], [[concentration]] and others. It's even possible to have dwarves with skills that may not be obtainable by other means, like [[military tactics]].

Immigrants may have high skills in certain [[labor|labors]] without actually having them enabled in their labor preferences. This leads to dwarves either doing jobs from an area they are not labeled for or no work at all. For example, an adequate cheese maker (with the cheese making labor turned on) may also have the skill bone carving on "high master", albeit turned off in his preferences. The dwarf in question is listed as a bone carver on screen and in the [[status]] tab, but will only perform the cheese making labor. Individually checking each immigrant for skills and labor preferences is the only workaround so far. But the use of programs such as [[utilities|Dwarf Therapist]] can greatly decrease the time taken to check each dwarf's skills.

==Military Immigrants==
Any immigrant, with apparently any collection of skills, may also arrive with some [[combat skill]]s, all of the same [[experience]] level.  These appear consistently to be:

:* Armor User
:* Fighter
:* Dodger
...''and one of either''...
::* Wrestler, Striker, Kicker, or Biter
::...''or''...
::* 1 (or more*) weapon skill
:::''and''
::* Shield user

<nowiki>*</nowiki>If more than 1, then the total experience divided between the skills seems to be approximately equal to that of any of the other skills.{{verify}}

==Limiting/preventing immigration==
Immigration should stop when the fortress population exceeds the POPULATION_CAP option found in [[d_init.txt]]; to stop immigration, set it to a number lower than your current population.  The first two immigrant waves are hardcoded so you will always receive them, and you must have more than 10 dwarves {{Verify}}. and it might only take effect after the first dwarven [[caravan]] leaves your site.  {{Verify}} For some people POPULATION_CAP doesn't work at all. {{Bug|2922}}  A possible workaround is to edit the [[raw file]]s so the the [[wealth|created wealth]] of your fortress is negative, which should scare away new migrants.  If your fortress should ever become a mountainhome, you will receive an additional migration wave with the promotion, regardless of your population cap.

It is worth noting that you may need a certain minimum population size before any of your dwarves will experience [[strange mood]]s.  Additionally, POPULATION_CAP still allows babies to be born. You will need to alter BABY_CAP in order to change it.

==Immigration mechanics==
The date on which immigrants appear in a season seems to be fixed at the start of that season, but the number of immigrants and their skills are determined when the migrant wave arrives.

There is never a migration in the first winter.  There won't even be a {{DFtext|The fortress attracted no migrants this season|DarkGoldenRod}} message.

==Migrant wave sizes==
The first two migrant waves have a minimum size of <s>2</s> 1 and a maximum size of 9 or 10.  The size of these waves is unaffected by fortress wealth.

The third migrant wave and on are influenced by the [[created wealth]] of the fortress, with more wealth attracting more immigrants (more research is needed to determine specifics).  Specifically, they're influenced by the fortress wealth as reported by the last outgoing dwarven [[caravan]].  Wealth created after the caravan leaves has no influence until the next year's caravan leaves.  If the caravan fails to make it out then the fortress' wealth is not reported. The dwarven [[liaison]] does not report on fortress wealth, in those circumstances where the liaison makes it out but the caravan doesn't.

Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth.  If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season.  More research is needed to determine if the aforementioned statistics have any influence on migration numbers.
@@ Line 1: / Line 1: @@
 {{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}
-Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 seem typical in early seasons, followed by a large wave in the low double digits in the second Spring, one year after embark.  It may be the case that the first 2 migrant waves are special and possibly generated out of thin air, like all waves used to be. Even if your parent civilization is extinct, two waves will still show up. Each group of migrants will often include domestic animals, either as a pet or unclaimed livestock. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things.  Max wave size reported to date is 64.
+Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 seem typical in early seasons, followed by a large wave in the low double digits in the second Spring, one year after embark.  It may be the case that the first 2 migrant waves are special and possibly generated out of thin air, like all waves used to be. Even if your parent civilization is extinct, two waves will still show up. Each group of migrants will often include domestic animals, either as a pet or unclaimed livestock. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things.  Max wave size reported to date is 32.
 Migrants will have skills that match your fortress' needs: Migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production and basic crafting according to Toady) are weighed more heavily than other skills.<sup>[http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 Source]</sup>
@@ Line 47: / Line 47: @@
 Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth.  If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season.  More research is needed to determine if the aforementioned statistics have any influence on migration numbers.
-One factor which is known to affect migrant wave size is the total size of your fortress's {{k|u}}nits list, which consists of dwarves, invaders, merchants, and animals which either died or currently live at your fortress. As this number increases, the maximum size of migrant waves will be reduced: starting at a local population of 1000, migrant wave sizes are limited to 10, and at subsequent levels of 1300, 1600, 1800, 2000, 2200, 2400, 2600, 2800, and 2900, the limit is decreased by 1, and once you reach a local population of 3000 you will cease to get migrants at all.
-==Adventure mode==
-In certain locations in [[adventure mode]], you may come across a '''Migrating Group'''. One such location is near a recently [[abandon|abandoned]] [[fortress]]; choosing to travel to the group will allow you to talk to the members of your former fortress as they travel back to dwarven civilization.
-{{Category|Dwarves}}
-{{Category|World}}
-{{Starting FAQ}}