READ ME! Bug Reporting Quick Start Guide, FAQ and Common Bugs

Discussion in 'Bugs (Stable Only)' started by ZeroGravitas, Nov 11, 2017.

  1. ZeroGravitas

    ZeroGravitas Breaker of Games

    (1) Make the report! - It would be very helpful for you to have a quick read through this guide before making a report. But if the information is too much to take in, please don't be put off. We will still be happy to see what issue you are having, even if it's a duplicate. Devs or other active forum members (like me) will try to help you with getting the right information in the right place.:)

    (2) Not sure if it's a bug? - then post a new thread in the "Community Help, Questions and Guides" section. If it is, then a moderator may move the thread over to the correct bugs forum, for you. Also, post there if you maybe want some help figuring out an aspect of the game.

    (3) Use the correct forum section:
    • "TT Unstable (Bugs & Feedback)" - if you have switched to the unstable branch, in the game's Steam library -> "Properties" -> "Betas" tab (e.g. See this video for how to switch (and back up your save files and snapshots first).
    • "Multiplayer" - for any problems encountered in this mode.

    (4) Search for existing threads
    - It's certainly worth taking a quick glance down the first page of the relevant forum section, to check no one has just posted a thread on the same issue you have found in a new patch.

    But there are a lot of minor and non-critical bugs that have been around in TerraTech for many months, so it's fairly likely that the problem you are seeing has been reported previously.

    So, please check the "Commonly Reported Bugs" section, below.

    Also run a couple of quick keyword searches (top right of page):

    Best practice is to click "More..." for an "Advanced Search" that will let you let you look through both of the forum's bug reporting sections simultaneously (without searching the rest of the site). Hold [Ctrl] key while clicking (I think this works...):

    The forum's built in search if pretty good, but you could also try starting from this advanced Google search.

    (5) Add information to an existing thread - if you found a report that looks exactly like your problem, and you have information not already noted there, or you have been badly affected by the bug, then please post a reply there. If not...

    (6) Create a new thread - briefly describe the steps needed to repeat the bug, if possible, as per this example report by lead QA (Quality Assurance) dev, @Adriano.

    (7) Thread title - Start with the game's version number, in square brackets, e.g. "[0.7.8]". It can be seen in the loading splash screen, as shown here (the game can change a lot between patches, so this is important information!):

    Then add a concise description of what the bug relates to, including key words. e.g.: "Inventory block duplication when controlling very large tech".
    Last edited: Jan 4, 2018
    Adriano and Django like this.
  2. ZeroGravitas

    ZeroGravitas Breaker of Games

    (8) Context - State which game mode you were in: Campaign, Creative, R&D, Gauntlet, Sumo. What you were doing just before (if relevant). What tech the problem occurred with, etc.

    (9) Upload snapshots, save games and log files
    - on Windows 10 the file directory for save files and snapshots is:
    "C:\Users\[Username]\Documents\My Games\TerraTech"


    Uploading some of these can be extremely helpful for the devs to see and reproduce bugs.

    If the game crashes out (without locking up too badly), it should create a crash dump folder, named by date and time, containing an "crash.dmp" and "error.log" file. In the following location:


    Please Zip the appropriate crash folder and drag-drop it onto the post you are writing, to attach it.

    Even if the game doesn't crash or make a crash folder, the "output_log.txt" contains helpful telemetry data for the devs. It is wiped and overwritten each time you re-start the game.

    Or see the 0.8.1 patch notes for Mac and Linux directories:
    Previously the game stored everything in it's route Steam data folder:
    e.g. "C:\Steam\steamapps\common\TerraTech Beta"

    See this post for old/alternative Mac and Linux locations too.

    (10) Compress large file attachments - the forum has a 3 file attachments and 1MB upload limit (see here). So log files that are spammed full of repeated error lines may be too big and need to be Zipped. I recommend using 7-Zip (download), if you don't have anything already.

    Beware that the forum error for files being too big may be rather non-specific:

    (11) Screenshots - being able to see what's going on is often essential, so please provide a screen capture, if you can.

    To fit within the 1MB limit this should be a ".jpg" file, not a ".png". Ideally, you should host the image externally (e.g. somewhere like Imgur, or shared though Steam, if you like). This will ease the bandwidth use for the over-burden forum.

    (12) Tech Snapshot - if the problem seems specific to a particular tech design, then please attach it's ".png" file to your post. They are found in the "Snapshots" folder (in game the directory shown above).

    The model data is cleverly encoded and hidden in the image file, so do not edit the image first, or upload it to a site that will compress the file in any way. Attach it directly, they're fairly small.

    (13) System specs
    - particularly for performance issues, weird graphical glitches or failure to launch the game, it can be very helpful to post up exact PC hardware and software specs. For Windows users this is most easily done using DxDiag.exe (short instructions from Microsoft). This can be saved as a ".txt" file and drag-dropped to a forum post.

    (14) Becoming a 'Canary' for even earlier access - the devs may select the most helpful bug reporters to help them test some new game features and updates before they even get to the Unstable build. Like multiplayer - see here. Following this guide, when reporting, will best help your chances:
    You may also want to give some carefully thought out feedback on recent changes and additions to the game in Unstable patches, using the "TT Unstable" section (i.e. not "Suggestions" for totally new content).
    Last edited: Jul 14, 2018 at 6:23 PM
    Adriano and Django like this.
  3. ZeroGravitas

    ZeroGravitas Breaker of Games

    (15) Commonly Reported Bugs:

    Current Unstable issues:

    - Currently nothing new.

    In the "stable" main branch (long term issues):

    (a) FPS drop (AKA 'lag') - if your computer (easily) meets the minimum specifications, and things were running OK for a while, then this could be:
    • Enormous piles of auto-mined resources [report], that have sprung up just out of sight (at forgotten mining sites, within 600m of players current location). Each underground resource seam contains 1000 chunks (taking about 10 hours to extract with one miner). The physics burden of all these little objects colliding is enough to give any machine a lot to think about. And auto-miners play catchup when you return, after an absence, suddenly spurting out all the chunks that they should have popped in the time you were away.
    • The little crafting UI overlays appear to impact FPS dramatically - just 26 Filter Conveyors caused a drop from 60 to 30fps on my powerful desktop machine [report]. {Fixed in 0.8.0.}
    • Rotating anchored techs - possibly related to presence of shield bubbles and/or solar panels (or something else). This can be trigged by AI blocks turning a turret tech. {Fixed in 0.7.9, with the introduction of rotating anchors with full physics.}
    • Duplicated techs can cause horrible FPS drops (and crashes) when they intersect, see point "(f)", below.
    (b) Friendly AI is dumb - yes, most tech designs will struggle to "Follow" the player, often not moving at all on certain wheels (e.g. tracks). Techs also jitter, turning back and forth, even while in "Idle" mode.

    (c) Crafting is broken - yes, it's been badly in need of finishing/fixing for several months. See this guide thread for a list of known bugs related to crafting, each marked with a Bug Bot emoji:bugbotsadbugbothappybugbotconfused

    (d) Block duplication - pretty much a classic at this point (at ~18 months old). Perfecting user interface functionality in the Unity game engine is apparently very hard. This occurs when controlling a very large tech, zoomed right out, and having a block selected from inventory. Placing it down, or simply moving back and forth over the edge of the UI creates free blocks. [E.g. report.] {Fixed in 0.8.}

    (e) Anchoring in mid-air - Undoing tech disintegration currently restores all parts (including anchors) around the new location of the primary cab. So if that cab was quickly flown up into the air, you can fix an anchor up there. {Fixed in}

    (f) Tech duplication and apparent 'time travel' - this is proving a difficult bug to pin down, so any insights into this are still very much welcomed. Once it's gone wrong, a save may be permanently glitchy in this regard, eventually making it unloadable without crashing the game (due to intersecting techs). [Tech duplication report, time warping report.]

    (g) Gaps in terrain that you can fall through - i.e. big squares of the world are loaded in the wrong location. Another tricky problem to pin down, as it's rare, unpredictable, and sorts itself out if you go away and reload the save [report].

    (h) From the Steam patch notes - at the bottom of, here on Steam Community:

    Always accepting suggestions for bugs that currently get reported a lot, or problems that players encounter frequently (post below)...
    Last edited: May 31, 2018
    Adriano and Django like this.
  4. ZeroGravitas

    ZeroGravitas Breaker of Games

    (16) FAQ:

    (a) Why do my posts need to be approved? - all new users must make 3 posts that are approved before the forum should then automatically authorise them for all future posts.
    This is to protect against spammer accounts that try to make posts here on a daily basis. Example spam: Cropper2017-11-12-03-21-39-4582437.jpg

    If your 4th or 5th post still needed authorisation, then please make a post on this thread, saying so. @Suiwun will then authorise you manually, when he's next in the office and able to (usually very quickly).:)

    (b) Why do I keep getting errors? - this is an issue with the site hosting that the devs have been unable to get fixed.

    Often they can just be ignored. But they are fairly likely to cause you loss of input information at some point, particularly when editing an existing post, when there's no draft saving functionality (as just happened to me while writing this).

    It's probably better to click the "More Options..." button, at bottom of the pop-up post editing box. This gives a full page editor. Personally, I copy the body of the message I'm writing repeatedly, with Ctrl+[A], Ctrl+[C], so I can paste it back in when an error vanishes the editor window. Also before clicking "Save Changes"/"Post Reply".


    Please post any questions about bug reporting below (not questions about specific bugs).
    Last edited: Mar 17, 2018
    Adriano and Django like this.
  5. harpo99999

    harpo99999 ah kick till it starts

    this thread NEEDS to be pinned
    ZeroGravitas likes this.
  6. layer1

    layer1 Well-Known Member

    Should 'dead' blocks that don't respond to magnets/SCUs be in this list?
  7. ZeroGravitas

    ZeroGravitas Breaker of Games

    Is there a couple of reports you could link me to? I remember reporting it once... Somewhere... (Didn't think it was all that common. An old bug?)
  8. layer1

    layer1 Well-Known Member

    I don't know of any reports but figured it might be common since I see it regularly. It's another one that's tough to reproduce in part because it depends on dropped blocks. Maybe I should try and get good data and submit a report...?

    One thing I noticed is that if I forced the block into inventory, the next dead block would be the same. If I left it alone I'd get a different dead block the next time (usually).
  9. ZeroGravitas

    ZeroGravitas Breaker of Games

    I showed a way to reproduce it here in this thread about making Cabless (unanchored) techs. I don't appear to have made a separate thread for it though. So if you find one, or make with new insights, then please tag me and/or link/quote my existing information.:)
    layer1 likes this.
  10. layer1

    layer1 Well-Known Member

    Interesting. So maybe on enemy techs if I can pop a block off while the last cab is dying it will reproduce it. Something to try anyways, and I'll try to further our information in any case.

    edit: It's always just one block.
    Last edited: Nov 14, 2017
    ZeroGravitas likes this.
  11. Boomik

    Boomik ...

    Sick time machine bro!
  12. ZeroGravitas

    ZeroGravitas Breaker of Games

    Edited patch number out.:p If that's the most outdated info, I'm happy.:)

    I just editing in a link to the new Multi-player forum section, earlier today.
  13. the.nihilist

    the.nihilist Semiprofessional Idler

    I'm on 0.8.1 (gog) on Mac, i couldn't find the output log under ~/Library/Application Support/TerraTech/ as mentioned above (the patchnote for 0.8.1 mentions only saves and snapshots), but i found them under the location mentioned in this thread.
  14. ZeroGravitas

    ZeroGravitas Breaker of Games

    Hmm, I'm not 100% that this is not because you are using the GoG version, which I know sometimes lags a little behind Steam and might even use different directories going forwards.

    It would be helpful if a dev could give some guidance here: @kae, @Sdarks, etc, as I tried @Adriano on that other thread already (which I've now linked in the "different directories" Spoiler, above).
    Last edited: Jul 15, 2018 at 2:29 AM
  15. harpo99999

    harpo99999 ah kick till it starts

    at present the gog is still at 0.8.1
  16. the.nihilist

    the.nihilist Semiprofessional Idler

    Me neither, it could just be the GoG version, that's why i mentioned it. But the 0.8.1 patchnote on Steam you have linked above doesn't mention the output logs or crash files either, so it might have just been a misunderstanding.
    ZeroGravitas likes this.

Share This Page