Oni (folder)/GameDataFolder: Difference between revisions

made table header two rows and placed the Win/Mac/PS2 headers under the header "File name"; added a couple notes on the movie files
(added "PS2" column to table; removed needed/optional column, as it really didn't add much to the page)
(made table header two rows and placed the Win/Mac/PS2 headers under the header "File name"; added a couple notes on the movie files)
Line 1: Line 1:
'''GameDataFolder''' (commonly called "GDF") is a subfolder of the main Oni folder. It holds the following:
'''GameDataFolder''' (commonly called "GDF") is a subfolder of the main Oni folder. It holds the following:
*Oni's game data (see [[OBD]] for more info)
*Oni's game data, in binary format (see [[OBD]] for more info)
*the level logic (as scripts in the IGMD subfolder; see [[BSL]] 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
*the intro and outro animated sequences, in the Bink video format


Line 8: Line 8:


{| class="wikitable" style="margin-left:auto; margin-right:auto;"
{| class="wikitable" style="margin-left:auto; margin-right:auto;"
|+
|-
!Windows
|colspan="3" align="center"|'''File name'''
!Mac
|rowspan="2" align="center"|'''Level logic folder'''
!PS2
|rowspan="2" align="center"|'''[[Chapters|Chapter]]'''
!Level logic folder
|rowspan="2" align="center"|'''Location (as in Load Game dialog)'''
![[Chapters|Chapter]]
|-
!Location (as in Load Game dialog)
|align="center"|'''Windows'''
|align="center"|'''Mac'''
|align="center"|'''PS2'''
|-
|-
|colspan="2"|<center>'''[[IGMD|IGMD/]]'''</center>
|colspan="2"|<center>'''[[IGMD|IGMD/]]'''</center>
Line 143: Line 145:
IGMD/global/ is not present by default, but if it is created, the functions in any scripts placed inside it will be accessible from all levels; however, the Windows demo engine ignores the global/ folder.
IGMD/global/ is not present by default, but if it is created, the functions in any scripts placed inside it will be accessible from all levels; however, the Windows demo engine ignores the global/ folder.


===Movie files===
===intro.bik, outro.bik===
Epic Games Tools, the makers of the Bink video format, offer [http://www.radgametools.com/bnkdown.htm standalone apps] for all platforms if you want to watch the .bik files on their own. The movie files are not needed for Oni to run. You can thus rename or move intro.bik out of GameDataFolder so Oni starts faster.
The movie files are not needed for Oni to run. You can thus rename or move intro.bik out of GameDataFolder so Oni starts faster. Note that if you remove outro.bik, Oni will quit immediately after beating the game because it would normally play the outro and then quit.
 
Epic Games Tools, the makers of the Bink video format, offer [http://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===
===How Oni finds its GameDataFolder===
In Windows, Oni's engine first looks up GDF in the [[wikipedia:Working directory|working directory]] (a.k.a. "."). 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.
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/.
The Mac Oni app follows the same search pattern for GameDataFolder/, but does not look for OniEngine/GameDataFolder/.


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