Troubleshooting

Mac-Specific

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. The app doesn't need to do anything; you can just leave it open and then open Oni. If you don't know what a Carbon app is or if you have one, just download this one, it worked for one Mac user: 0SEx.

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.

Known control issue

In Mac OS X the character cannot fully turn or rotate around. Its like the mouse tracking has hit a boundary or the edge of the screen.

According to Feral: "Mac OS X does not support Input Sprockets, which Oni needs. Run Oni in "Classic" mode to avoid this problem. Alternatively, download the OmniGroup's Oni port and try your luck with that."

The Mac release has a few issues; check out the following for more info:

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

PC-Specific

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. However, if Oni "blam"s at startup and doesn't let you play the game, see this page.

For any other problem, see below.

---

Other problems

Texturing

There are several degrees of severity (from crappy textures to ugly textures to OMFG). That's always a driver issue.

Old drivers

Try and get a recent driver for your GFX card (upgrade to Catalyst if you have an ATI, etc)

New drivers

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

Same as "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.