Bug Reporting - Guidelines on how to write a Bug Report

Not open for further replies.


Production Director - Drinker of Tears
Super Moderator
Demi Moderator
1 Badges
Nov 5, 2013
  • Hearts of Iron IV Sign-up
Greetings interstellar travelers!

In order to help us in QA, and rest of the Dev Team when writing a bug report, I'm providing you all with guidelines on how to write a "proper" bug report (might be useful to both veterans & newcomers on the forums).

This is to make a bug report more structured, and easy to read which in the end will help us to quicker reproduce the bug, and therefore hand in the correct information faster to the Dev Team so that they can fix it. I'll start with writing what a bug report should contain, and follow it up with an example to make things more clear.

What a bug report should contain:

1. Thread Title: Should always include the [version number] & [checksum] of the game and contain a brief description of the issue. In order to find the version number and checksum, start the game and you will be able to find it in the launcher. Can also be found in the in-game menu.

2. Description: Describe the bug/issue in more detail - What occured and what you did in order to make the issue appear.
If you are using an old save after a new patch is released, please do let us know.

3. DLC Information: If you have any dlc's, unit packs etc, please state them here.

4. Mods: If you are using any mods, please state them here.

5. Reproduction Steps: If you are able to reproduce the bug, please write down steps needed to be done in order to achieve the desired result.

6. Attach if possible any screenshot of the issue, and/or a save of said game.
If you are having issues with CTD's (Crash to Desktop) try to always provide a save game, dump file, and logs. These files can be found in your Paradox folder, which is usually found in:
  • C:\Users\XXXXX\Documents\Paradox Interactive\Stellaris\save games
  • C:\Users\XXXXX\Documents\Paradox Interactive\Stellaris\logs
  • C:\Users\XXXXX\Documents\Paradox Interactive\Stellaris\dumps
.pdf, .png, .jpg, .jpeg, .jpe, .gif, .7z, .crp, .eu4, .rar, .sav, .dmp

See the example below for how a bug report might look like:

####Example Bug Report - Do not take the example as serious for obvious reasons####

v.1.0.0 [9b5a] Selecting the Spaceport makes it "jump" to random system.

Description: Whenever I try to select my spaceport, it gets moved to a random planet & system in the galaxy that is not occupied by any other player or AI.
DLC's: N/A - If we release DLC/Expansion's to Stellaris, add them here in the future!
Mods: I have mod "X" installed and active.

Reproduction Steps:
1. Start the game.
2. Load the attached save game OR Start a New Game, select your Spaceport.
3. Select capital planet.
4. Go to the Spaceport tab.
5. Build a ship.
6. Focus on the ship in order to find the Spaceport in the random system it has ended up in.

Observe: The Spaceport is no longer orbiting your capital planet, but rather can be found over a random planet in the galaxy.

Note that it is understandable that not all the bug reports are able to look like this, as there can arise occasions where it's hard to say what happened in order for the bug to occur. If that is the case simply try to provide with as much information as possible. I hope this will help you out as much as it will help us here in the office if used.

Best Regards,
Mr. Nibbles
Your QA Overlord & Drinker of Tears
Last edited by a moderator:
  • 18
  • 4
  • 1Like
Upvote 0


38 Badges
May 3, 2016
  • Magicka
  • Tyranny - Tales from the Tiers
  • Stellaris: Synthetic Dawn
  • Tyranny: Archon Edition
  • Sword of the Stars
  • Pillars of Eternity
  • BATTLETECH: Flashpoint
  • Stellaris: Apocalypse
  • Surviving Mars: Digital Deluxe Edition
  • BATTLETECH - Digital Deluxe Edition
  • Stellaris: Distant Stars
  • Shadowrun Returns
  • Shadowrun: Dragonfall
  • Age of Wonders III
  • Stellaris: Megacorp
  • Stellaris: Ancient Relics
  • Age of Wonders: Planetfall Sign Up
  • BATTLETECH: Heavy Metal
  • Stellaris: Federations
  • Crusader Kings III
  • Stellaris: Galaxy Edition
  • Crusader Kings II: Sons of Abraham
  • Warlock: Master of the Arcane
  • Mount & Blade: Warband
  • Stellaris
  • Stellaris: Galaxy Edition
  • Stellaris: Humanoids Species Pack
  • Stellaris: Digital Anniversary Edition
  • Stellaris: Leviathans Story Pack
  • Stellaris - Path to Destruction bundle
  • Surviving Mars
  • Crusader Kings II
  • Stellaris: Galaxy Edition
  • Stellaris: Distant Stars Pre-Order
  • Imperator: Rome
  • Imperator: Rome Sign Up
  • BATTLETECH: Season pass
Bug Report Template courtesy killroy_is_thechauffeur, to copy&paste into each bug report when created.

Title of the thread:
v.1.0.2 [fc5e] Title here.

Content of the thread:
[B]Description:[/B] Describe the bug here.


[B]Savegame:[/B] E.g. single player game; game started in older version (v.1.0.1) but the problems persists in titled version.

DON'T FORGET TO UPLOAD SAVEGAME (and remove this line)

[B]DLC's:[/B] All available until time of this post.
[B]Mods:[/B] None.

[B]Reproduction Steps:[/B]
1. Do this.
2. Then that.

[B]Observe:[/B] What to observe which has to do with the described bug.
Last edited by a moderator:
  • 8
  • 3

Had a dad

V g H
209 Badges
Sep 5, 2008
  • 500k Club
  • Crusader Kings II: Way of Life
  • Crusader Kings II: Conclave
  • Crusader Kings II: Limited Collectors Edition
  • Diplomacy
  • Cities: Skylines
  • Europa Universalis: Rome
  • Surviving Mars: Digital Deluxe Edition
  • Cities: Skylines - Parklife
  • Prison Architect
  • Imperator: Rome Deluxe Edition
  • Europa Universalis IV: Golden Century
  • Surviving Mars: First Colony Edition
  • Shadowrun Returns
  • Age of Wonders: Planetfall Deluxe edition
  • BATTLETECH - Digital Deluxe Edition
  • Steel Division: Normandy 44 -  Back to Hell
  • Stellaris: Humanoids Species Pack
  • VtM - Bloodlines 2
  • Imperator: Rome Sign Up
  • Age of Wonders: Planetfall
  • Crusader Kings Complete
  • Age of Wonders: Planetfall Premium edition
  • Age of Wonders: Planetfall Season pass
  • Age of Wonders: Planetfall Sign Up
  • Crusader Kings III Referal
  • PDXCon 2019 "Baron"
  • Stellaris: Lithoids
  • BATTLETECH: Heavy Metal
  • Crusader Kings II: Reapers Due
  • Europa Universalis IV
  • Empire of Sin
  • Elven Legacy Collection
  • Magicka: Wizard Wars Founder Wizard
  • Victoria 2 Beta
  • Mount & Blade: With Fire and Sword
  • Hearts of Iron IV: Cadet
  • Hearts of Iron IV: Colonel
  • Hearts of Iron IV: Field Marshal
  • Elven Legacy
  • Cities: Skylines - Green Cities
  • Stellaris: Digital Anniversary Edition
  • Stellaris: Leviathans Story Pack
  • Cities: Skylines - Natural Disasters
  • Cities: Skylines - Mass Transit
  • Europa Universalis IV: Mandate of Heaven
  • Steel Division: Normandy 44 Deluxe Edition
  • PDXCON 2017 Standard Ticket holder
  • Hearts of Iron IV: Death or Dishonor
Not open for further replies.