Oni (folder): Difference between revisions

Latest revision as of 04:56, 17 April 2025

This is a browseable representation of Oni's file hierarchy under Windows and macOS. You can use it to verify that you have all the needed files; it can also educate you on the details of what each file does, or how Oni finds its game data. Click on a folder's name to go down to that level of the hierarchy; click on a file's name to read more about that file.

Installation location

The default location for this folder in Windows is C:\Program Files\Oni, or C:\Program Files (x86)\Oni on 64-bit systems. The Russian installer adds another level with the publisher's name: C:\Program Files (x86)\Buka\Oni.

There is no default location on Macs because modern Macs cannot run the installer on the CD-ROM, and so users must drag the "Oni ƒ" folder manually to their hard drive.

Warning for non-admins

If you are not logged into Windows as an administrator, Oni will save persist.dat, debugger.txt, key_config.txt and startup.txt in C:\Users\<username>\AppData\Local\VirtualStore\Program Files\Oni. This does not apply to an installation of the AE or a manual installation of Oni. Right-clicking Oni.exe and choosing "Run as administrator" will cause Oni to save the aforementioned files in the Oni folder itself. However this will mean you have two save-game files, with either one being written to depending on whether you run Oni as admin or not.

Directory

Legend
= needed to run Oni; = created by Oni; = unneeded files

Your initial Oni installation will probably have all the red and blue files. For files marked with yellow, Oni may not have seen a need to create them yet (follow that file name's link for more info).


	Windows	macOS	OniX	Description
Folders
	GameDataFolder		GameDataFolderX	A subfolder with movies, scripts and binary resources
Files
	binkw32.dll		bink-ffplay.exe / binkplay.exe	Allows Oni to play Bink movies; Daodan DLL also poses as binkw32.dll
	debugger.txt			Error log; created first time that an error occurs while running Oni
	key_config.txt			Key configuration file; if it's missing, Oni will generate a fresh copy
	lvl___corpse.dat			Developer Mode corpse file; created by BSL command make_corpse
	license.txt			Software license and warranty agreement
	Oni.exe	Oni(.app)	OniX.exe	The game application
	ONI.url			Points to http://oni.bungie.com (defunct)
	persist.dat			Save-game file; created by Oni on first run
	readme.txt	Oni ReadMe	OniX read-me.pdf	Read-me file
	RegisterOni.url			Points to http://www.godgames.com/main.php?section=support&page=registration, defunct
	saved_film*.dat			Developer Mode film; created by recording a film with F9 and F10
	screen_shot*.bmp			Screenshots taken with the screenshot key or with the Ctrl+Shift+L Dev Mode hotkey
	script_commands.txt			List of BSL commands & variables; created by BSL command dump_docs
	script_debug.txt			Log of BSL functions called during gameplay; dumped if Oni is run with -debugfiles
	startup.txt			Event log; overwritten every time Oni is run
	Uninst.isu			(or "Uninstal.log") Record used by Windows to uninstall Oni

@@ Line 2: / Line 2: @@
 This is a browseable representation of '''[[Oni]]''''s file hierarchy under Windows and macOS. You can use it to verify that you have all the needed files; it can also educate you on the details of what each file does, or how Oni finds its game data. Click on a folder's name to go down to that level of the hierarchy; click on a file's name to read more about that file.
-The default location for this folder in Windows is '''C:\Program Files\Oni''', or '''C:\Program Files (x86)\Oni''' on 64-bit systems. The Russian installer adds another level with the publisher's name: '''C:\Program Files (x86)\Buka\Oni'''
+==Installation location==
+The default location for this folder in Windows is '''C:\Program Files\Oni''', or '''C:\Program Files (x86)\Oni''' on 64-bit systems. The Russian installer adds another level with the publisher's name: '''C:\Program Files (x86)\Buka\Oni'''.
 There is no default location on Macs because modern Macs cannot run the installer on the CD-ROM, and so users must drag the "Oni ƒ" folder manually to their hard drive.
-In Windows Vista, persist.dat, debugger.txt, key_config.txt and startup.txt will be located in '''C:\Users\<username>\AppData\Local\VirtualStore\Program Files\Oni''' due to the way Vista handles installations. This does not apply to an installation of the [[AE]] or a manual installation of Oni.
+==Warning for non-admins==
+If you are not logged into Windows as an administrator, Oni will save persist.dat, debugger.txt, key_config.txt and startup.txt in '''C:\Users\<username>\AppData\Local\VirtualStore\Program Files\Oni'''. This does not apply to an installation of the [[AE]] or a manual installation of Oni. Right-clicking Oni.exe and choosing "Run as administrator" will cause Oni to save the aforementioned files in the Oni folder itself. However this will mean you have two save-game files, with either one being written to depending on whether you run Oni as admin or not.
+==Directory==
 {| border="1" cellpadding="5" cellspacing="0" style="margin-left:auto; margin-right:auto;"
 !Legend
@@ Line 24: / Line 27: @@
 !Description
 {{th}}
-!colspan="5" |Folders
+!colspan="5"|Folders
 |-
 |[[Image:Aqua Dot-Red.png]]
@@ Line 31: / Line 34: @@
 |A subfolder with movies, scripts and binary resources
 {{th}}
-!colspan="5" |Files
+!colspan="5"|Files
 |-
 |[[Image:Aqua Dot-Red.png]]
@@ Line 48: / Line 51: @@
 |-
 |[[Image:Aqua Dot-Yellow.png]]
-|colspan="3"|<center>[[OBD:CRSA|lvl_*_*_corpse.dat]]</center>
+|colspan="3"|<center>[[XML:CRSA|lvl_*_*_corpse.dat]]</center>
 |Developer Mode corpse file; created by BSL command [[make_corpse]]
 |-
@@ Line 67: / Line 70: @@
 |bgcolor=lightgray|
 |bgcolor=lightgray|
-|Points to <nowiki>http://oni.bungie.com</nowiki>, defunct
+|Points to <nowiki>http://oni.bungie.com</nowiki> (defunct)
 |-
 |[[Image:Aqua Dot-Yellow.png]]
 |colspan="3"|<center>[[Oni (folder)/persist.dat|persist.dat]]</center>
-|Save-game file; created by Oni if missing
+|Save-game file; created by Oni on first run
 |-
 |[[Image:Aqua Dot-Blue.png]]