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

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.