Oni (folder): Difference between revisions

From OniGalore
No edit summary
m (+TOC)
 
(20 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
{| border="1" cellpadding="5" cellspacing="0" style="margin-left:auto; margin-right:auto;"
: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" align="center"
|+
|+
!
!<!--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]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/debugger.txt|debugger.txt]]</center>
|colspan="3"|<center>[[Oni (folder)/debugger.txt|debugger.txt]]</center>
|Error log; only created if an error occurs while running Oni
|Error log; created first time that an error occurs while running Oni
|-
|-
|[[Image:Aqua Dot-Red.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Customizing/Binding|key_config.txt]]</center>
|colspan="3"|<center>[[Oni (folder)/key_config.txt|key_config.txt]]</center>
|Key configuration file; if it's missing, Oni will generate a default
|Key configuration file; if it's missing, Oni will generate a fresh copy
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>[[XML:CRSA|lvl_*_*_corpse.dat]]</center>
|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]]
|[[AE:EXE|Oni.exe]]
|<center>Oni.exe</center>
|[[AE:OMNI|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]]
|ONI.url
|<center>ONI.url</center>
|bgcolor=gray|
|bgcolor=lightgray|
|URL for [http://oni.bungie.com oni.bungie.com] (subdomain is 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]]
|RegisterOni.url
|<center>RegisterOni.url</center>
|bgcolor=gray|
|bgcolor=lightgray|
|[http://www.godgames.com/main.php?section=support&page=registration URL] for godgames.com (site is 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; dumped (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
Aqua Dot-Red.png = needed to run Oni; Aqua Dot-Yellow.png = created by Oni; Aqua Dot-Blue.png = 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
Aqua Dot-Red.png
GameDataFolder
GameDataFolderX
 A subfolder with movies, scripts and binary resources
Files
Aqua Dot-Red.png
binkw32.dll
bink-ffplay.exe / binkplay.exe
 Allows Oni to play Bink movies; Daodan DLL also poses as binkw32.dll
Aqua Dot-Yellow.png
debugger.txt
 Error log; created first time that an error occurs while running Oni
Aqua Dot-Yellow.png
key_config.txt
 Key configuration file; if it's missing, Oni will generate a fresh copy
Aqua Dot-Yellow.png
lvl_*_*_corpse.dat
 Developer Mode corpse file; created by BSL command make_corpse
Aqua Dot-Blue.png
license.txt
 Software license and warranty agreement
Aqua Dot-Red.png
Oni.exe
Oni(.app)
OniX.exe
 The game application
Aqua Dot-Blue.png
ONI.url
 Points to http://oni.bungie.com (defunct)
Aqua Dot-Yellow.png
persist.dat
 Save-game file; created by Oni on first run
Aqua Dot-Blue.png
readme.txt
Oni ReadMe
OniX read-me.pdf
 Read-me file
Aqua Dot-Blue.png
RegisterOni.url
 Points to http://www.godgames.com/main.php?section=support&page=registration, defunct
Aqua Dot-Yellow.png
saved_film*.dat
 Developer Mode film; created by recording a film with F9 and F10
Aqua Dot-Yellow.png
screen_shot*.bmp
 Screenshots taken with the screenshot key or with the Ctrl+Shift+L Dev Mode hotkey
Aqua Dot-Yellow.png
script_commands.txt
 List of BSL commands & variables; created by BSL command dump_docs
Aqua Dot-Yellow.png
script_debug.txt
 Log of BSL functions called during gameplay; dumped if Oni is run with -debugfiles
Aqua Dot-Yellow.png
startup.txt
 Event log; overwritten every time Oni is run
Aqua Dot-Blue.png
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"