How to Enable Debug Mode in EU5

Most players meet debug mode the day they want to cheat, fix something that broke, or figure out why a mechanic is not doing what they expected. All three uses work, but they hide what debug mode really is: a layer of the game that is always there, normally switched off, which labels every object on the map with the internal names the simulation actually uses. The cheats are just what becomes possible once you can speak to the game in its own vocabulary.

That framing matters because it changes how you use the feature. A player who sees debug mode as a cheat list copies commands from the internet and is stuck the day a patch renames one. A player who sees it as a reading tool knows how to pull the authoritative command list out of the game itself, how to look up every ID a command needs, and how to predict what a command will do before typing it. This page teaches the second way. The command list comes last, on purpose.

What Debug Mode Actually Is

Debug mode is a flag the game reads at startup. It is not a checkbox in the options menu and it cannot be switched on from inside a running session — by the time you are looking at the main menu, the decision has already been made. This is why every enabling guide starts in Steam's properties rather than in the game, and it is why "I turned it on but nothing happened" almost always means the game was already running when the flag was added.

Once the flag is set, you get two distinct tools that happen to share one switch:

1. An inspection layer. With debug mode active, hovering over a country paints its internal tag onto the tooltip — France becomes tag = FRA — and selecting a province reveals its location ID. Turn on Map Tooltips in the interface settings and the map itself gets painted with purple overlays showing location and region identifiers. This half costs nothing, changes nothing, and is genuinely useful even if you never type a single command: it is how you see the game the way the developers see it.

2. A console. The tilde key opens a command panel on the left of the screen. Commands typed there can add money, switch your country, force diplomacy, spawn weather, or delete armies. This is the half everyone screenshots.

The order is not accidental. The inspection layer is what makes the console usable, because nearly every interesting command takes an internal identifier as an argument. kill_all_units needs a country tag. population needs a location ID. religion needs a faith's internal name. Players who skip the reading half end up with a console full of commands they cannot aim. Players who master the reading half can pick up any new command in seconds, because they already know where its arguments live.

One consequence of having a console that can rewrite the world: treat debug mode as a sandbox key, not a daily driver. Commands can permanently alter a save, and a campaign you care about is the wrong place to find out what a command really does. Copy the save before experimenting, or start a disposable campaign and wreck it on purpose. That is what debug mode is for.

How to Enable Debug Mode on Steam

The whole procedure takes about fifteen seconds:

1. Open Steam and go to your Library.
2. Right-click Europa Universalis V and choose Properties.
3. In the left panel, select General.
4. Find the Launch Options field and type: -debug_mode
5. Close the properties window and launch the game.

Two details account for nearly every failed attempt. First, the flag is read when the game starts — if EU5 was already running, changing Launch Options changes nothing until you restart. Second, the spelling is exact: a leading hyphen and an underscore between the words. debug_mode without the hyphen does nothing, and neither does -debugmode or -debug mode with a space.

Playing without Steam? The same flag works from a Windows shortcut. Open the EU5 installation folder, find eu5.exe in the binaries subfolder, and create a shortcut to it. Open the shortcut's Properties and append the flag after the quoted path, so the Target line ends like this: "C:\...\eu5.exe" -debug_mode. Launch the game through that shortcut. The Paradox launcher does not get in the way here — launch options are passed to the game executable, and the launcher hands them through.

Opening the Console and Confirming It Works

Load into any game and press the tilde key — the key immediately left of 1 on a US keyboard, though its position moves on some international layouts. If debug mode is active, a console panel opens on the left side of the screen. If nothing happens, the flag did not apply; the fixes are in the FAQ below.

The console panel on the left is the only confirmation you need. If it opens, every debug feature is live.

Before typing anything, do the one setup step most players skip: open Settings → User Interface and enable Map Tooltips. Debug mode can paint extra information onto the map itself — purple overlays carrying location IDs, region IDs, and region detail — but only if tooltips are on. Those IDs are the required input for location-scoped commands like population, so enabling this setting is what turns the map from a picture into a lookup table.

Then run your first real test, which costs nothing: hover over a country. With debug mode live, the tooltip carries an extra line reading tag = XXX — France reports FRA. Zoom in, select a province, and its debug text includes a location identifier. You have now confirmed both halves of the feature at once: the console opens, and the inspection layer is reading internal names off the map. Everything else on this page builds on those two facts.

Generate Your Own Command List with helplog

Here is the single most useful command in the console, and it has nothing to do with cheating. Type:

helplog

The game writes a text file containing the complete list of console commands — every one your installed build actually supports, with syntax. You will find it in your Documents folder, inside the Europa Universalis V directory. Open it and you are holding the only command reference that cannot be out of date, because it was printed by the very game you are playing.

This matters more in EU5 than in any previous Paradox game. EU5 is young, and young games change fast: commands get renamed, arguments get reordered, caps move, and the odd command quietly disappears between builds. A command list on a website — including the table further down this page — is a snapshot of the game as it was when someone wrote it. Your helplog output is a snapshot of the game as it is right now, on your machine. When the two disagree, the text file wins, every time.

Make helplog your reflex whenever something does not work the way a guide says it should. A command that does nothing usually was not removed — it was renamed, or its argument format shifted, and the answer is sitting in that text file. The full EU5 console commands list is a good place to browse by category; helplog is where you confirm before you trust.

Reading Tags, IDs, and Internal Names

Every command that targets something needs an identifier, and the game never shows you these identifiers in normal play. Debug mode exists to fix that, and it gives you three ways to find any name a command could ask for. Knowing which channel to use is the difference between a command that fires instantly and twenty minutes of guessing.

You need	Where to get it	Example
A country tag	Hover the country with debug mode on; read tag = XXX in the tooltip.	France → FRA
A location or region ID	Select the province, or enable Map Tooltips and read the purple overlay.	A province reports an ID like 7273.
A government type	In-game UI: click your flag, then the crown icon, then read the government type.	republic, for change government republic.
A faith's internal name	Game files: browse local files → game/in-game/common/religions.	The Buddhist group file contains the faith bon.
An institution's internal name	Game files: game/in-game/common/institution.	Each file is one institution; the filename is the name to type.

The file-based channel deserves a closer look, because it is where players get stuck. To reach the game's data files, right-click EU5 in your Steam library and choose Manage → Browse local files, then open the game folder, then in-game, then common. Inside, the religions and institution subfolders hold one file per religion group and per institution.

The trap hidden in there is the difference between a group and its members. The religion command keys off individual faith definitions, not the family label. Type religion Buddhist and the game rejects it, because Buddhist is a group name that exists only as a folder-level concept. Open the Buddhist file and you will find the actual faith names inside — bon, for instance — and religion bon succeeds. The same discipline applies to institutions: the name to type is the one in the file, not the one on the wiki screenshot. The country tags and location IDs guide goes deeper on the map-side identifiers.

With Map Tooltips enabled, the map stops being scenery. Every province is a labeled object with an ID you can feed straight into a command.

How Console Commands Actually Behave

Command lists tell you what exists. They do not tell you how the game receives what you type — and this is where most of the confusion lives, because EU5 does not obey your input literally. It interprets it through its own rules. Four principles cover almost everything you will run into.

1. Stat commands add, and then clamp. When you type stability 80, you are not setting stability to eighty — you are adding eighty to whatever you have. Start at twenty-nine and you end at the cap of one hundred, not at eighty. Negative values subtract the same way. Other stats have their own ceilings that the game enforces without asking: enter war exhaustion 100 and the screen shows 19.1, because that stat's internal maximum is 19.1 and the game knows its own limits better than you do. The lesson is simple — treat every number you type as a nudge, then look at the screen, not at what you typed, for the truth.

2. Toggles stay on until you re-enter them. Commands like fast_diplo, yesman, instant construction, and ai are switches, not one-shots. Type one and it stays active through the session; type it again and it turns off. The one that bites people is instant construction, because it is not player-only — the AI's build queue benefits too. Leave it on and every nation on the map suddenly builds at zero cost. The correct workflow is deliberate: pause the game, queue your own projects, re-enter the command to switch it off, then unpause.

3. Targeting is either explicit or "whoever you are." Commands that name a country tag — kill_all_units FRA, add favor FRA 50 — do what they say to that country. Commands with no target argument hit the country you currently control. famine is the classic trap: it empties the food stores of whoever you are playing as, full stop. To starve France, you first tag FRA to switch into France, and only then run famine. Indiscriminate commands punish players who skip the aiming step.

4. Some commands are rough edges, and that is information. EU5 is early in its life, and the console shows it. core on a province may take it to "integrated" but not fully core it. There is no dedicated legitimacy command — the back door, found by accident, is gpower, which modifies government power and takes legitimacy with it. research_all unlocks every piece of research and does not even appear in the in-game help. None of this is a bug in your installation; it is a young game's console behaving like a young game's console. The practical rule: test a new command once in a disposable save, trust what you see happen over what you read about it, and move on.

A Starter Kit of Commands Worth Knowing

With the mental model in place, the command list stops being something to memorize and becomes something to browse. These are the commands that earn their place fastest, grouped by what they let you do. Multi-word commands are a spelling hazard: some are typed with underscores (form_union, kill_all_units, add_institution_progress) even when guides write them as words, and a few were transcribed from spoken demos. When one does not fire, helplog settles the exact spelling for your build.

Command	What it does	What to know
cash	Adds gold; no argument grants 1,000.	Values cap around 999,000. Infinite money bypasses the entire estate-tax system — max every spending slider and watch the game warp.
stability	Adds stability; no argument grants +100.	Clamped at the 100 cap. Stability is your realm's sanity meter: revolts calm, income rises, reforms speed up.
prestige / manpower / diplomat	Max prestige; fill manpower; grant diplomats (20 by default).	Manpower does nothing if you are already at cap. diplomat accepts a custom amount.
tag FRA	Switch control to another country mid-campaign.	Get the tag by hovering. Required setup before running "current country" commands like famine at someone else.
observe	Spectator mode — control nothing, watch the world run.	The best way to study how the AI plays without you.
annex FRA	Absorb the tagged country's territory.	Spelling varies between builds; confirm with helplog.
fast_diplo	Diplomacy resolves instantly — opinion, alliances, peace offers.	Toggle. Turns centuries of opinion-grinding into one click, but does not bypass annexation.
yesman	The AI accepts every offer you make.	Toggle. Vassalization, lopsided peace, outrageous demands — all accepted. A toy, not a strategy.
instant construction	Buildings complete instantly.	Toggle, and the AI benefits too. Pause, queue your builds, switch it off, unpause.
instant siege / instant move / remove fog of war	Sieges resolve instantly; armies move instantly; every army and fleet is revealed.	The logistics-removal trio. The warfare guide explains what these commands are skipping.
ai	All nations stop making decisions.	Toggle. The world stands still while you conquer it unopposed.
population 7273 10	Adds population to a location: one value unit equals 1,000 people.	Needs a location ID from the map overlays. Population with no food supply just starves — read the economy guide before dumping millions anywhere.
add favor FRA 50 / form_union FRA	France owes you 50 favors; forms a personal union with you as senior partner.	Favors are the diplomatic currency normally earned over years. The diplomacy guide covers what they buy.
clear AI objectives FRA	Wipes France's AI plans; it re-evaluates strategy from scratch.	A behavior reset, not a stat change — the fix for an AI stuck on a bizarre course.
famine	Empties the food of the country you currently control.	Indiscriminate. tag into the target first if the target is not you.
kill_all_units FRA / damage_all_units FRA	Deletes every French unit; or damages them all.	The soft version is more fun for scenario-building than total deletion.
religion bon	Changes your faith.	Needs the internal faith name from common/religions — the group name "Buddhist" is rejected.
add_institution_progress Renaissance Grimby 100%	Spawns or advances an institution at a location.	Three arguments: institution name, location tag, percentage.
weather Grimby tornado	Spawns tornado weather at the named location.	Pure sandbox — useful for testing how weather wrecks armies.
warweariness -20	Drives war weariness back to zero.	Negative values reduce; the stat clamps at its own floor and ceiling.

Turning Debug Mode Off

There are two layers to switch off, and players routinely confuse them.

Inside a session, typing debug_mode into the console toggles the whole feature off: the purple overlays vanish and the tooltips stop carrying tags. There is a catch — once you toggle it off this way, the console will not reopen for the rest of that session, even if you press tilde until your keyboard wears out. Reopening it requires a game restart. If you think there is any chance you want the console back, leave the session running and simply close the panel rather than toggling the mode.

Permanently, remove -debug_mode from Launch Options (or stop using the shortcut that carries it) and the game returns to its normal state on the next launch. A sensible default is to keep the flag off and add it only for deliberate sandbox sessions — copy the save, enable the flag, experiment freely, then remove the flag and go back to the campaign you actually care about, untouched.

Which brings the whole page full circle. Debug mode is a sandbox key: the reading half teaches you how the game thinks, the console half lets you test what you learned, and neither belongs in a campaign where the stakes are real. Used that way, it is the single best tool for understanding EU5 — because the game stops being a black box and starts answering questions.

FAQ

Next Reads

• EU5 Console Commands and Cheats List — the full command reference, browsable by category.
• EU5 Console Commands Not Working — fixes for when the console or a command refuses to respond.
• EU5 Country Tags and Location IDs Guide — every identifier the targeted commands need, and where to read them.
• EU5 Beginner Guide: First 50 Years — the systems the console shortcuts are skipping, learned the honest way.
• EU5 Economy Guide — why dumping population without food starves, and how the tax base really works.
• EU5 Estates and Crown Power Guide — the stability, legitimacy, and government-power systems behind stability and gpower.
• EU5 Diplomacy Guide — favors, unions, and opinion: what fast_diplo and yesman are overriding.
• EU5 Warfare Guide — sieges, movement, and army mechanics the instant commands shortcut.
• HOI4 Console Commands and Cheats and Stellaris Console Commands and Cheats — the same Paradox console tradition in the other two grand strategies.