Debugging Trucks

there are lots of ways of how to debug beam objects. Most of these option requires you to edit the RoR.cfg by hand.

how to test your truck fast

• add some handy arguments to a ror.exe shortcut:

RoR.exe -terrain aspen -truck semi.truck -enter

advanced ingame value display

to enable this you have to add this to your RoR.cfg:

DebugBeams=Yes

then in your truck you can use the debugBeams keyword to trigger various debug modes:

• default case, off:
  • debugBeams off
• display node numbers:
  • debugBeams node-numbers
• display beam numbers:
  • debugBeams beam-numbers
• display node and beam numbers:
  • debugBeams node-and-beam-numbers
• display the node mass:
  • debugBeams node-mass
• locked node info state:
  • debugBeams node-locked
• beam's compression:
  • debugBeams beam-compression
• broken state of beams:
  • debugBeams beam-broken
• beam stress:
  • debugBeams beam-stress
• strength of beams:
  • debugBeams beam-strength
• hydro information:
  • debugBeams beam-hydros
• command information:
  • debugBeams beam-commands

example

open your .truck file in notepad and add this to the file before end:

debugBeams beam-stress

find breaking beams

• add this to your RoR.cfg:

Beam Break Debug=Yes

• afterwards test the truck and open RoR.log after exiting the game.
• look for "XXX Beam n just broke with force ..."

debug truck mass

since the nodes masses are calculated on the fly when the truck is created, you can get RoR to output the real node masses upon calculation:

Debug Truck Mass=Yes

after enabling this, look for "Node n mass ..." in RoR.log

Replay mode

you need to enable the replay mode first:

Replay mode=Yes

you can change the length of the replay with this (number of frames, default is 10k):

Replay length=10000

the precision can be adjusted with this (recorded frames per second, default is -1, means all frames available):

Replay Steps per second=-1

for debugging purposes you should consider to set the precision to -1 (all frames)

how to use replay mode:

• press "J" key ingame to activate the replay mode
• use ALT+Mouse movement(left or right) to scroll forward or backward in time