OniGalore

Oni (folder): Difference between revisions

m (link fixes; no point in linking to AE:EXE when it's going to confuse a newbie)
m (+TOC)
 
(17 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is a browseable representation of Oni's file hierarchy under Windows and the Mac OS. 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.
{{UpdatedForOniX|1.0.0}}
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.
__TOC__
==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'''.


:The default location for this folder in Windows is '''C:\Program Files\Oni''', and in Mac OS X it is '''/Applications/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.


For Windows Vista, four files - '''persist.dat''', '''debugger.txt''', '''key_config.txt''' & '''startup.txt''' are instead located at '''C:\Users\*your username*\AppData\Local\VirtualStore\Program Files\Oni''' by virtue of OS's handling of the game's installation. This does not apply to Oni: AE that is installed on Vista.
==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.


'''About the icons'''<br>
==Directory==
[[Image:Aqua Dot-Red.png]] = needed to run Oni (created while installing); [[Image:Aqua Dot-Yellow.png]] = created while running Oni; [[Image:Aqua Dot-Blue.png]] = less-important files.
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:auto; margin-right:auto;"
!Legend
|-
|<center>[[Image:Aqua Dot-Red.png]] = needed to run Oni; [[Image:Aqua Dot-Yellow.png]] = created by Oni; [[Image:Aqua Dot-Blue.png]] = unneeded files</center>
|}


Not all Oni players may see all the files in this list; if they are marked with yellow, Oni may not have seen a need to create them (read about that file for more info); if they are blue, then don't even worry about them if they're missing.
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).


;Note
:This list is not exhaustive. Screenshots and "films" are dumped to this folder, with generic filenames. Also, a variety of debugging/authoring information can be dumped on demand, either from scripts or the [[Dev Mode]] console.
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:auto; margin-right:auto;"
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:auto; margin-right:auto;"
|+
|+
!
!<!--aqua dots-->
!Windows
!Windows
!Mac OS X
!macOS
![[OniX]]
!Description
!Description
{{th}}
{{th}}
!colspan="4" |Folders
!colspan="5"|Folders
|-
|-
|[[Image:Aqua Dot-Red.png]]
|[[Image:Aqua Dot-Red.png]]
|colspan="2"|<center>[[Oni (folder)/GameDataFolder|GameDataFolder]]</center>
|colspan="2"|<center>[[Oni (folder)/GameDataFolder|GameDataFolder]]</center>
|<center>GameDataFolderX</center>
|A subfolder with movies, scripts and binary resources
|A subfolder with movies, scripts and binary resources
{{th}}
{{th}}
!colspan="4" |Files
!colspan="5"|Files
|-
|-
|[[Image:Aqua Dot-Red.png]]
|[[Image:Aqua Dot-Red.png]]
|binkw32.dll
|<center>binkw32.dll</center>
|bgcolor=gray|
|bgcolor=lightgray|
|Allows Windows Oni to play Bink movies
|<center>bink-ffplay.exe / binkplay.exe</center>
|Allows Oni to play Bink movies; [[Daodan DLL]] also poses as binkw32.dll
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>[[Oni (folder)/debugger.txt|debugger.txt]]</center>
|Error log; created first time that an error occurs while running Oni
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/debugger.txt|debugger.txt]]</center>
|colspan="3"|<center>[[Oni (folder)/key_config.txt|key_config.txt]]</center>
|Error log; only created if an error occurs while running Oni
|Key configuration file; if it's missing, Oni will generate a fresh copy
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Customizing/Binding|key_config.txt]]</center>
|colspan="3"|<center>[[XML:CRSA|lvl_*_*_corpse.dat]]</center>
|Key configuration file; if it's missing, Oni will generate a default
|Developer Mode corpse file; created by BSL command [[make_corpse]]
|-
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
|[[Oni (folder)/license.txt|license.txt]]
|<center>[[Oni (folder)/license.txt|license.txt]]</center>
|bgcolor=gray|
|bgcolor=lightgray|
|bgcolor=lightgray|
|Software license and warranty agreement
|Software license and warranty agreement
|-
|-
|[[Image:Aqua Dot-Red.png]]
|[[Image:Aqua Dot-Red.png]]
|Oni.exe
|<center>Oni.exe</center>
|[[History of Mac Oni|Oni]]
|<center>[[History of Mac Oni|Oni(.app)]]</center>
|The game's executable
|<center>OniX.exe</center>
|The game application
|-
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
|[http://oni.bungie.com ONI.url]
|<center>ONI.url</center>
|bgcolor=gray|
|bgcolor=lightgray|
|URL for Oni subdomain on Bungie.com (defunct)
|bgcolor=lightgray|
|Points to <nowiki>http://oni.bungie.com</nowiki> (defunct)
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/persist.dat|persist.dat]]</center>
|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]]
|[[Image:Aqua Dot-Blue.png]]
|[[Oni (folder)/readme.txt|readme.txt]]
|<center>[[Oni (folder)/readme.txt|readme.txt]]</center>
|[[Oni (folder)/Oni ReadMe|Oni ReadMe]]
|<center>[[Oni (folder)/Oni ReadMe|Oni ReadMe]]</center>
|Readme file
|<center>OniX read-me.pdf</center>
|Read-me file
|-
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
|[http://www.godgames.com/main.php?section=support&page=registration RegisterOni.url]
|<center>RegisterOni.url</center>
|bgcolor=gray|
|bgcolor=lightgray|
|URL for godgames.com game registration (defunct)
|bgcolor=lightgray|
|Points to <nowiki>http://www.godgames.com/main.php?section=support&page=registration</nowiki>, defunct
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>[[XML:FILM|saved_film*.dat]]</center>
|Developer Mode film; created by recording a film with F9 and F10
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>screen_shot*.bmp</center>
|Screenshots taken with the [[Customizing/Binding#screenshot|screenshot key]] or with the Ctrl+Shift+L  [[Developer_Mode#Hotkeys|Dev Mode hotkey]]
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[BSL|script_commands.txt]]</center>
|colspan="3"|<center>[[BSL|script_commands.txt]]</center>
|List of BSL commands & variables; created by [[BSL]] command [[dump_docs]]
|List of [[BSL]] commands & variables; created by BSL command [[dump_docs]]
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/script_debug.txt|script_debug.txt]]</center>
|colspan="3"|<center>script_debug.txt</center>
|Log of BSL "contexts"; dumped if Oni is run with [[Customizing#Command-line arguments|-debugfiles]]
|Log of BSL functions called during gameplay; dumped if Oni is run with [[Customizing#Command-line arguments|-debugfiles]]
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/startup.txt|startup.txt]]</center>
|colspan="3"|<center>[[Oni (folder)/startup.txt|startup.txt]]</center>
|Event log; overwritten every time Oni is run
|Event log; overwritten every time Oni is run
|-
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
|Uninst.isu
|<center>Uninst.isu</center>
|bgcolor=gray|
|bgcolor=lightgray|
|Record used by Windows to uninstall Oni (or "Uninstal.log")
|bgcolor=lightgray|
|(or "Uninstal.log") Record used by Windows to uninstall Oni
|}
|}


[[Category:Game directory map]]
[[Category:Game directory map]]

Latest revision as of 22:40, 3 February 2026

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
Retrieved from "https://wiki.oni2.net/w/index.php?title=Oni_(folder)&oldid=46563"