Oni (folder): Difference between revisions

From OniGalore
Jump to navigation Jump to search
m (persist.dat is not written to only upon quitting Oni, that's misleading if not totally wrong; fixed red link (...))
m (+link to Oni)
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This is a browseable representation of Oni's file hierarchy under Windows and the Mac OS.  
{{UpdatedForOniX|1.0.0}}
:The default location for this folder in Windows is '''C:\Program Files\Oni''', and in Mac OS X it is '''/Applications/Oni'''.
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.


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'''


'''About the icons'''<br>
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.
[[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.
 
;Note
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.
: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.
 
:This list is not exhaustive, either. 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" align="center"
!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>
|}
 
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).
 
{| 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>[[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-Red.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Customizing/Binding|key_config.txt]]</center>
|colspan="3"|<center>[[OBD: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]]
|[[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] (site 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 if missing
|-
|-
|[[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 still exists, but link is obsolete)
|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]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[BSL|script_commands.txt]]</center>
|colspan="3"|<center>screen_shot*.bmp</center>
|List of BSL commands & variables; created by [[BSL]] command [[dump_docs]]
|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>[[Oni (folder)/script_debug.txt|script_debug.txt]]</center>
|colspan="3"|<center>[[BSL|script_commands.txt]]</center>
|Log of BSL "contexts"; dumped if Oni is run with [[Customizing#Command-line arguments|-debugfiles]]
|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)/startup.txt|startup.txt]]</center>
|colspan="3"|<center>script_debug.txt</center>
|Event log; dumped (overwritten) every time Oni is run
|Log of BSL functions called during gameplay; dumped if Oni is run with [[Customizing#Command-line arguments|-debugfiles]]
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>[[Oni (folder)/startup.txt|startup.txt]]</center>
|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]]

Latest revision as of 15:23, 13 April 2024

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

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.

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 if missing
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=42618"