Troubleshooting - Revision history

Iritscen: we have a second report now, so I'm thinking this is something that was fixed in the engine between v1.0 and v1.1 (thanks to Stefan, probably)

2025-12-07T22:53:40Z

we have a second report now, so I'm thinking this is something that was fixed in the engine between v1.0 and v1.1 (thanks to Stefan, probably)

← Older revision		Revision as of 22:53, 7 December 2025
Line 32:		Line 32:
	===Poor frame rate===		===Poor frame rate===
	====When certain particles are onscreen====		====When certain particles are onscreen====
	There is no known fix ~~or patch~~ for this in Oni, ~~though~~ we have ~~a report~~ of ~~particle performance~~ being ~~better with~~ OniX. ~~Besides that,~~ our only advice is ~~to try~~ not to have those particles onscreen =^-^= If you don't look at them, they can't slow you down.		There is no known fix for this in Oni, but we have reports of this issue being fixed in OniX. If you're playing AE Oni instead then our only advice is, Try not to have those particles onscreen =^-^= If you don't look at them, they can't slow you down.

	====Power management issue====		====Power management issue====

Iritscen: one user said OniX fixes the issue, but it would be nice to have some corroboration

2025-12-07T21:46:08Z

one user said OniX fixes the issue, but it would be nice to have some corroboration

← Older revision		Revision as of 21:46, 7 December 2025
Line 32:		Line 32:
	===Poor frame rate===		===Poor frame rate===
	====When certain particles are onscreen====		====When certain particles are onscreen====
	There is no fix for this. ~~Try~~ not to have those particles onscreen =^-^= If you don't look at them, they can't slow you down.		There is no known fix or patch for this in Oni, though we have a report of particle performance being better with OniX. Besides that, our only advice is to try not to have those particles onscreen =^-^= If you don't look at them, they can't slow you down.

	====Power management issue====		====Power management issue====

Iritscen: mentioned that we are documenting crashes with Chinese Oni on the Blam page now

2025-12-04T18:30:22Z

mentioned that we are documenting crashes with Chinese Oni on the Blam page now

← Older revision		Revision as of 18:30, 4 December 2025
Line 15:		Line 15:

	===Installer===		===Installer===
	The installer on the CD-ROM, OniSetup.exe, may no longer run as of Windows 10. You can extract the game data from the installer's data file (ONISETUP.002) using [https://www.legroom.net/software/uniextract Universal Extractor].		The installer on the CD-ROM, OniSetup.exe, may no longer run as of Windows 10. You can directly extract the game data from the installer's data file (ONISETUP.002) using [https://www.legroom.net/software/uniextract Universal Extractor].

	===Blam!s===		===Blam!s===
Line 22:		Line 22:
	[[Image:Blam!.png\|center]]		[[Image:Blam!.png\|center]]

	There are several reasons why Oni might exit with such a message. The most common cause is solved by the Daodan DLL and OniX, but if neither of those fixes it, the [[/Blam\|Blam page]] contains a thorough list of things that cause Oni to "blam".		There are several reasons why Oni might exit with such a message. The most common cause of startup crash is solved by the Daodan DLL and OniX, but if neither of those patches fixes it, the [[/Blam\|Blam page]] contains a thorough list of things that cause Oni to "blam". Chinese Oni also has several unique crash cases which are documented there.

	===Mouse/keyboard problems===		===Mouse/keyboard problems===

Iritscen: /* Things look tiny */ wording

2025-12-04T18:28:20Z

Things look tiny: wording

← Older revision		Revision as of 18:28, 4 December 2025
Line 46:		Line 46:

	====Things look tiny====		====Things look tiny====
	The Main Menu in Oni and all splashscreens are 640x480. The in-game HUD (the two circles) are also fixed in size~~. Since these are never stretched to fit the screen,~~ they will ~~look increasingly~~ small as your resolution gets higher. However [https://gamebanana.com/mods/506246 this experimental fork] of the Daodan DLL does allow the HUD to be scaled. Splashscreens ~~will become~~ 1024x768 if you install the AE mod "HD Screens".		The Main Menu in Oni and all splashscreens are 640x480 images, so they will always look small at modern resolutions. The in-game HUD (the two circles) are also fixed in size so they will become comically small and hard to read as your resolution gets higher. However [https://gamebanana.com/mods/506246 this experimental fork] of the Daodan DLL does allow the HUD to be scaled. Splashscreens remain at their original 640x480, but they can be upgraded to 1024x768 if you install the Anniversary Edition mod "HD Screens".

	If you are using the Anniversary Edition and the Installer's UI is tiny and cramped, see {{SectionLink\|Anniversary Edition/Installer\|GUI scaling}} for the fix.		If you are using the Anniversary Edition and the Installer's UI is tiny and cramped, see {{SectionLink\|Anniversary Edition/Installer\|GUI scaling}} for the fix.

Iritscen: provided variant instruction for disabling scaling in Windows 8

2025-11-28T22:14:51Z

provided variant instruction for disabling scaling in Windows 8

← Older revision		Revision as of 22:14, 28 November 2025
Line 58:		Line 58:
	:B. Turn on the High DPI scaling override for Oni:		:B. Turn on the High DPI scaling override for Oni:
	:* Right-click on Oni.exe and choose "Properties",		:* Right-click on Oni.exe and choose "Properties",
	:* go to the "Compatibility" tab,		:* go to the "Compatibility" tab, and
	:* click the "Change high DPI settings" button,		:* (Windows 8) check the "Disable display scaling on high DPI settings" box.
	:* check the "Override high DPI scaling behavior" box and set the scaling to "Application", or		:* (Windows 10, 11) click the "Change high DPI settings" button, check the "Override high DPI scaling behavior" box and set the scaling to "Application", or try the Program DPI section above that in the window.
	:* try the Program DPI section above that in the window.
	:C. Install the Daodan DLL 4.2 beta, which is newer than the version which ships with the Anniversary Edition and which adds support for display scaling:		:C. Install the Daodan DLL 4.2 beta, which is newer than the version which ships with the Anniversary Edition and which adds support for display scaling:
	:* Download it from [https://rossy.oni2.net/daodan-4.2-beta1.zip here],		:* Download it from [https://rossy.oni2.net/daodan-4.2-beta1.zip here],

Iritscen: wording

2025-11-19T22:21:45Z

wording

← Older revision		Revision as of 22:21, 19 November 2025
Line 22:		Line 22:
	[[Image:Blam!.png\|center]]		[[Image:Blam!.png\|center]]

	There are several reasons why Oni might exit with such a message. The most common cause is solved by the Daodan DLL and OniX, but if neither of those fixes ~~it…~~		There are several reasons why Oni might exit with such a message. The most common cause is solved by the Daodan DLL and OniX, but if neither of those fixes it, the [[/Blam\|Blam page]] contains a thorough list of things that cause Oni to "blam".

	~~The~~ [[/Blam\|Blam page]] contains a thorough list of things that cause Oni to "blam".

	===Mouse/keyboard problems===		===Mouse/keyboard problems===

Iritscen: explained why a user would want the 4.2 beta if they already have the Daodan DLL that comes with the AE

2025-11-19T22:16:44Z

explained why a user would want the 4.2 beta if they already have the Daodan DLL that comes with the AE

← Older revision		Revision as of 22:16, 19 November 2025
Line 18:		Line 18:

	===Blam!s===		===Blam!s===
	Have you seen this ~~message~~?		Have you seen this dialog box?

	[[Image:Blam!.png\|center]]		[[Image:Blam!.png\|center]]
Line 64:		Line 64:
	:* check the "Override high DPI scaling behavior" box and set the scaling to "Application", or		:* check the "Override high DPI scaling behavior" box and set the scaling to "Application", or
	:* try the Program DPI section above that in the window.		:* try the Program DPI section above that in the window.
	:C. Install the Daodan DLL 4.2 ~~Beta~~:		:C. Install the Daodan DLL 4.2 beta, which is newer than the version which ships with the Anniversary Edition and which adds support for display scaling:
	:* Download it from [https://rossy.oni2.net/daodan-4.2-beta1.zip here],		:* Download it from [https://rossy.oni2.net/daodan-4.2-beta1.zip here],
	:* back up the existing binkw32.dll in your <code>Oni\AE\</code> folder, and		:* back up the existing binkw32.dll in your <code>Oni\AE\</code> folder, and

Iritscen: added tip on using Draw Every Frame mode to reduce frame judder; placed off-center image in Template:SmartWrap, still to be fine-tuned

2025-07-26T03:09:08Z

added tip on using Draw Every Frame mode to reduce frame judder; placed off-center image in Template:SmartWrap, still to be fine-tuned

← Older revision		Revision as of 03:09, 26 July 2025
Line 32:		Line 32:
	Make sure the Quality slider on the Options screen is set to maximum.		Make sure the Quality slider on the Options screen is set to maximum.

	===~~Low~~ frame rate===		===Poor frame rate===
	~~;Only happens when~~ certain particles are onscreen		====When certain particles are onscreen====
	There is no fix for this. Try not to have those particles onscreen =^-^=		There is no fix for this. Try not to have those particles onscreen =^-^= If you don't look at them, they can't slow you down.

	;Power management issue		====Power management issue====
	This can be a problem on laptops. Under certain conditions the performance of the computer will decrease dramatically, for example:		This can be a problem on laptops. Under certain conditions the performance of the computer will decrease dramatically, for example:
	*if you run on battery power		*if you run on battery power
	*if you let the computer overheat		*if you let the computer overheat

			====Frame judder====
			If you're seeing multiple dropped frames per second, turn on [[Developer Mode]] and then, while playing the game, press Ctrl-Shift-G to activate Draw Every Frame mode. When the display is 60Hz, this should smooth out the frame rate. However if your display runs above 60Hz you will probably experience the game speeding up in proportion to your display's refresh rate. You may be able to stop this by applying a frame rate cap to Oni with your GPU driver.

	===Widescreen and high resolution issues===		===Widescreen and high resolution issues===
Line 51:		Line 54:
	====Rendering offset from center====		====Rendering offset from center====
	When running the game at wide resolutions (e.g. 3440x1440) it may render offset from the center of the screen:		When running the game at wide resolutions (e.g. 3440x1440) it may render offset from the center of the screen:
	{~~\| style="margin-left:auto; margin-right:auto; border-style:solid; border-width:1px; "~~		{{SmartWrap\|[[Image:Off-center render.png\|400px]]\|shadow=yes}}
	\|[[Image:Off-center render.png\|400px]]
	\|}
	There are three known solutions:		There are three known solutions:
	:A. Set Windows' display scaling to 100%.		:A. Set Windows' display scaling to 100%.

Iritscen: deleted advice on changing your GPU driver as I think it's long obsolete; added new advice on low model detail, high resolution issues

2025-03-13T22:13:50Z

deleted advice on changing your GPU driver as I think it's long obsolete; added new advice on low model detail, high resolution issues

← Older revision		Revision as of 22:13, 13 March 2025
Line 15:		Line 15:

	===Installer===		===Installer===
	The installer on the CD-ROM, OniSetup.exe, may no longer run in Windows 10. You can extract the game data from the installer's data file (ONISETUP.002) using [https://www.legroom.net/software/uniextract Universal Extractor].		The installer on the CD-ROM, OniSetup.exe, may no longer run as of Windows 10. You can extract the game data from the installer's data file (ONISETUP.002) using [https://www.legroom.net/software/uniextract Universal Extractor].

	===Blam!s===		===Blam!s===
Line 30:		Line 30:

	===Low-quality texturing/models===		===Low-quality texturing/models===
	~~There are several things that can be go wrong, from fuzzy textures to very-low-detail character models. 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 :)~~		Make sure the Quality slider on the Options screen is set to maximum.

	===Low frame rate===		===Low frame rate===
	;Power management		;Only happens when certain particles are onscreen
	This can be a problem on ~~notebooks~~. Under certain conditions, the performance of the computer will decrease dramatically, for example:		There is no fix for this. Try not to have those particles onscreen =^-^=

			;Power management issue
			This can be a problem on laptops. Under certain conditions the performance of the computer will decrease dramatically, for example:
	*if you run on battery power		*if you run on battery power
	*if you let the computer overheat		*if you let the computer overheat
	~~;Driver issue~~

	~~First let's make sure that your graphic card has Direct3D and AGP acceleration enabled.~~
	Click on Start, Run, type "dxdiag", and press OK. You will see now various information about your DirectX and your computer hardware/software. Click on display, and check the Direct3D/AGP acceleration checkbox. If it is off, try enabling it, and if it is cannot be enabled, your graphics card may have not have this option, or Windows is using your card as [[wikipedia:Peripheral_Component_Interconnect\|PCI]] instead of AGP. In this case, try <u>updating or re-installing all your motherboard drivers.</u>

	~~[[Image:Direct3d acceleration.jpg\|thumb\|200px\|center\|Make sure that you have acceleration enabled.]]~~

	Now, if acceleration is enabled like in the picture above, try installing or updating your graphics drivers; don't use the ones that come with Windows. If you have an 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; these seemed to work better with my old card.

	~~Nvidia users can download old drivers [https://www.nvidia.com/en-us~~/~~drivers/ here]. ATI users~~, ~~try [https://www.amd.com/en/support here] (look for~~ the ~~"Previous Drivers" link after finding~~ your ~~card)~~.		===Widescreen and high resolution issues===
			To get Oni to support widescreen/high resolutions, install the Anniversary Edition or just the Daodan DLL and the resolutions supported by your system should appear on Oni's Options screen.

	~~See~~ also "~~Bad texturing~~"~~, above~~.		====Things look tiny====
			The Main Menu in Oni and all splashscreens are 640x480. The in-game HUD (the two circles) are also fixed in size. Since these are never stretched to fit the screen, they will look increasingly small as your resolution gets higher. However [https://gamebanana.com/mods/506246 this experimental fork] of the Daodan DLL does allow the HUD to be scaled. Splashscreens will become 1024x768 if you install the AE mod "HD Screens".

	~~===Widescreen===~~		If you are using the Anniversary Edition and the Installer's UI is tiny and cramped, see {{SectionLink\|Anniversary Edition/Installer\|GUI scaling}} for the fix.
	~~To get Oni to support widescreen resolutions~~, ~~install the~~ Anniversary Edition ~~or just~~ the ~~Daodan DLL~~.

	====Rendering offset from center====		====Rendering offset from center====

Iritscen: added Linux section that simply points to our Playing in Linux article

2025-02-22T20:11:04Z

added Linux section that simply points to our Playing in Linux article

← Older revision		Revision as of 20:11, 22 February 2025
Line 1:		Line 1:
	{{UpdatedForOniX\|1.0.0}}		{{UpdatedForOniX\|1.0.0}}
	==Mac~~-specific~~==		==Mac==
	See the [[FERAL\|Intel Mac build]]'s page for Mac-specific issues.		See the [[FERAL\|Intel Mac build]]'s page for Mac-specific issues.

	==~~Windows~~-specific==		==Linux==
			See {{SectionLink\|Playing in Linux\|Troubleshooting}} for Linux-specific issues.

			==Windows==
	Most of the problems in Oni itself can be solved by installing a community patch:		Most of the problems in Oni itself can be solved by installing a community patch:
	* The [[Daodan DLL]] (see that page for manual installation instructions),		* The [[Daodan DLL]] (see that page for manual installation instructions),