Oni (folder)/GameDataFolder: Difference between revisions

From OniGalore
(→‎Game resources: nicified & cross-referenced)
(moved one note to IGMD; added notes on the movies and on the level numbering gaps; removed all that unnecessary bold, what an eyesore)
 
(30 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==GameDataFolder==
'''GameDataFolder''' (commonly called "GDF") is a subfolder of the main Oni folder. It holds the following:
(Default location on PC is '''C:\Program Files\Oni\GameDataFolder''')
*Oni's game data, in binary format (see [[OBD]] for more info)
*the level logic, in plain-text (in the IGMD subfolder; see [[BSL]] for more info)
*the intro and outro animated sequences, in the Bink video format


This is where all of Oni's "game data" resources are stored.
First we show the purpose of each file in this folder – but don't miss our helpful notes below this directory listing.
===Movie files in BINK format===
*'''intro.bik''' : the game's intro sequence (animation)
*'''outro.bik''' : the game's outro sequence (animation)


===Game resources===
==Directory listing==
{|
You should have all the files below in your GameDataFolder, though the movie files are optional (see note at bottom). The "PS2" column shows the numbers assigned to each file name on disc; the .raw and .sep file for each level are in subdirectories titled 20/ and 21/. Beside each set of level files, we list the subfolders of IGMD which hold the corresponding level logic. '''SPOILER WARNING''': The "Chapter" column links to summaries and analyses of Oni's storyline.
|
 
{|{{table}}
{| class="wikitable" style="margin-left:auto; margin-right:auto;"
|-BGCOLOR="#E9E9E9"
|-
!Chapter
|colspan="3" align="center"|'''File name'''
!Name
|rowspan="2" align="center"|'''Level logic folder'''
![[OBD:Oni_Binary_Data | Binary files]] (PC)
|rowspan="2" align="center"|'''[[Chapters|Chapter]]'''
!Binary files (Mac)
|rowspan="2" align="center"|'''Location (seen in Load Game dialog)'''
!Level logic folder
|-
|align="center"|'''Windows'''
|align="center"|'''Mac'''
|align="center"|'''PS2'''
|-
|colspan="2"|<center>[[IGMD|IGMD/]]</center>
|valign=top|1
| <center>--</center>
|colspan=2 align=center|Contains all level logic
|-
|-
|colspan="2"|<center>[[:Category:Intro sequence|intro.bik]]</center>
|valign=top|2
| <center>--</center>
|colspan=2 align=center|Movie plays when Oni is launched
|-
|valign=top|level0_Final.dat<br>level0_Final.raw
|level0_Final.dat<br>level0_Final.raw<br>level0_Final.sep
|3<br>20/1<br>21/1
|[[IGMD/global]]
|colspan=2 align=center|Used in all Chapters (see notes below on "level0_Final" and "IGMD/global")
|-
|valign=top|level1_Final.dat<br>level1_Final.raw
|level1_Final.dat<br>level1_Final.raw<br>level1_Final.sep
|11<br>20/9<br>21/9
|[[IGMD/EnvWarehouse]]
|{{C|0|0: COMBAT TRAINING}}<br>{{C|1|1: TRIAL RUN}}
|{{C|0|0: COMBAT TRAINING}}<br>{{C|1|1: TRIAL RUN}}
|TCTF Training<br>Syndicate Warehouse
|TCTF Training<br>Syndicate Warehouse
|level1_Final.dat<br>level1_Final.raw
|level1_Final.dat<br>level1_Final.raw<br>level1_Final.sep
|[[IGMD|IGMD]]\[[IGMD/EnvWarehouse|EnvWarehouse]]
|-
|-
|valign=top|level2_Final.dat<br>level2_Final.raw
|level2_Final.dat<br>level2_Final.raw<br>level2_Final.sep
|12<br>20/10<br>21/10
|[[IGMD/manplant]]
|{{C|2|2: ENGINES OF EVIL}}
|{{C|2|2: ENGINES OF EVIL}}
|Manufacturing Plant
|Manufacturing Plant
|level2_Final.dat<br>level2_Final.raw
|level2_Final.dat<br>level2_Final.raw<br>level2_Final.sep
|[[IGMD|IGMD]]\[[IGMD/manplant|manplant]]
|-
|-
|valign=top|level3_Final.dat<br>level3_Final.raw
|level3_Final.dat<br>level3_Final.raw<br>level3_Final.sep
|13<br>20/11<br>21/11
|[[IGMD/lab]]
|{{C|3|3: PUZZLE PIECES}}
|{{C|3|3: PUZZLE PIECES}}
|Bio-Research Lab
|Bio-Research Lab
|level3_Final.dat<br>level3_Final.raw
|level3_Final.dat<br>level3_Final.raw<br>level3_Final.sep
|[[IGMD|IGMD]]\[[IGMD/lab|lab]]
|-
|-
|valign=top|level4_Final.dat<br>level4_Final.raw
|level4_Final.dat<br>level4_Final.raw<br>level4_Final.sep
|14<br>20/12<br>21/12
|[[IGMD/Airport]]
|{{C|4|4: TIGER BY THE TAIL}}
|{{C|4|4: TIGER BY THE TAIL}}
|Airport Assault
|Airport Assault
|level4_Final.dat<br>level4_Final.raw
|level4_Final.dat<br>level4_Final.raw<br>level4_Final.sep
|[[IGMD|IGMD]]\[[IGMD/Airport|Airport]]
|-
|-
|valign=top|level6_Final.dat<br>level6_Final.raw
|level6_Final.dat<br>level6_Final.raw<br>level6_Final.sep
|15<br>20/13<br>21/13
|[[IGMD/Airport_III]]
|{{C|5|5: HOT PURSUIT}}
|{{C|5|5: HOT PURSUIT}}
|Airport Cargo Hangars
|Airport Cargo Hangars
|level6_Final.dat<br>level6_Final.raw
|level6_Final.dat<br>level6_Final.raw<br>level6_Final.sep
|[[IGMD|IGMD]]\[[IGMD/Airport_III|Airport_III]]
|-
|-
|valign=top|level8_Final.dat<br>level8_Final.raw
|level8_Final.dat<br>level8_Final.raw<br>level8_Final.sep
|16<br>20/14<br>21/14
|[[IGMD/tctf]]
|{{C|6|6: COUNTERATTACK}}
|{{C|6|6: COUNTERATTACK}}
|TCTF Regional HQ
|TCTF Regional HQ
|level8_Final.dat<br>level8_Final.raw
|level8_Final.dat<br>level8_Final.raw<br>level8_Final.sep
|[[IGMD|IGMD]]\[[IGMD/tctf|tctf]]
|-
|-
|valign=top|level9_Final.dat<br>level9_Final.raw
|level9_Final.dat<br>level9_Final.raw<br>level9_Final.sep
|17<br>20/15<br>21/15
|[[IGMD/power]]
|{{C|7|7: A FRIEND IN NEED}}
|{{C|7|7: A FRIEND IN NEED}}
|Atmospheric Conversion<br>Center (exterior)
|Atmospheric Conversion Center (exterior)
|level9_Final.dat<br>level9_Final.raw
|level9_Final.dat<br>level9_Final.raw<br>level9_Final.sep
|[[IGMD|IGMD]]\[[IGMD/power|power]]
|-
|-
|valign=top|level10_Final.dat<br>level10_Final.raw
|level10_Final.dat<br>level10_Final.raw<br>level10_Final.sep
|4<br>20/2<br>21/2
|[[IGMD/power_II]]
|{{C|8|8: AN INNOCENT LIFE}}
|{{C|8|8: AN INNOCENT LIFE}}
|Atmospheric Conversion<br>Center (interior)
|Atmospheric Conversion Center (interior)
|level10_Final.dat<br>level10_Final.raw
|level10_Final.dat<br>level10_Final.raw<br>level10_Final.sep
|[[IGMD|IGMD]]\[[IGMD/power_II|power_II]]
|-
|-
|valign=top|level11_Final.dat<br>level11_Final.raw
|level11_Final.dat<br>level11_Final.raw<br>level11_Final.sep
|5<br>20/3<br>21/3
|[[IGMD/state]]
|{{C|9|9: TRUTH AND CONSEQUENCES}}
|{{C|9|9: TRUTH AND CONSEQUENCES}}
|Regional State Building
|Regional State Building
|level11_Final.dat<br>level11_Final.raw
|level11_Final.dat<br>level11_Final.raw<br>level11_Final.sep
|[[IGMD|IGMD]]\[[IGMD/state|state]]
|-
|-
|valign=top|level12_Final.dat<br>level12_Final.raw
|level12_Final.dat<br>level12_Final.raw<br>level12_Final.sep
|6<br>20/4<br>21/4
|[[IGMD/roof]]
|{{C|10|10: CAT AND MOUSE}}
|{{C|10|10: CAT AND MOUSE}}
|Rooftops
|Rooftops
|level12_Final.dat<br>level12_Final.raw
|level12_Final.dat<br>level12_Final.raw<br>level12_Final.sep
|[[IGMD|IGMD]]\[[IGMD/roof|roof]]
|-
|-
|valign=top|level13_Final.dat<br>level13_Final.raw
|level13_Final.dat<br>level13_Final.raw<br>level13_Final.sep
|7<br>20/5<br>21/5
|[[IGMD/dream_lab]]
|{{C|11|11: DREAM DIVER}}
|{{C|11|11: DREAM DIVER}}
|Doctor Hasegawa's Lab
|Doctor Hasegawa's Lab
|level13_Final.dat<br>level13_Final.raw
|level13_Final.dat<br>level13_Final.raw<br>level13_Final.sep
|[[IGMD|IGMD]]\[[IGMD/dream_lab|dream_lab]]
|-
|-
|valign=top|level14_Final.dat<br>level14_Final.raw
|level14_Final.dat<br>level14_Final.raw<br>level14_Final.sep
|8<br>20/6<br>21/6
|[[IGMD/neuro]]
|{{C|12|12: SINS OF THE FATHER}}
|{{C|12|12: SINS OF THE FATHER}}
|TCTF Science Prison
|TCTF Science Prison
|level14_Final.dat<br>level14_Final.raw
|level14_Final.dat<br>level14_Final.raw<br>level14_Final.sep
|[[IGMD|IGMD]]\[[IGMD/neuro|neuro]]
|-
|-
|valign=top|level18_Final.dat<br>level18_Final.raw
|level18_Final.dat<br>level18_Final.raw<br>level18_Final.sep
|9<br>20/7<br>21/7
|[[IGMD/tctf_ii]]
|{{C|13|13: PHOENIX RISING}}
|{{C|13|13: PHOENIX RISING}}
|TCTF Regional HQ (redux)
|TCTF Regional HQ (redux)
|level18_Final.dat<br>level18_Final.raw
|level18_Final.dat<br>level18_Final.raw<br>level18_Final.sep
|[[IGMD|IGMD]]\[[IGMD/tctf_ii|tctf_ii]]
|-
|-
|valign=top|level19_Final.dat<br>level19_Final.raw
|level19_Final.dat<br>level19_Final.raw<br>level19_Final.sep
|10<br>20/8<br>21/8
|[[IGMD/compound]]
|{{C|14|14: DAWN OF THE CHRYSALIS}}
|{{C|14|14: DAWN OF THE CHRYSALIS}}
|Syndicate Mountain Compound
|Syndicate Mountain Compound
|level19_Final.dat<br>level19_Final.raw
|level19_Final.dat<br>level19_Final.raw<br>level19_Final.sep
|[[IGMD|IGMD]]\[[IGMD/compound|compound]]
|-
|-
|ALL (global)
|colspan="2"|<center>[[:Category:Outro sequence|outro.bik]]</center>
|
|18
|level0_Final.dat<br>level0_Final.raw
| <center>--</center>
|level1_Final.dat<br>level1_Final.raw<br>level1_Final.sep
|colspan=2 align=center|Movie plays when Oni is beaten
|[[IGMD|IGMD]]\[[IGMD/global|global]]
|}
|}
|}
The [[IGMD/global|IGMD\global]] script folder is not present at installation.


==Tips==
==Notes==
Moving the movie (.bik) files away from '''GameDataFolder''' or deleting them won't have any impact on the game. Useful if you want to skip the intro.
==="Missing" levels===
==Related links==
Players in 2001 were puzzled when they first installed Oni and looked inside GameDataFolder to find that there were strange gaps in the file numbering: specifically there's no level5, level7, level15, level16 or level17. There isn't something wrong with your installation: the game's content was reshuffled late in development and Bungie West apparently felt it would be too dangerous or disruptive to re-number the level files. The existing files tell a complete story from Chapter 1 to Chapter 14.
*[[OBD:Oni_Binary_Data|Oni Binary Data]] for more info the .dat and .raw files
 
*[[IGMD]] for more info on [[BSL:BungieFrameWork_Scripting_Language|scripts]] (level logic, .bsl files)
===level0_Final===
The level 0 data is only loaded once, when Oni starts.
 
===intro.bik, outro.bik===
*The movie files are not needed for Oni to run. You can thus rename or remove intro.bik to avoid the need to click through the movie.
 
*When the game is beaten and outro finishes playing, the game will quit. Sometimes players think that the game has crashed, but this is by design. Note that if you remove outro.bik, Oni will quit immediately after beating the game.
 
*A bug currently exists where the ending movie plays only its sound, with the screen remaining black. You will have to play outro.bik by double-clicking it if you want to watch it. See next point.
 
*Epic Games Tools, the makers of the Bink video format, offer [https://www.radgametools.com/bnkdown.htm standalone apps] for all platforms if you want to watch the .bik files on their own. However ffmpeg also understands the Bink format, meaning that you can use [https://www.videolan.org/vlc/ VLC] or another ffmpeg-based client to watch the movies.
 
===How Oni finds its GameDataFolder===
In Windows, Oni's engine first looks in the [[wp:Working directory|working directory]] (aka "."). If ".\GameDataFolder" is missing, Oni tries parent folders all the way up to the root (e.g., it looks for "C:\Program Files\Oni\GameDataFolder", then "C:\Program Files\GameDataFolder", then "C:\GameDataFolder"). As a last resort, it looks for ".\OniEngine\GameDataFolder" the same way.
 
The Mac Oni app follows the same search pattern for GameDataFolder/, but does not look for OniEngine/GameDataFolder/.
 
[[Category:Game directory map]]

Latest revision as of 00:47, 6 April 2026

GameDataFolder (commonly called "GDF") is a subfolder of the main Oni folder. It holds the following:

  • Oni's game data, in binary format (see OBD for more info)
  • the level logic, in plain-text (in the IGMD subfolder; see BSL for more info)
  • the intro and outro animated sequences, in the Bink video format

First we show the purpose of each file in this folder – but don't miss our helpful notes below this directory listing.

Directory listing

You should have all the files below in your GameDataFolder, though the movie files are optional (see note at bottom). The "PS2" column shows the numbers assigned to each file name on disc; the .raw and .sep file for each level are in subdirectories titled 20/ and 21/. Beside each set of level files, we list the subfolders of IGMD which hold the corresponding level logic. SPOILER WARNING: The "Chapter" column links to summaries and analyses of Oni's storyline.

File name Level logic folder Chapter Location (seen in Load Game dialog)
Windows Mac PS2
IGMD/
1
--
Contains all level logic
intro.bik
2
--
Movie plays when Oni is launched
level0_Final.dat
level0_Final.raw
level0_Final.dat
level0_Final.raw
level0_Final.sep
3
20/1
21/1
IGMD/global Used in all Chapters (see notes below on "level0_Final" and "IGMD/global")
level1_Final.dat
level1_Final.raw
level1_Final.dat
level1_Final.raw
level1_Final.sep
11
20/9
21/9
IGMD/EnvWarehouse 0: COMBAT TRAINING
1: TRIAL RUN
TCTF Training
Syndicate Warehouse
level2_Final.dat
level2_Final.raw
level2_Final.dat
level2_Final.raw
level2_Final.sep
12
20/10
21/10
IGMD/manplant 2: ENGINES OF EVIL Manufacturing Plant
level3_Final.dat
level3_Final.raw
level3_Final.dat
level3_Final.raw
level3_Final.sep
13
20/11
21/11
IGMD/lab 3: PUZZLE PIECES Bio-Research Lab
level4_Final.dat
level4_Final.raw
level4_Final.dat
level4_Final.raw
level4_Final.sep
14
20/12
21/12
IGMD/Airport 4: TIGER BY THE TAIL Airport Assault
level6_Final.dat
level6_Final.raw
level6_Final.dat
level6_Final.raw
level6_Final.sep
15
20/13
21/13
IGMD/Airport_III 5: HOT PURSUIT Airport Cargo Hangars
level8_Final.dat
level8_Final.raw
level8_Final.dat
level8_Final.raw
level8_Final.sep
16
20/14
21/14
IGMD/tctf 6: COUNTERATTACK TCTF Regional HQ
level9_Final.dat
level9_Final.raw
level9_Final.dat
level9_Final.raw
level9_Final.sep
17
20/15
21/15
IGMD/power 7: A FRIEND IN NEED Atmospheric Conversion Center (exterior)
level10_Final.dat
level10_Final.raw
level10_Final.dat
level10_Final.raw
level10_Final.sep
4
20/2
21/2
IGMD/power_II 8: AN INNOCENT LIFE Atmospheric Conversion Center (interior)
level11_Final.dat
level11_Final.raw
level11_Final.dat
level11_Final.raw
level11_Final.sep
5
20/3
21/3
IGMD/state 9: TRUTH AND CONSEQUENCES Regional State Building
level12_Final.dat
level12_Final.raw
level12_Final.dat
level12_Final.raw
level12_Final.sep
6
20/4
21/4
IGMD/roof 10: CAT AND MOUSE Rooftops
level13_Final.dat
level13_Final.raw
level13_Final.dat
level13_Final.raw
level13_Final.sep
7
20/5
21/5
IGMD/dream_lab 11: DREAM DIVER Doctor Hasegawa's Lab
level14_Final.dat
level14_Final.raw
level14_Final.dat
level14_Final.raw
level14_Final.sep
8
20/6
21/6
IGMD/neuro 12: SINS OF THE FATHER TCTF Science Prison
level18_Final.dat
level18_Final.raw
level18_Final.dat
level18_Final.raw
level18_Final.sep
9
20/7
21/7
IGMD/tctf_ii 13: PHOENIX RISING TCTF Regional HQ (redux)
level19_Final.dat
level19_Final.raw
level19_Final.dat
level19_Final.raw
level19_Final.sep
10
20/8
21/8
IGMD/compound 14: DAWN OF THE CHRYSALIS Syndicate Mountain Compound
outro.bik
18
--
Movie plays when Oni is beaten

Notes

"Missing" levels

Players in 2001 were puzzled when they first installed Oni and looked inside GameDataFolder to find that there were strange gaps in the file numbering: specifically there's no level5, level7, level15, level16 or level17. There isn't something wrong with your installation: the game's content was reshuffled late in development and Bungie West apparently felt it would be too dangerous or disruptive to re-number the level files. The existing files tell a complete story from Chapter 1 to Chapter 14.

level0_Final

The level 0 data is only loaded once, when Oni starts.

intro.bik, outro.bik

  • The movie files are not needed for Oni to run. You can thus rename or remove intro.bik to avoid the need to click through the movie.
  • When the game is beaten and outro finishes playing, the game will quit. Sometimes players think that the game has crashed, but this is by design. Note that if you remove outro.bik, Oni will quit immediately after beating the game.
  • A bug currently exists where the ending movie plays only its sound, with the screen remaining black. You will have to play outro.bik by double-clicking it if you want to watch it. See next point.
  • Epic Games Tools, the makers of the Bink video format, offer standalone apps for all platforms if you want to watch the .bik files on their own. However ffmpeg also understands the Bink format, meaning that you can use VLC or another ffmpeg-based client to watch the movies.

How Oni finds its GameDataFolder

In Windows, Oni's engine first looks in the working directory (aka "."). If ".\GameDataFolder" is missing, Oni tries parent folders all the way up to the root (e.g., it looks for "C:\Program Files\Oni\GameDataFolder", then "C:\Program Files\GameDataFolder", then "C:\GameDataFolder"). As a last resort, it looks for ".\OniEngine\GameDataFolder" the same way.

The Mac Oni app follows the same search pattern for GameDataFolder/, but does not look for OniEngine/GameDataFolder/.