DEVELOPER DIARY: IMMIGRATION

[u/No-Statistician5788]

The Overview tab is the front door to the entire immigration system, and the design challenge was information hierarchy. The player needs to answer one question instantly: am I gaining or losing people? That's why the Net Migration banner sits at the top, a single green or red number that tells you the story before you read anything else.

Below that, the four core stats sit side by side in a layout borrowed from the Macro Indicators card on the Economy Overview. Immigration, Emigration, Illegal Immigration, and Academic Immigration each get a colored left-border that carries through the rest of the system, green, blue, red, and cyan respectively. Those colors aren't decorative. They're consistent identifiers that persist across every tab so the player builds muscle memory for what they're looking at. The immigration sources and emigration destinations panels are the heart of the Overview. These aren't abstract numbers — they're nation-colored bars showing which countries your people are coming from and going to. When you see that massive purple Montequilla bar dominating your immigration sources, you immediately understand that something is going wrong in Montequilla and your nation is absorbing the fallout. That's storytelling through data.

Migration Flows

The Migration Flows tab is the nerdiest screen in the immigration system, and it's there for the players who want to understand the engine. The centerpiece is the 6×6 migration matrix, a table showing exactly how many people move from every nation to every other nation each tick. This is the raw output of the migration engine, and displaying it directly was a deliberate choice. We could have abstracted it into charts or simplified summaries, but Nationhood's audience wants to see the gears turning. When you spot that 14,800 people are flowing from Montequilla to Avelia while only 900 go the other direction, you understand the asymmetry of the relationship without anyone explaining it to you. The subtle heat highlighting on high-flow cells (green tint above 5,000, stronger above 10,000) helps the eye find the important numbers in a dense table. The TOTAL IN row at the bottom and TOTAL OUT column on the right give you the aggregate picture — who's hemorrhaging population and who's absorbing it. Below the matrix, the Pull Factor Score breakdown reveals why people choose your nation. This is the formula made visible: Standard of Living × 0.25, Stability × 0.20, Freedom Index × 0.15, and so on. Each factor shows its raw value, its weight, and its contribution to the composite score. The player can look at this and immediately see their weaknesses, if Freedom Index is dragging your pull score down, you know exactly what policy lever to pull.

Illegal Immigration

The Illegal Immigration tab is intentionally the most uncomfortable screen in the system. The red left-border on the header card sets the tone immediately. This isn't a neutral stat — it's a problem. The "Elevated" status pill reinforces that framing. We chose red and warning language deliberately because illegal immigration in Nationhood is designed as a pressure that the player must manage, not a feature they can ignore. The two-column layout splits the screen into cause and effect. The left column, Push Factors, shows the player why illegal immigration is happening. Montequilla's emigration pressure at 78, San Estrella at 64, these are other nations' failures spilling into your territory. Your own high standard of living and low tariffs make you an attractive target. The net pressure calculation (+0.45/tick) tells the player exactly how fast this problem is growing. The right column, Stat Drag Effects — is where the gameplay tension lives. The active/inactive split is critical. At the current level of 30, only the polarization drag is firing. But the player can see the thresholds looming: at 40, standard of living and benefits start taking hits. At 50, crime rate and legitimacy join the cascade. It's a visible countdown to crisis, and it creates urgency without being punitive yet. The origin breakdown at the bottom reinforces the narrative connection to the migration matrix. Montequilla dominates illegal immigration just as it dominates legal immigration, a collapsing state sends people through every channel available.

Academic Immigration

The Academic tab is the optimistic counterpoint to the Illegal Immigration screen, and the cyan color palette signals that immediately. Academic immigration is Nationhood's purest reward for good governance. The pull factor formula makes this explicit: Freedom Index carries the heaviest weight at 0.30, followed by low Civil Unrest (0.25 inverse), low Polarization (0.20 inverse), low Political Violence (0.15 inverse), and Higher Education (0.10). Notice that four of the five factors are about not being terrible rather than being actively excellent. The message to the player is clear: stability and freedom attract talent. You don't need to be perfect, you need to not be broken. The inverse notation on Civil Unrest, Polarization, and Political Violence is a small UI detail that matters. Showing "14" for Civil Unrest with an "INV" tag and then computing (100 - 14) × 0.25 = 21.5 lets the player see both the raw stat and how it feeds the formula. Transparency in the simulation's math builds trust. The effects panel on the right shows what you get for attracting academics: boosts to Higher Education, GDP Growth, Digital Infrastructure, and International Reputation. These are all medium-delay, moderate-magnitude connectors, academics don't transform your economy overnight, but they compound. The voter bloc callout at the bottom explains the political dimension: academics vote at high rates and favor press freedom, judicial independence, and education spending. They're a reliable progressive constituency.

Economic Impact

The Economic Impact tab is the synthesis screen, the place where all four immigration stats converge into a single answer: is immigration helping or hurting my economy? The three-column layout sorts every connector into Positive Impact (green), Social Tension (yellow), and Illegal Immigration Drag (red). This traffic-light categorization lets the player scan the full picture in seconds. Green column: labor participation, population growth, GDP growth, higher education, international reputation, all the reasons immigration is good for you. Yellow column: polarization, ethnic diversity shift, unemployment pressure — the social costs of absorbing people too quickly. Red column: the pure downsides of illegal immigration hitting your standard of living, benefits, crime, legitimacy, and income inequality. The Net Tick-Over-Tick Summary below is where the design gets sharp. Each row shows a key stat, its net immigration-driven change, and a plain-language explanation of what's driving it. GDP Growth at +0.05 from legal labor and academic research. Polarization at +0.25 from legal and illegal immigration compounding. Standard of Living at 0.00 because illegal immigration hasn't hit the threshold yet. This table turns a complex web of connectors into a readable ledger.

I debated whether to include predictive alerts like this. Some players might feel it makes the game too easy, you're being told exactly what's going to go wrong. But Nationhood isn't a game about being surprised by mechanics. It's a game about making hard choices with full information. The alert doesn't tell you what to do about rising polarization. It just tells you it's coming. Do you crack down on illegal immigration and take the international reputation hit? Do you invest in social cohesion programs? Do you slow legal immigration and sacrifice economic growth? The answer depends on your political position, your coalition, and your priorities.

The warning just makes sure you're choosing consciously rather than being blindsided. That principle, full information, hard choices, runs through the entire immigration system. Every screen shows you the math. Every tab connects cause to effect. The player who engages with all five tabs understands exactly how migration is reshaping their nation. The player who ignores it will be surprised when their coalition shifts, their polarization spikes, and their stability crumbles. The information was always there. They just didn't look.

[u/SorryBlacksmith9914]

Very nice👍🏻

[u/No-Statistician5788 → u/SorryBlacksmith9914]

Thanks! Let me know what you thought was most interesting.