Oni (folder)/persist.dat: Difference between revisions
m (oops) |
(replaced pointless technical sentence with useful explanation of save-loading; added a little PS2 documentation) |
||
| (19 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{UpdatedForOniX|1.0.0}} | |||
{{Hatnote|See [[OBD:Persist.dat]] for technical documentation of this file's format.}} | |||
'''persist.dat''', found next to the game application, is the save-game and preference file for Oni. It can be edited most easily with GUI tools such as [[OSGE]] for Windows and [http://mods.oni2.net/node/155 OniLib] for Mac. | |||
==Progress saving== | |||
As players of Oni are well aware, the game does not allow arbitrary saving ("save anywhere"), but relies on the use of fixed save points activated by reaching certain places in each level, at which point the level scripting uses the [[BSL]] function <tt>save_game</tt> to mark your progress as having reached a certain point. When you load your saved game later, the level scripting reconstructs a world state that resembles what you would have seen when you reached that save point. | |||
Many aspects of the game world are <u>not</u> saved in persist.dat: essentially, anything not pertaining to Konoko herself, such as the position of AIs and the presence of power-ups on the ground. What <u>is</u> stored is Konoko's position, health and inventory. Everything else is determined by the level scripting and the game data, and will always be in the same place when that save point is loaded. | |||
==Game preferences== | |||
In addition to save point data, persist.dat stores Oni's preferences as chosen on the Options screen (note that this omits key bindings, which are stored in [[key_config.txt]]). It also records whether the [[cheats]] are enabled, i.e. whether you have beaten the game (however, cheats are unlocked at all times when playing with the [[Anniversary Edition]] or [[Daodan DLL]] installed, when using the [[FERAL|Intel Mac build]], and when playing the PS2 version). One special "setting" tracked by persist.dat is whether you killed Griffin in {{C|13}}. | |||
{{ | |||
==Mac-Windows compatibility== | |||
The Windows version of persist.dat stores its numbers in little-endian format. But Bungie's original Mac game application and The Omni Group's Mac OS X port were built for PowerPC, a big-endian processor, thus numbers were written in the opposite order to the Mac's persist.dat. This meant that the save-game files were not compatible between Windows and Mac versions of Oni. However, when Macs moved to Intel and players began using the Intel-native Mac build of Oni, the file changed to being written in little-endian format and thus became interchangeable between Windows and Mac Oni. | |||
==PlayStation 2 version== | |||
Despite having two copies of persist.dat on the CD-ROM (as shown [[Oni (PlayStation 2)#Directories|here]]), naturally neither of these can be used since the disc is read-only, so the actual save data is stored on the memory card. The format of this data has not been confirmed but is likely close to the format documented on [[OBD:Persist.dat]]. | |||
[[Category:Game directory map]] | |||
Latest revision as of 16:53, 11 February 2026
- See OBD:Persist.dat for technical documentation of this file's format.
persist.dat, found next to the game application, is the save-game and preference file for Oni. It can be edited most easily with GUI tools such as OSGE for Windows and OniLib for Mac.
Progress saving
As players of Oni are well aware, the game does not allow arbitrary saving ("save anywhere"), but relies on the use of fixed save points activated by reaching certain places in each level, at which point the level scripting uses the BSL function save_game to mark your progress as having reached a certain point. When you load your saved game later, the level scripting reconstructs a world state that resembles what you would have seen when you reached that save point.
Many aspects of the game world are not saved in persist.dat: essentially, anything not pertaining to Konoko herself, such as the position of AIs and the presence of power-ups on the ground. What is stored is Konoko's position, health and inventory. Everything else is determined by the level scripting and the game data, and will always be in the same place when that save point is loaded.
Game preferences
In addition to save point data, persist.dat stores Oni's preferences as chosen on the Options screen (note that this omits key bindings, which are stored in key_config.txt). It also records whether the cheats are enabled, i.e. whether you have beaten the game (however, cheats are unlocked at all times when playing with the Anniversary Edition or Daodan DLL installed, when using the Intel Mac build, and when playing the PS2 version). One special "setting" tracked by persist.dat is whether you killed Griffin in CHAPTER 13 . PHOENIX RISING.
Mac-Windows compatibility
The Windows version of persist.dat stores its numbers in little-endian format. But Bungie's original Mac game application and The Omni Group's Mac OS X port were built for PowerPC, a big-endian processor, thus numbers were written in the opposite order to the Mac's persist.dat. This meant that the save-game files were not compatible between Windows and Mac versions of Oni. However, when Macs moved to Intel and players began using the Intel-native Mac build of Oni, the file changed to being written in little-endian format and thus became interchangeable between Windows and Mac Oni.
PlayStation 2 version
Despite having two copies of persist.dat on the CD-ROM (as shown here), naturally neither of these can be used since the disc is read-only, so the actual save data is stored on the memory card. The format of this data has not been confirmed but is likely close to the format documented on OBD:Persist.dat.