Skip to content

Debugging and Console Commands

szapp edited this page Oct 17, 2017 · 17 revisions

Some steps have been taken to make debugging GFA easier and to help with customizing it (see Features & Configuration).

Console Commands

The below commands can be entered into the in-game console. It is opened in marvin mode (b marvin b) by pressing F2.

Command Description
GFA version Displays the current version of GFA, e.g. "Gothic Free Aim v1.0.0".
GFA license Displays the license information of GFA.
GFA info Displays the enabled features of GFA.
GFA stats Displays the shooting statistics (shots, shots hit, personal accuracy, critical hits).
GFA stats reset Reset the shooting statistics to zero.
debug GFA zSpy Toggles debugging output in the zSpy. It sets the constant GFA_DEBUG_PRINT, see below. This command requires GFA_DEBUG_CONSOLE to be true (see configuration)
debug GFA weakspot Toggles the visualization of the trajectory of the last projectile and the bounding box of the defined weak spot for the hit target (if any). This will help deciding on suitable dimensions for weak spots. It sets the constant GFA_DEBUG_WEAKSPOT. This command requires GFA_DEBUG_CONSOLE to be true (see configuration).
debug GFA traceray Toggles the visualization of the aim ray and the determined nearest intersection. This should only be useful if the underlying GFA mechanics are modified (which is not recommended). It sets the constant GFA_DEBUG_TRACERAY. This command requires GFA_DEBUG_CONSOLE to be true (see configuration).

Output to zSpy

When the constant GFA_DEBUG_PRINT is true, or it is enabled by console command, see above, additional information is printed to the zSpy for debugging.

  • Information about shots from bows and crossbows at time of shooting, containing

    • Aiming distance (meters)
    • Draw force (percent)
    • Accuracy (percent) and resulting scatter (degrees of deviation in visual angle) OR hit chance (depending on whether GFA_TRUE_HITCHANCE is enabled or disabled)
    • Recoil (percent)
    • Adjusted base damage and original base damage

    This output is only displayed if the feature free aiming for ranged weapons is used.

  • Information about critical hits from bows and crossbows at time of collision, containing

    • Whether or not it was a critical hit
    • Original base damage
    • Critical hit base damage
    • Damage on target (damage by formula)
    • Critical hit zone (body node/weak spot) and its dimensions
    • Additional debugging information as set in the configuration.

    This output is only display if the feature critical hits is used.

  • Information about damage behavior of shots from bows and crossbows at time of shooting, containing

    • Damage behavior (prevent knockout, prevent kill, instant knockout, instant kill)
    • Base damage (new/old)
    • Damage on target (damage by formula)
  • Information at first creation of the aim vob.