Oni (folder): Difference between revisions

From OniGalore
m (+TOC)
(tweaked table until I got everything to fit on a row of a single line height; added trivia about the Windows installer that I learned recently; stopped using Th template)
 
Line 1: Line 1:
{{UpdatedForOniX|1.0.0}}
{{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.
This is a browseable representation of an '''[[Oni]]''' installation'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 and 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==
==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 (x86)\Oni\''' – it was originally '''C:\Program Files\Oni\''' on 32-bit systems, but modern Windows has a hack for old program installers which changes Oni's installer to point to the x86 folder by default. The Russian localization's 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.
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==
==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.
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==
==Directory==
Line 20: Line 20:


{| 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 column-->
!<!--aqua dots-->
!width=100px|Windows
!Windows
!width=85px|macOS
!macOS
!width=180px|[[OniX]]
![[OniX]]
!width=585px|Description
!Description
|-bgcolor="#E9E9E9"
{{th}}
!colspan="5"|Folders
!colspan="5"|Folders
|-
|-
Line 33: Line 32:
|<center>GameDataFolderX</center>
|<center>GameDataFolderX</center>
|A subfolder with movies, scripts and binary resources
|A subfolder with movies, scripts and binary resources
{{th}}
|-bgcolor="#E9E9E9"
!colspan="5"|Files
!colspan="5"|Files
|-
|-
Line 39: Line 38:
|<center>binkw32.dll</center>
|<center>binkw32.dll</center>
|bgcolor=lightgray|
|bgcolor=lightgray|
|<center>bink-ffplay.exe / binkplay.exe</center>
|<center>bink-ffplay.exe<ref>Name of the player in the OniX build for modern Windows. The player for the legacy OniX build is called binkplay.exe.</ref></center>
|Allows Oni to play Bink movies; [[Daodan DLL]] also poses as binkw32.dll
|Allows Oni to play Bink movies; [[Daodan DLL]] also poses as binkw32.dll
|-
|-
Line 52: Line 51:
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>[[XML:CRSA|lvl_*_*_corpse.dat]]</center>
|colspan="3"|<center>[[XML:CRSA|lvl_*_*_corpse.dat]]</center>
|Developer Mode corpse file; created by BSL command [[make_corpse]]
|[[Developer Mode]] corpse file; created by BSL command [[make_corpse]]
|-
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
Line 78: Line 77:
|[[Image:Aqua Dot-Blue.png]]
|[[Image:Aqua Dot-Blue.png]]
|<center>[[Oni (folder)/readme.txt|readme.txt]]</center>
|<center>[[Oni (folder)/readme.txt|readme.txt]]</center>
|<center>[[Oni (folder)/Oni ReadMe|Oni ReadMe]]</center>
|<center>{{FontSize|95|[[Oni (folder)/Oni ReadMe|Oni ReadMe]]}}</center>
|<center>OniX read-me.pdf</center>
|<center>OniX read-me.pdf</center>
|Read-me file
|Read-me file
Line 86: Line 85:
|bgcolor=lightgray|
|bgcolor=lightgray|
|bgcolor=lightgray|
|bgcolor=lightgray|
|Points to <nowiki>http://www.godgames.com/main.php?section=support&page=registration</nowiki>, defunct
|Points to {{FontSize|85|<nowiki>http://www.godgames.com/main.php?section=support&page=registration</nowiki>}} (defunct)
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
Line 94: Line 93:
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]
|colspan="3"|<center>screen_shot*.bmp</center>
|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]]
|Screenshots taken with the [[Customizing/Binding#screenshot|screenshot key]] or with the Ctrl+Shift+L Dev Mode hotkey
|-
|-
|[[Image:Aqua Dot-Yellow.png]]
|[[Image:Aqua Dot-Yellow.png]]

Latest revision as of 17:06, 6 April 2026

This is a browseable representation of an Oni installation'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 and 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 (x86)\Oni\ – it was originally C:\Program Files\Oni\ on 32-bit systems, but modern Windows has a hack for old program installers which changes Oni's installer to point to the x86 folder by default. The Russian localization's 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[1]
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
  1. Name of the player in the OniX build for modern Windows. The player for the legacy OniX build is called binkplay.exe.