Troubleshooting

Mac-Specific

The Mac release has a few limitations compared to the PC release. Before reporting a problem, make sure you are using the latest patched Oni application, and check out the following pages for more info:

• Oni engine patches (Mac) (patches made by the community)
• Installation#Patches (for OmniGroup's port of Oni to Mac OS X)
• PC vs Macs (list of PC-only features missing from the Mac build)

Oni crashes on my G5 Mac.

In one reported case, the reason for the crash was that Oni was set to a 640x480 resolution. Changing it to a higher resolution solved the problem. If Oni is trying to use an unsupported video setting, make sure your Display preferences do not list unsupported resolutions or refresh rates. DisplayConfigX can be used to disable the unsupported resolutions on your system. Finally, Oni can be run in windowed mode, which means that no resolution switching will occur. See -noswitch.

How do I change the resolution when Oni crashes at startup?

Use the program Oni Save Game Editor to change the resolution.

Oni crashes on my Intel Mac.

This crash is identical to the one experienced by modern PCs. The crash is due to a text overflow in a fixed-sized buffer. This occurs when Oni is listing all the GL extensions of a video card before writing it in the startup.txt file. A hack was made to make make Oni think that the video card does not support the GL extensions.

So far, no one has seen any difference in the graphics due to this unofficial hack. The modified version of Oni for OS X can be downloaded here

Oni plays poorly on my Mac under Leopard. The controls cut out occasionally.

Running a Carbon app in the background has been observed to fix this problem. If the app uses the CPU fairly heavily, it essentially begins to handle the CPU usage for other Carbon apps (like Oni!) more intelligently. This app works well if you simply leave it open in the background while playing Oni.

The sound has small glitches.

This is mostly unavoidable; however, if you try the above solution (running a Carbon app in the background), and it reduces the number or size of the glitches, please let us know; there is some evidence that a Mac with the above problem will also experience large sound glitches until the "Carbon fix" is applied.

I can't see the console in Developer Mode.

A bug in Oni causes the text on the console line to not display in certain resolutions, although the console prompt is still there; commands can still be entered and executed. If you aren't seeing the console prompt after pressing the ~ (tilde) key (and you are definitely using the patched Mac app that enables Dev Mode), you should try a different resolution.

The mouse control won't let me turn in a full circle.

The mouse tracking does in fact hit a boundary or the edge of the screen if you are playing with the original Bungie release of the Oni app in Mac OS X's Classic Mode. Classic Mode does not support the Input Sprockets functionality that the app is trying to use. Download the OmniGroup port, linked to below, for use with OS X.

PC-Specific

Most of the problems in Windows Oni can be solved by using the C-Daodan or by updating your drivers, but see below for more details.

Blam!s

There are a lot of reasons why the PC (Win32) version of Oni can go completely crazy. The single most common symptom is that Oni's window will go blank, and in the middle of your screen you'll have

There are several occasions on which Oni exits with such a message. The main issue was solved with the introduction of the Daodan DLL. However, if Oni still "blam"s at startup, this page contains a thorough list of things that cause Oni to "blam".

For any other problem, see below.

---

Bad texturing

There are several degrees of severity (from crappy textures to ugly textures to OMFG). That's always a driver issue. Try and get a recent driver for your GFX card (upgrade to Catalyst if you have an ATI, etc.). But sometimes, Oni is incompatible with modern stuff. Try and get a really old driver, then :)

---

Major lag

Power management

This can be a problem on notebooks. Under certain conditions, the performance of the computer will decrease dramatically, for example :

• if you run on battery power
• if you let the computer overheat

Driver issue

First let's make sure that your graphic card have direct 3d and AGP accelerations enabled. Click in start, execute, write dxdiag, and press ok. You will see now diverse information about your directX and your computer hardware/software, click in display, now check direct3d/agp acceleration. If it is off try enable it, if it is impossible enable, you graphic card may have not have this option or windows is using you card as pci instead of agp. In this case try update or install all your motherboard drivers.

File:Direct3d accelaration on-1-.jpg

Make sure that you have the accelerations enabled.

Now, if it is all enabled like in the picture above, try install or update your graphics drivers, don't use that ones that come with the Windows. If you have a Nvidia card and if it is old (like geforce 2 or Riva), I recommend you install an older driver. My recommendation is one from the 28.x and 60.x. range, this ones seemed to work better at my old card.

NVIDIA users download here nvidia old drivers. ATI try here.

See also "Bad texturing", see above.

---

Widescreen

Not really a problem, but it can be a bit annoying when your ONI window gets auto-stretched to fit a 16:10 screen.

Solution

Run ONI with the -noswitch command line argument. Oni then runs in a "window" in the upper left corner of your screen, with the resolution selected in Options.

If you want that window centered with a black background behind it, use OniWindowMover.

---

Mouse lag

The main solution to this seems to be forcing v-sync in your graphics card settings. See HERE for more details on the problem and other possible solutions.