Knowledgebase:
Enabling trace mode (game won't start)
Posted by Gary Breckenridge, Last modified by Lukas Berger on 21 November 2016 04:19 PM

When troubleshooting a support issue, OOTP Developments may ask you to enable "Trace Mode." Trace Mode is a special mode that causes OOTP to log additional data that may be helpful in troubleshooting your problem.

The easiest way to launch the game in Trace Mode on Windows machine is to use a special shortcut that comes with the game. Go to Start | All Programs | Out of the Park Developments | Out of the Park Baseball (version) | Tools | Start OOTP with tracemode.

If you have a Macintosh or Linux machine, or if the above doesn't work, to enable Trace Mode, use the following steps:

For Windows:

  1. Open the Windows Start menu, type %appdata% in the search box (be sure and include the percent symbols) and hit Enter. [On XP, click on "Run" and enter %appdata%, and press Enter.]
  2. Navigate to Out of the Park Developments --> OOTP Baseball (version #) --> config. A folder will open with a number of files (app, engine, etc.).
  3. Double-click on the file called "app". Windows will ask you what program to use. Choose Notepad.
  4. In the now open file, find the line that says "trace_mode". It should have a 0 on the following line.
  5. Change the 0 to a 1. Save and close the file.
  6. Trace Mode will now be enabled the next time you run the program. Go to the section below called "Generating a Trace File".

For Macs:

  1. Open up a Finder window and go to the Go menu and hold down the option key (or alt key).
  2. Now select Library from the menu (it's hidden if you don't hold down the option key).
  3. From there, open up Application Support, then Out of the Park Developments, OOTP Baseball 15 and finally the config folder.
  4. Double-click on the file called "app".
  5. In the now open file, find the line that says "trace_mode". It should have a 0 on the following line.
  6. Change the 0 to a 1. Save and close the file.
  7. Trace Mode will now be enabled the next time you run the program. Go to the section below called "Generating a Trace File".

If the game has never run at all on your machine, the above process may not work as the app.cfg file may never have been generated. In that case you can follow these instructions:

     1. Open the console window and "cd" into the bundle with the following command lines:

     cd /Applications/
     cd Franchise\ Hockey\ Manager\ 3.app
     cd Contents/MacOS/

     2. Then start the actual app with the parameter:  ./Franchise\ Hockey\ Manager\ 3 tracemode

For Linux:

  1. Open a Terminal window. This should be a menu option under System or Accessories. (It can be different under different Linux distros, so consult your distro documentation if you cannot find it.) A window should open up giving you access to the CLI (command line interface) where you can type a command.
  2. Type cd and then press Enter to make sure that you are in your user's home directory.
  3. Type cd "/home/(user name)/.Out of the Park Developments/OOTP Baseball 15/data/config/", and press Enter. Don't leave out the period or the quotation marks! You can verify this by typing pwd and pressing Enter. The output should look something like this:

    username@computername ~/.Out of the Park Developments/OOTP Baseball 10/data/config
    $ pwd
    /home/username/.Out of the Park Developments/OOTP Baseball 10/data/config
  4. Type ls -ls and press Enter to display the contents of the current directory.
  5. Use vi or your favorite editor to edit the app file.
  6. In the now open file, find the line that says "trace_mode". It should have a 0 on the following line.
  7. Change the 0 to a 1. Save and close the file.
  8. Trace Mode will now be enabled the next time you run the program. Go to the section below called "Generating a Trace File".

Generating a Trace File

Once Trace Mode has been enabled, follow these steps to generate a trace file:

  1. Launch (or attempt to launch) OOTP. You may receive a pop-up saying that Trace Mode is enabled, and that performance may be slower than normal.
  2. Perform whatever steps are required to cause your problem to occur (or perform whatever steps OOTP Developments has suggested).
  3. Quit OOTP (if it hasn't crashed).
  4. Windows: Navigate to the directory where your OOTP data is stored. In a default Windows install, this will be Documents/Out of the Park Developments/OOTP Baseball 15/debug. Now skip to step 7.
  5. Mac: For a default install, open up a Finder window and go to the Go menu and hold down the option key (or alt key).
  6. Now select Library from the menu (it's hidden if you don't hold down the option key). From there, open up Application Support, then Out of the Park Developments, OOTP Baseball 15 and finally the debug folder.
  7. There should be a file called ootp_trace.txt that was generated by the trace. Attach this file to your support ticket.
  8. To disable Trace Mode, simply reverse the steps above. It's important to disable this since the game will run slower with trace mode enabled.

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments: