Giter VIP home page Giter VIP logo

debug-blender-crashes-guide's Introduction

Guide to debugging Blender/BGE/UPBGE crashes

Prerequisites

  • blender_debug_log.cmd
  • Windows OS (feel free to convert the script for your OS)

NOTE: Blender 2.8+ versions usually ships with the script, so no need to download it if you already have the script locally. You can double-check if you have it already by searching in your root Blender folder. If your Blender/UPBGE folder doesn't have this script, you can download it from this repository.

How to generate crashlogs - Blender/BGE/UPBGE

  1. Place blender_debug_log.cmd in your root Blender (if it isn't already there).
  2. Run blender_debug_log.cmd by clicking it.
  3. A terminal window should open - once so, hover your cursor over the generated terminal window.
  4. Once the terminal window is active or in focus, push the ENTER key to confirm the opening of Blender - Blender should open normally then.
  5. Attempt to make Blender crash again; when it does, File Explorer should automatically open a new Explorer window containing a new TEMP folder, which should contain the newly generated crashlogs.
  6. In the crashlogs folder, make sure to view blender_debug_output.txt and not blender_system_info.txt to prevent wasting time.

NOTE: Please be aware that Blender may NOT crash while the debug terminal is still open, as most exception alerts have been automatically disabled.

How to generate crashlogs - Exported Runtime

  1. If your exported runtime has a filename other than Blender or blender, for example Game.exe, you'll need to tweak the script to recognize your runtime in order for the script to properly launch and debug your runtime.

  2. To edit the script to fit your renamed runtime, open your script in a text editor and rename: "%~dp0\blender" to "%~dp0\%PROJECT_NAME%".

NOTE: %PROJECT_NAME% should be the filename of your runtime such as Game. No need to add your runtime's extension type (exe, app, elf, etc.), that's automatically detected.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.