A ghostly hand of light rearranging a holographic galaxy above a dark command deck for a Stellaris console commands guide.
The console is the galaxy's sandbox mode.

The Stellaris console is best treated as a testing rig. It can give resources, reveal hidden IDs, finish research, build fleets instantly, switch empires, trigger events, and repair broken targets, but it becomes unreliable the moment you stop thinking about scope. Good console use changes one variable, checks the result, and leaves you with a save you can still understand.

The Console Mental Model

Do not begin by memorizing a giant alphabetical list. Begin by sorting commands by the kind of thing they change. Once you know the category, the syntax and the risk make sense.

Command typeExamplesMental model
Value commandscash 5000, minerals 5000, unity 5000Add or remove a number from a stored value. Many amount commands also accept negative numbers.
Broad fill commandsmax_resourcesSkip individual resources and fill storage. Best for sandbox construction, bad for testing a real economy.
Toggle commandsinstant_build, ai, debugtooltip, intelRun once to turn on, run again to turn off. These are the easiest commands to forget.
Target commandsown, planet_class pc_gaia, planet_size 25Act on the selected planet, fleet, starbase, or object. Select the target before typing.
ID commandsplay 2, add_trait_leader [leader id] [trait id]Need a hidden ID. Use debugtooltip before you touch them.
Script commandsevent crisis.10, effect add_deposit = d_arid_highlandsCall the game's scripts directly. Powerful, but easiest to overdo.

That split is the whole game. A resource command is usually safe in a throwaway save. A target command is safe only if the right object is selected. A toggle is safe only if you remember to toggle it back. A script command is safe only when you know the chain you are entering.

The console is also not a private "player only" layer by default. Some commands change the player empire, some change a selected target, and some change simulation rules for everyone. instant_build is the classic trap: if the galaxy is unpaused while it is active, AI empires can also finish queued construction instantly. Pause before toggles, and turn them off before letting time run.

Open the Console

The console works in non-Ironman PC games. If you made the save as Ironman, console commands are the wrong tool for that file. Press Escape and look at the save controls if you are unsure: an Ironman save advertises that it is locked down for achievements. You cannot rescue an Ironman campaign by finding a better command; start or load a normal save instead.

On a US keyboard, the console key is normally ` or ~, just left of the top-row 1 key and below Escape. Other layouts can use Shift+2, ALT+2+1, Shift+3, ^, §, °, ², or Shift+Alt+C. Press the same key again to close the console.

Once the text box is open, type the command and press Enter. The up and down arrow keys move through command history, which is useful when you are repeating the same test with different numbers. If a command does nothing, solve the basic input problem first: non-Ironman save, PC version, correct keyboard shortcut, exact spelling, correct target, and a clean duplicate save if mods are involved.

Console Edition note: PlayStation and Xbox players should not expect the PC command console to exist. This guide is for the PC version of Stellaris.

Use Help and Debugtooltip

help is the command that keeps this whole subject sane. Type help to print available commands. Type help survey, help own, help resource, or help research_all_technologies to see a specific command's syntax inside your game. That matters because Stellaris has years of patches, DLC, and mods behind it, and the console itself can tell you what your install accepts.

debugtooltip is the second command to learn. It toggles extra hover information and exposes the internal IDs used by empire, planet, species, leader, fleet, ship, pop, and event testing commands. Use it before play, own, trait commands, pop commands, and anything that points at a specific object. Run debugtooltip again when you are done so normal tooltips are readable.

You needHow to get itWhy it matters
Command syntaxhelp [command]Prevents reversed arguments, missing IDs, and stale copy-paste commands.
Empire IDTurn on debugtooltip and hover the empire or interface entry.Needed for play, diplomacy tests, and empire-specific commands.
Planet or object IDSelect the body or use debugtooltip while hovering it.Needed when own, planet_size, or scripted effects are not using the selected target.
Species or pop IDUse debugtooltip in population views; add_pops with no arguments can also list species IDs.Needed for population and species trait commands.
Leader IDUse debugtooltip on the leader entry.Needed before adding, removing, or testing leader traits.
Resource or class keyUse command help, autocomplete, or a known in-game ID such as consumer_goods or pc_gaia.String keys must be exact.

The habit is target first, command second. When beginners break saves with the console, it is usually because they skipped the ID step, not because the command itself was complicated. For a deeper ID workflow, use the Stellaris debugtooltip and IDs guide.

Safe Testing Workflow

Console commands are strongest when you use them like a lab setup. Decide the question first, build the minimum scenario, save, then run the test. If you unlock everything and spawn half the galaxy at once, you may have fun, but you will not learn which mechanic caused the result.

  1. Start from a duplicate non-Ironman save. Keep your real campaign untouched.
  2. Pause before toggles. This prevents the AI from taking advantage of galaxy-wide tools while you work.
  3. Run help and debugtooltip. Confirm syntax and target IDs instead of guessing.
  4. Add only the setup you need. For a fleet test, you need tech, resources, ships, and vision. You do not need every planet edited.
  5. Save immediately before the experiment. That gives you a reset point for repeat runs.
  6. Run the test once and observe. Do not stack extra commands during the result.
  7. Change one variable and reload. This is how you compare weapon layouts, crises, diplomacy paths, or economy starts.
  8. Turn toggles off or reload the setup save. If you cannot remember whether a toggle is active, re-run it or return to the clean save.

A clean fleet-combat setup looks like this: pause, run research_all_technologies 1, toggle instant_build, run max_resources, toggle ai off, build the fleets, save, then use attackallfleets when you are ready for them to fight. The save point is what makes the test repeatable; without it you are only watching one noisy battle.

For economy tests, resist max_resources unless storage itself is the thing you want. Give a measured amount with cash, minerals, alloys, or resource, then let the month tick and read the income panel. Stellaris is an economy game before it is a fleet game; testing with infinite everything hides the bottleneck you came to study.

Best Stellaris Console Commands

These are the commands worth learning first. They cover discovery, resources, research, visibility, construction, targets, diplomacy, and fleet tests.

CommandEffectBest use
helpShows command help.Run help own or help resource before using commands with arguments.
debugtooltipToggles hidden tooltip data.Find empire, planet, species, leader, pop, ship, and fleet IDs.
max_resourcesFills resource storage.Fast sandbox setup when scarcity is not the test.
cash, minerals, food, alloysAdds basic resources.Use exact amounts to test economy pressure.
influence, unityAdds political resources.Claims, diplomacy, traditions, edicts, and leader tests.
physics, society, engineeringAdds stored research points.Speed research without unlocking the whole tree.
resourceAdds a specific resource by ID.resource consumer_goods 1000 for targeted stockpiles.
finish_research, finish_special_projectsCompletes active research or projects.Advance one queue without flattening progression.
research_all_technologiesResearches non-repeatable technologies.Late-game ship, crisis, and megastructure testing.
instant_buildToggles instant construction and upgrades.Build test fleets, planets, and starbases while paused.
survey, communications, intelReveals surveys, contacts, and map vision.Remove exploration delay from a test galaxy.
observe, playSpectates or switches controlled empire.Watch AI behavior or inspect another empire.
ownTakes selected fleet, starbase, or planet.Repair ownership or build custom test setups.
attackallfleetsMakes player fleets target other fleets.Run same-empire fleet combat tests.
debug_yesmenMakes AI empires accept player proposals.Diplomacy experiments and stuck negotiation fixes.
aiToggles AI behavior.Freeze the galaxy while setting up scenarios.
eventTriggers an event by ID.Run scripted chains only from a saved test state.

If you only remember five commands, remember help, debugtooltip, max_resources, instant_build, and own. Those cover discovery, IDs, broad resources, construction, and target control.

Resources, Research, and Instant Build

Resource commands change stockpiles, not income. If your empire is losing 200 Energy Credits per month and you type cash 5000, you bought time; you did not fix the deficit. For economy learning, add a limited amount and watch the monthly tick. For pure sandbox building, use max_resources.

NeedCommandPrinciple
Energy Creditscash 5000Use for maintenance, market tests, and stabilizing a save.
Mineralsminerals 5000Use for planet and station buildouts.
Foodfood 5000Useful for biological empires and market tests.
Alloysalloys 10000The fleet and megastructure shortcut.
Influenceinfluence 500Use for claims, expansion, diplomacy, and galactic actions.
Unityunity 5000Use for traditions, edicts, and leader-heavy tests.
Research pointsphysics 5000, society 5000, engineering 5000Add points without choosing a specific technology.
Specific resourceresource consumer_goods 1000Use the exact resource key when the simple command is not enough.
Everythingmax_resourcesUse when the question is about building or combat, not scarcity.

For research, choose the narrowest command that answers the question. finish_research completes current research and preserves the rest of the tree. physics, society, and engineering add points while still making you pick technologies. research_all_technologies wipes out normal tech progression, which is useful for late-game ship tests and poor for learning tech pacing.

research_all_technologies 1 is the quick setup for tests that need space-creature or crisis-related technologies. If you also need repeatables, run help research_all_technologies and follow the parameter order it prints.

instant_build is a toggle, not a one-shot resource button. Pause, run it, queue or finish the construction you need, then run it again before unpausing. Pair it with max_resources for large tests. If storage capacity changes while it is active, read the resource tooltip; the UI will show the cap in your save.

IDs, Targets, and Planets

The console usually targets either the object you selected or the ID you typed. Learn which one the command expects before pressing Enter.

JobCommandHow to use it safely
Take a planet, fleet, or starbaseownSelect the target first. If taking an enemy planet, take the relevant starbase too so system control matches your intent.
Switch empireplay [empire id]Find the empire ID with debugtooltip. Save first, because the empire you leave can be AI-controlled if time runs.
Observer modeobserveReturn with play [empire id] after confirming your original empire's ID.
Change planet class or sizeplanet_class [planet class id], planet_size [size]Select the body first. Use class keys such as pc_gaia only in a test save.
Add popsgrow_pops [amount], add_pops [species id] [planet id], build_pops [amount]Confirm planet and species IDs; large growth tests still need game time to settle.
Colonize selected bodycolonize [pop id]Use a valid pop ID and avoid uncolonizable targets unless testing edge cases.
Edit traitsadd_trait_leader, remove_trait_leader, add_trait_species, remove_trait_speciesConfirm the leader or species ID first; these changes can affect many entities.

Planet commands are powerful because one planet holds districts, deposits, pops, jobs, buildings, modifiers, ownership, colony state, and sometimes event state. planet_class changes what the body is. planet_size changes how much room it has. effect add_deposit = [deposit id] changes what it can exploit. Those are different layers.

The safe planet-editing pattern is: select the planet, run debugtooltip, write down the ID and current class, make one change, reopen the planet view, then let the game tick. If the district count, habitability, jobs, or colony state looks wrong, reload instead of stacking more edits.

Galaxy, Fleet, and Crisis Testing

For galaxy-level testing, the goal is visibility and control. survey removes survey delay, communications opens contact with empires, and intel shows the map. Use them together when you want to watch AI wars, crisis movement, diplomacy, or a changed start.

ScenarioCommand chainWhy this chain works
Reveal the test galaxysurvey -> communications -> intelRemoves exploration work, enables diplomacy, and gives map vision.
Freeze AI while setting upaiStops AI behavior from changing the scenario while you place ships, planets, or diplomacy.
Build late-game fleetsresearch_all_technologies 1 -> instant_build -> max_resourcesUnlocks designs, removes build time, and fills stockpiles.
Fight two fleets from one empireattackallfleetsTurns player fleets hostile toward other fleets, so you do not need a second empire for a clean combat test.
Watch AI behaviorobserve plus intelLets the galaxy run without your orders while staying visible.
Test diplomacycommunications plus debug_yesmenContacts the empires and forces acceptance so you can isolate the diplomatic mechanic.
Trigger scripted eventsevent [event id]Calls an event directly. Use a saved setup so you can rerun or abandon the chain.

Fleet tests should be repeatable. Build two fleets, place them in a quiet system, save, then start the fight. If you change weapons, admirals, repeatable techs, auras, or ship counts, reload and change only that variable.

Crisis events are script chains, not simple resource cheats. Start the natural chain when you want campaign-like pacing and jump directly only for an immediate stress test. Common examples are event crisis.10 for the Prethoryn chain, event crisis.1000 for the Unbidden, event crisis.2005 for the Contingency chain, and event crisis.2000 for a more direct Contingency spawn. Do not fire both Contingency routes unless duplicate behavior is the experiment.

The same logic applies to story events: start the chain for normal pacing, jump later only for a targeted test, and save first because event chains set hidden flags.

FAQ

Why will the Stellaris console not open?

The usual causes are Ironman mode, the wrong keyboard shortcut, playing on Console Edition, or the game window not having focus. Test in a new non-Ironman PC save and cycle through ~, `, Shift+2, ALT+2+1, Shift+3, ^, §, °, ², and Shift+Alt+C. If it still fails, use the Stellaris console commands not working checklist.

Can I use console commands in Ironman?

No. Ironman is the achievement-focused mode, and the command console is for non-Ironman sandbox play. If you want to use commands, make a normal save.

What command gives all resources?

max_resources fills your resource storage. Use individual commands such as cash 5000, minerals 5000, alloys 10000, influence 500, and unity 5000 when you want a controlled amount instead of full storage.

What is the difference between finish_research and research_all_technologies?

finish_research completes the technologies currently being researched. research_all_technologies unlocks the non-repeatable tech tree, which is useful for late-game testing but destroys normal progression in that save.

How do I find empire, planet, species, leader, or pop IDs?

Run debugtooltip, then hover the object or UI entry that contains the thing you need. Keep planet IDs, species IDs, leader IDs, and empire IDs separate; they are not interchangeable. The Stellaris IDs list is useful when you need common keys instead of live save IDs.

Does instant_build affect the AI?

Yes, treat it as a galaxy-wide construction toggle. Pause, turn it on, queue or finish your work, turn it off, and only then unpause. Toggling ai off during setup is useful when you are building a controlled scenario.

Can I subtract resources instead of adding them?

Many amount commands accept negative numbers. For example, a negative influence amount removes influence instead of adding it. Use this when you want to create a constrained test without editing the save file.

What is the safest way to change a planet?

Select the planet, run debugtooltip, save, change one layer with a command such as planet_class, planet_size, or an effect add_deposit call, then let the game tick and inspect the planet view. Do not chain several planet edits before checking the result.

Next Reads