Other Pages

• Documentation
• Known Issues

Table of Contents

• Finding the User Configuration
• Joystick Workarounds
• Video Workarounds

• Try looking in: "C:\Documents and Settings\<USERNAME>\Application Data\Onyx"
• Search for: "userconfig.txt"
• Open "C:\Program Files\Onyx\stdout.txt" with a text editor and look for a line: "Using home directory:", what follows that will tell you where the userconfig file is.

• The config file will be in: "~/.onyx/"

Controller Axis Is Reversed

If an axis on a joystick moves in the opposite direction that it should, including throttle controls.

1. Find your userconfig.txt and open it in a text editor
2. Add the line: controls_Joystick_<Joystick Number (0..5)>_Axis_<Axis Number (0..5)>_invert = 1
3. For example, to change the Yaw control on the first joystick, add: controls_Joystick_0_Axis_0_invert = 1
4. The axis are as follows: 0-Yaw, 1-Pitch, 2-Throttle, 3-Roll

Disable an Axis (Such as Throttle on PS2 Style Controllers)

If an axis on a joystick controls something it shouldn't, such as an analog stick controlling the throttle for the ship.

1. Find your userconfig.txt and open it in a text editor
2. Add the line: controls_Joystick_<Joystick Number (0..5)>_Axis_<Axis Number (0..5)> = <New Control (See next line)>
3. The controls allowed are: GameCommandAxis_Yaw, GameCommandAxis_Pitch, GameCommandAxis_Throttle, GameCommandAxis_Roll
4. For example to change the first joystick throttle to something more appropriate, add:
   controls_Joystick_0_Axis_2 = GameCommandAxis_Pitch

Setting a Non-standard Resolution

If a resolution you wish to use is not listed in the video modes it may be manually set.

The aspect ratio MUST be 0.75, widescreen is not supported at this point, so you may only change the Resolution 'X' value and 'Y' will be automatically calculated

1. Find your userconfig.txt and open it in a text editor
2. Add the line: video_resolutionX = <New Resolution X>
3. For example, to set the video resolution to 1280x960 add the line:
   video_resolutionX = 1280

Forcing Windowed Mode

If Onyx refuses to start fullscreen, or is crashing immediately.

• Add the command line option: --video_fullscreen=0

1. Find your userconfig.txt and open it in a text editor
2. Add the line: video_fullscreen = 0