OniGalore - User contributions [en]

OniUnPacker

2010-06-06T18:11:47Z

Wmjdgla: /* History */

'''OniUnPacker (OUP)''', written by [[User:Admin|Alloc]], provides a file manager GUI allowing one to explore, view and edit (in binary) all data within Oni's .dat/.raw files. It is able to import and export all data while allowing one to preview some of them. Additionally, OUP is able to determine dependencies among Oni's data and can perform conversion between level-database and .dat/.raw/.sep files. OUP is now no longer being actively maintained or developed by the author and its functions have since been superseded by [[Onisplit]].
{|align=right
|[[Image:OBD.png]]
|}

=== Download ===
The current version is [http://websvn.chrilly.net/filedetails.php?repname=Oni2&path=%2Foup%2Fbin_releases%2Foniunpacker_0.34b.rar 0.34b] and you can look [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fbin_releases%2F#_oup_bin_releases_ here] for past releases. Sources of specific releases can be found [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Freleases%2F#_oup_releases_ here] and for the source I'm working on currently, [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fcurrent%2F#_oup_current_ here]. More info on the source code can be found [[OBD:OUP/source|here]] (Delphi 2006, should be working with Delphi 2005 too).

If you want to use the "Binary .dat-Editor"-tool you should also get all files from [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fstructdefs%2F#_oup_structdefs_ here]. Read the section "Structure Definitions" a few lines below ;)

=== Structure Definitions ===
Since v0.29a OUP supports so called "Structure Definition Files". These files are simple text files which add easy to view and edit masks in the "Binary .dat-Editor"-tool for each supported filetype. To use those files just get the .txt-files from [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fstructdefs%2F#_oup_structdefs_ here] and put them in a subdirectory called "StructDefs" where the OniUnPacker.exe resides.

=== Features in 0.34a ===
*Create level-database based on a .dat/.raw/.sep (adds even more functions later, like adding, deleting files)
*Create a .dat/.raw/.sep structure based on a level-database
*View, edit, import and export the data of the files in the .dat and .raw (with little helpers as a ValueViewer and the StructureViewer) easily
*Extract ONI's data
*Preview [[TXMP]]s (textures), [[TXAN]]s (texture animations), [[TXMB]]s (big image maps (as far as I know they are only used for the intro/outro splashscreens and the backgrounds in the menus)) & [[PSpc]]s
*Replace TXMPs with image-files
*Associate OUP with .dat-files and/or .oldb-files (OUP LevelDataBase) and/or .opf-files (OUP PatchFiles)

=== Primary goals ===
*Complete rebuilding of level-archives out of a database file so you can change just anything
*Easy creation of patches for level-archives
*Frontend for easily editing any filetype or extracting/reimporting it in case of 3D data
*(Adding completely new levels for the unused levelnumbers (5, 7, 15, 16, 17, 20-127) ?)

=== [[OBD:OUP/History|Version History]] ===
 
----

=== Developers ===
[[User:Admin|Alloc]] 
Contributions:
*Main resource knowledge: [[User:ssg|ssg]]
*Cheerleading, nagging, and oh, maybe 2 or 3 actually useful contributions : [[User:Geyser|geyser]]
*SNDD Export-converter: [[User:Kumo|Kumo]]
*New knowledge about some filetypes, other Oni-internal info: [[User:SFeLi|SFeLi]]

----

=== Thanks to ===

==== SSG ====
I would never have started the OUP-project if he had not created this great website with info about all filetypes in .dat-files and the structure of .dats in general. And he's always answering me new questions and requesting new stuff for OUP or reporting bugs ... BIG THANK YOU =)

==== Geyser ====
Well, he is probably the second most important reason why I started OUP. And he is always begging me for weird new stuff too ... And finding out what the BodyAnimationPart of TRAMs are telling us was a really great job ... Hope you will *not* stop working with me on that project and the other projects you are involved in.

==== Kumo ====
Even if he was not involved in OUPs developing progress directly (besides the SNDD to WAV decoder, thanks for that too) he was the only german one I could regularly talk to directly. Had many nice chats with you, thanks man.

==== SFeLi ====
Yeah, good thing you were not around OCF earlier. I do not think that would have had any work for myself otherwise ;) But on the other side you also do a really great job so it would not have been too bad if you had found us earlier. And thanks for the discussions about Oni and its binary stuff.

==== My parents ====
I am really grateful that they never found out what I am spending my time on instead of spending it on my schoolwork. Otherwise OUP would not be what it is today ;)

----

=== A few screenshots ===
<gallery>
Image:OUP_main.jpg
Image:OUP_binedit.jpg
Image:OUP_valueedit.jpg
Image:OUP_txmpreplace.jpg
Image:OUP_preview.jpg
Image:OUP_extractor.jpg
</gallery>

=== Example of replaced texture files ===
Replaced all of the fire*-textures in level4/airport assault with an test-bitmap and set transparency to 1 
[[Image:oup_edited_fire.jpg]]

[[Category:Modding tools]]

OniUnPacker

2010-06-06T17:53:17Z

Wmjdgla:

'''OniUnPacker (OUP)''', written by [[User:Admin|Alloc]], provides a file manager GUI allowing one to explore, view and edit (in binary) all data within Oni's .dat/.raw files. It is able to import and export all data while allowing one to preview some of them. Additionally, OUP is able to determine dependencies among Oni's data and can perform conversion between level-database and .dat/.raw/.sep files. OUP is now no longer being actively maintained or developed by the author and its functions have since been superseded by [[Onisplit]].
{|align=right
|[[Image:OBD.png]]
|}

=== Download ===
The current version is [http://websvn.chrilly.net/filedetails.php?repname=Oni2&path=%2Foup%2Fbin_releases%2Foniunpacker_0.34b.rar 0.34b] and you can look [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fbin_releases%2F#_oup_bin_releases_ here] for past releases. Sources of specific releases can be found [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Freleases%2F#_oup_releases_ here] and for the source I'm working on currently, [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fcurrent%2F#_oup_current_ here]. More info on the source code can be found [[OBD:OUP/source|here]] (Delphi 2006, should be working with Delphi 2005 too).

If you want to use the "Binary .dat-Editor"-tool you should also get all files from [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fstructdefs%2F#_oup_structdefs_ here]. Read the section "Structure Definitions" a few lines below ;)

=== Structure Definitions ===
Since v0.29a OUP supports so called "Structure Definition Files". These files are simple text files which add easy to view and edit masks in the "Binary .dat-Editor"-tool for each supported filetype. To use those files just get the .txt-files from [http://websvn.chrilly.net/listing.php?repname=Oni2&path=%2Foup%2Fstructdefs%2F#_oup_structdefs_ here] and put them in a subdirectory called "StructDefs" where the OniUnPacker.exe resides.

=== Features in 0.34a ===
*Create level-database based on a .dat/.raw/.sep (adds even more functions later, like adding, deleting files)
*Create a .dat/.raw/.sep structure based on a level-database
*View, edit, import and export the data of the files in the .dat and .raw (with little helpers as a ValueViewer and the StructureViewer) easily
*Extract ONI's data
*Preview [[TXMP]]s (textures), [[TXAN]]s (texture animations), [[TXMB]]s (big image maps (as far as I know they are only used for the intro/outro splashscreens and the backgrounds in the menus)) & [[PSpc]]s
*Replace TXMPs with image-files
*Associate OUP with .dat-files and/or .oldb-files (OUP LevelDataBase) and/or .opf-files (OUP PatchFiles)

=== Primary goals ===
*Complete rebuilding of level-archives out of a database file so you can change just anything
*Easy creation of patches for level-archives
*Frontend for easily editing any filetype or extracting/reimporting it in case of 3D data
*(Adding completely new levels for the unused levelnumbers (5, 7, 15, 16, 17, 20-127) ?)

=== [[OBD:OUP/History|History]] ===
 
----

=== Developers ===
[[User:Admin|Alloc]] 
Contributions:
*Main resource knowledge: [[User:ssg|ssg]]
*Cheerleading, nagging, and oh, maybe 2 or 3 actually useful contributions : [[User:Geyser|geyser]]
*SNDD Export-converter: [[User:Kumo|Kumo]]
*New knowledge about some filetypes, other Oni-internal info: [[User:SFeLi|SFeLi]]

----

=== Thanks to ===

==== SSG ====
I would never have started the OUP-project if he had not created this great website with info about all filetypes in .dat-files and the structure of .dats in general. And he's always answering me new questions and requesting new stuff for OUP or reporting bugs ... BIG THANK YOU =)

==== Geyser ====
Well, he is probably the second most important reason why I started OUP. And he is always begging me for weird new stuff too ... And finding out what the BodyAnimationPart of TRAMs are telling us was a really great job ... Hope you will *not* stop working with me on that project and the other projects you are involved in.

==== Kumo ====
Even if he was not involved in OUPs developing progress directly (besides the SNDD to WAV decoder, thanks for that too) he was the only german one I could regularly talk to directly. Had many nice chats with you, thanks man.

==== SFeLi ====
Yeah, good thing you were not around OCF earlier. I do not think that would have had any work for myself otherwise ;) But on the other side you also do a really great job so it would not have been too bad if you had found us earlier. And thanks for the discussions about Oni and its binary stuff.

==== My parents ====
I am really grateful that they never found out what I am spending my time on instead of spending it on my schoolwork. Otherwise OUP would not be what it is today ;)

----

=== A few screenshots ===
<gallery>
Image:OUP_main.jpg
Image:OUP_binedit.jpg
Image:OUP_valueedit.jpg
Image:OUP_txmpreplace.jpg
Image:OUP_preview.jpg
Image:OUP_extractor.jpg
</gallery>

=== Example of replaced texture files ===
Replaced all of the fire*-textures in level4/airport assault with an test-bitmap and set transparency to 1 
[[Image:oup_edited_fire.jpg]]

[[Category:Modding tools]]

OniSplit

2010-06-06T16:47:19Z

Wmjdgla:

'''OniSplit''', written by [[User_talk:Neo|Neo]], is an integral part of the [[Anniversary Edition]] and an essential modding tool on its own. It is able to import and export many kinds of Oni game data, such as textures, sound, 3D models, level geometry & combat animations and is also able to split & recombine Oni's data files. It's functions supersede those of [[OUP]] & [[OME]] and is currently the community's modding tool of choice.

==Getting it==
===Download links===
* Latest version of OniSplit: [http://mods.oni2.net/system/files/OniSplit.exe_.zip v0.9.40]
* A GUI for OniSplit for Windows can be found [http://oni.bungie.org/community/forum/viewtopic.php?pid=9323#p9323 HERE.]
* A GUI for OniSplit for the Mac is found [[AETools|HERE]].

===Requirements===
OniSplit requires .NET 2.0 for Windows and the Mono framework for Mac OS X.

* [http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en .NET 2.0]
* [http://www.go-mono.com/mono-downloads/download.html Latest version of mono (requires OS X 10.4+)]
* [http://edt.oni2.net/AE/MonoFramework10.3.dmg Mono for OS X 10.3]

----

==Using it==
The following actions are listed when calling OniSplit with the <tt>-help</tt> option (another informative option is <tt>-version</tt>)
:The command line must be preceded by either <tt>OniSplit.exe</tt> (Windows) or <tt>mono OniSplit.exe</tt> (Mac OS)
::If OniSplit.exe is not in the current folder, you can provide the full/relative path to it or set the path variable.
:::On the Mac, be sure to use / rather than \ in paths. The following instructions are for Windows by default.
====Conversion between .dat and .oni====
{|
|<tt>-export <target directory> <source file></tt>||Exports source file (.dat) to target directory
|-
|<tt>-import <source directory> <target file></tt>||Imports target file (.dat) from source directory; tries to get target file format from source SNDD
|-
|<tt>-import:sep <source directory> <target file></tt>||Imports target file (.dat) from source directory; uses .dat+.raw+.sep format (Mac and PC Demo)
|-
|<tt>-import:nosep <source directory> <target file></tt>||Imports target file (.dat) from source directory; uses .dat+.raw format (PC retail)
|}
:Note that -import will search subdirectories too. If you find having hundreds or thousand of files .oni in one directory to be unmanageable you can always group them in subdirectories anyway you like. The only exception is that a subdirectory named "noimport" or "_noimport" is always ignored.

====Management of .oni files====
Unless mentioned otherwise, the filename field supports wildcards ("*").
:OniSplit consistently detects and manages "dependencies" of .oni files.
::The dependencies of a file are looked up in its folder and subfolders.
{|
|<tt>-deps <filenames></tt>||Displays a list of .oni files that the specified .oni file depends on
|-
|<tt>-copy <target directory> <filenames></tt>||Copies .oni file and its dependencies to target; skips file if it already exists at destination
|-
|<tt>-move <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; skips file if it already exists at destination
|-
|<tt>-move:overwrite <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; overwrites any existing .oni files
|-
|<tt>-move:delete <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; doesn't overwrite; deletes source files
|}
====Conversion between .oni/.dat and 3rd party formats====
=====Textures=====
Unless mentioned otherwise, source filenames support wildcards. See [[AE:Modifying textures|HERE]] for a detailed tutorial.
{|
|<tt>-extract:dds <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in DDS format
|-
|<tt>-extract:tga <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in TGA format
|-
|<tt>-extract:png <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in PNG format
|-
|align=right|<tt>-create:txmp <targer directory> [-genmipmaps] [-nouwrap] [-novwrap] <nowiki>[-format:bgr32|bgra32|bgr555|bgra5551|bgra4444|dxt1]</nowiki> [-envmap:texture_name] <filename></tt>
|valign=top|Creates .oni file in target directory from source image
|}
The -extract commands can work with .oni files (a single file or several files, wildcards possible) or rip all the TXMPs from a .dat file.

=====Models=====
[[M3GM]]s, [[ONWC]]s, [[ONCC]]s can be exported to the Wavefront .obj and COLLADA .dae formats. For details see [[AE:Importing character models|HERE]] and [[AE:Importing weapon models|HERE]]
{|
|<tt>-extract:obj <target directory> <filenames></tt>||Extracts all M3GM, ONWC and ONCC instances to Wavefront OBJ files
|-
|<tt>-extract:dae <target directory> <filenames></tt>||Extracts all M3GM, ONWC and ONCC instances to Collada files
|-
|<tt>-create:m3gm <target directory> [-tex:texture_name] <filename></tt>||Creates a M3GM .oni in target directory from an .obj file
|-
|<tt>-create:trbs <target directory> [-cel] [-normals] <filename></tt>||Creates a TRBS .oni in target directory from a .dae file
|}
The generic -extract commands can work with .oni files (a single file or several files, wildcards possible) or rip all the TXMP from a .dat file.
:TRBS and ONCC support additional -noanim and -anim options for -extract:dae, see [[AE:Importing character models|HERE]] for details.
::Imported geometry must only contain triangles. See [[AE:Importing character models|HERE]] for additional options (e.g., cel-shading)

====Levels====
OniSplit can convert AKEV files (level geometry) and the associated file types to and from DAE format:

<tt>-extract:dae <target directory> <name of AKEV.oni source file></tt> Extracts all AKEV and related instances to Collada files

The next two steps are used on a folder in which you have placed the DAE and XML-formatted instances of the required files, as well as textures in TGA format.

<tt>-create <target directory> -genmipmaps -format:dxt1 <source directory/>*.xml</tt> Converts all AKEV and related instances to .oni files

<tt>-import:nosep <source directory> <target file name>.dat</tt> The standard command for creating .dat/.raw files from .oni files (remember to use the import:sep option on Mac!)

=====Misc=====
Some more import/export functions, e.g., to rip sounds or rip/replace subtitles.
{|
|<tt>-extract:wav <target directory> <filenames></tt>||Rips all SNDD as .wav into target folder from source .dat or .oni
|-
|<tt>-extract:aif <target directory> <filenames></tt>||Rips all SNDD as .aif into target folder from source .dat or .oni
|-
|<tt>-extract:txt <target directory> <filenames></tt>||Rips all SUBT as .txt into target folder from source .dat or .oni
|-
|<tt>-create:subt <target directory> <filename></tt>||Creates a SUBT .oni file in target folder from a .txt file
|}

=====XML=====
One of the latest features is conversion of an .oni file (binary) into an XML metafile and back. XML files are more explicit and more readily editable.
::Currently xml export/import is limited to files that do not have raw/sep parts. 2-way conversion is known to work for [[BINA]], [[CONS]], [[DOOR]], [[DPge]], [[FILM]], [[HPge]], [[IGHH]], [[IPge]], [[M3GM]], [[OBAN]], [[ONCC]], [[ONCV]], [[ONLD]], [[ONLV]], [[ONGS]], [[ONSK]], [[ONVL]], [[ONWC]], [[OPge]], [[OSBD]], [[PSpc]], [[PSpL]], [[PSUI]], [[TRAC]], [[TRAM]], [[TRIG]], [[TRGE]], [[TRMA]], [[TRSC]], [[TXMB]], [[TXMP]], [[WMCL]], [[WMDD]], [[WMM_]], [[WPge]].
:::For detailed examples and tutorials, see [[AE:XML|HERE]]
{|
|<tt>-extract:xml <target directory> <filenames></tt>||Extracts all instances to XML files
|-
|<tt>-create <target directory> <filename></tt>||Creates an .oni file in the target directory from an XML file
|}

BIG NOTE OF WARNING: some of the above instance types (most importantly ONWC) contain geometry data (M3GM) embedded in them. The geometry can round-trip through xml but versions of OniSplit up to and including 0.9.26 produce an invalid .oni file that may cause Oni to crash.
[[Category:Modding tools]][[Category:Articles that need updating]]

==Change Log==

New OniSplit version: OniSplit v0.9.40

What's new:

:* support for exporting/importing [[OBD:BINA/SABD|sound animations]] to/from xml files
:* better Collada export for environment
:* support for full color transparent textures (-format:bgra32 on the command line, ARGB8888 format in an xml file)
:* different (hopefully better) xml export format for animations (this one is actually from 0.9.38 but since that wasn't mentioned here...)
:* a more or less complete animation importer. This one deservers some notes:
::-unlike other importers that produce .oni files this one produces and .xml file (similar to the one you get when exporting a TRAM)
::when you do
onisplit -create:tram target_dir animation.dae
::in the target dir you'll get a TRAManimation.xml file.
::You need to add some stuff to that file to make it actually work as an animation. In particular the animation type, from/to states and varient needs to be set.
::-For all I know this works with animations exported from Oni and modified in Softimage. If you come up with a completly new animation it should work as long as the skeleton is similar to the one used in Oni.
::-Note that the geometry that is present inside the Collada file is used to compute the "vertical extents" so it better be the same or close to the one the animation is intended for.
::-The biggest problem are the attacks. While it's not difficult to add attacks to the xml file, computing the necessary "extents" is not going to be easy. I guess in the end I'll have to add some command to OniSplit to do it.
::-Everything else that I forgot :)

[[User:Neo|Neo]]

New OniSplit version: [http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.37.zip OniSplit v0.9.37]

What's new:

:* support for transparency in the environment importer

New OniSplit version: OniSplit v0.9.35

What's new:

:* conversion of recorded films (.dat binary files) to xml files that can be used to create FILM .oni files

OniSplit film2xml out_dir film.dat

New OniSplit version: OniSplit v0.9.34

What's new:

:* SNDD importer
::-WAV files (.wav, mono/stereo, 22.05KHz/44.1KHz, uncompressed(PCM)/compressed(MS-ADPCM)) produce SNDD files that are compatible with Oni PC retail.
::-AIFC files (.aif/.aifc/.afc, mono/stereo 22.05KHz, compressed(ima4)) produce SNDD files that are compatible with Oni Mac.
::Example

OniSplit -create out_dir test.aif
OniSplit -create out_dir test.wav

:*LOD support for creating TRBS files. This can be done by creating an xml file containing the following:

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.29.0">
<Instance id="0" type="TRBS">
<Elements>
<Link>barabus_body_1.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_3.dae</Link>
<Link>barabus_body_4.dae</Link>
<Link>barabus_body_5.dae</Link>
</Elements>
</Instance>
</Oni>

::and running the command (assuming the created xml file's name is barabus_body.xml):

OniSplit -create out_dir barabus_body.xml

::It's not strictly necessary to create 5 different geometries for each LOD. The following works just as well:

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.29.0">
<Instance id="0" type="TRBS">
<Elements>
<Link>barabus_body_1.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_3.dae</Link>
</Elements>
</Instance>
</Oni>

:*An xml file can contain "links" to other xml/obj/dae files. For example you can have the following line in an ONWC xml file:

<Geometry>pistol.obj</Geometry>

::Assuming the file pistol.obj exists in the same directory an M3GM .oni file will be automatically created from it.

::Relative paths work just as well:

<Geometry>geometry/pistol.obj</Geometry>

:*The -create:subt, -create:txmp and -create:m3gm are sort of obsolete. They still work but now you can simply use '-create' (or just 'create'):

OniSplit -create out_dir crate.dae
OniSplit create out_dir -format:bgr555 -genmipmaps pic.tga
OniSplit create out_dir subtitles.txt

:*Work in progress: the AKEV importer now reads Collada materials so the resulting AKEV is textured.

:Sample levels:
:[http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/noglass.zip TestLevel1] -- This level should look like this in-game: [[:Image:NoGlass Import Test 1.jpg|Image 1]] [[:Image:NoGlass Import Test 2.jpg|Image 2]] [[:Image:NoGlass Import Test 3.jpg|Image 3]]
:[http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/hexagon.zip TestLevel2] -- This level should look like this in-game: [http://edt.oni2.net/images/hexagon1.jpg Image 1]
:A zip file contains the minimum needed to get a new level running in Oni. To "compile" a level extract it to a folder and run the following commands:

OniSplit -create out -genmipmaps -format:dxt1 *.xml
OniSplit -import:nosep . Oni\GameDataFolder\level1_Final.dat

:(Of course, you need to change the output .dat file path to match your Oni installation path)

:Note1: The hexagon level needs to be scaled up to work properly. Use the envscale option for this:
OniSplit -create out -genmipmaps -format:dxt1 -envscale:40 *.xml

:Note2: I've updated the level files to contain 20 empty corpses to prevent crashes.

BSL:BFW Scripting Language

2010-06-06T03:07:46Z

Wmjdgla:

'''Bungie Scripting Language (or BSL)''' is what Oni scripts are written in. Being a scripting language, it is far more limited in scope and usage than a "real" programming language, as it was designed only to move events forward in the game, not to build programs.

==What Are Scripts?==
Scripts are the files that drive level logic, environment effects, and cutscenes. Physically speaking, they are the .bsl files inside the folder [[IGMD|Oni/GameDataFolder/IGMD/]]. By editing scripts, you can alter how the game plays.

==Editing Scripts==
Scripts can be edited with the simplest of word-processing programs, such as the built-in WordPad (Windows) or TextEdit (Mac). They can be edited simply by typing inside the file. When saving, you must either ensure that the suffix is .bsl or that you use the suffix .txt and afterwards change it to .bsl.

- To learn BSL by example, you can read the .bsl files in Oni's IGMD folder and draw connections to the events in the game that were produced by those scripts. 
- For a primer in writing BSL, see the Tutorials section below. 
- For a thorough listing of what's possible in BSL (a reference, not a primer), see the Knowledge Database below. 
- Typing '''''dump_docs''''' in the game console will generated the file '''script_commands.txt''' listing all BSL commands & variables.

==Scripted Mods==
Scripted mods are great examples of what can be accomplished by editing scripts. They replace or add to Oni's .bsl files to create interesting and often amusing results. They can change everything from the fog to how the characters and level interact. However, they cannot add new characters or change the level layout, as that data is fixed by the [[OBD|Binaries]]. They are great examples of what can be achieved simply by typing into a text file. The possibilities are simply endless.

Probably the best specimens of scripted mods are the [[AE:OTA|Oni Team Arena]] scripts. Based on the desire for a multi-player mode in Oni, and inspired by Unreal Tournament, they augment Oni's hand-to-hand combat and gunplay with a scoring system much like Unreal Tournament's DeathMatch.

Other scripted mods range from free-for-all arenas to objective-based missions and enhancements of the original levels. They can spice up the gameplay and provide a more exciting experience to those who have finished the game. They keep the game alive, outside of its original levels.

===Downloads===
Downloads of OTA Mods are available at the [[AE:OTA|Oni Team Arena page]].

Downloads for other scripted mods mave been gathered here: [http://your-mom.oni2.net/Downloads.htm here] and [http://script10000.oni2.net/scripts.html here.]

==Tutorials==
For the practical minds who don't care (too much) about theory, the [[BSL:Tutorial]] page offers the following paths for you to explore:
*Wanna make minor (yet cool-looking) changes to the original level logic? [[BSL:Tutorial/Modification|Read this]].
*Wanna script a "patch" that's effective in every level but doesn't change the original logic? [[IGMD/global|Then go here]].
*Wanna create completely new level logic from scratch? [[BSL:Tutorial/Scratch|Here you are.]]

==Knowledge Database==
*[[BSL:Statements|Statements]]
*[[BSL:Variables|Variables]]
*[[BSL:Functions|Functions]]
*[[BSL:Operators|Operators]]
*[[BSL:Data|Data types]]
*[[BSL:Inventory|Inventory management]]

Documentation that describes the locations that BSL scripts reside in:
*[[IGMD|IGMD folder]]

==Syntax Overview==
{| border="1" cellpadding="5" cellspacing="0" align="center"
|+'''BSL syntax overview table'''
|-
| align="center" style="border-bottom:3px solid grey;"|
{| border="0"
|+''BSL separators''
|-
| align="center" width="100px" | [[BSL:Statements|<tt>;</tt>]]
| align="center" width="100px" | [[BSL:Functions|<tt>,</tt>]]
| align="center" width="100px" | [[BSL:Comments|<tt>#</tt>]]
| align="center" width="100px" | [[BSL:Data|<tt>"</tt>]]
|-
| align="center" width="100px" | [[BSL:Statements|<tt>{</tt>]]
| align="center" width="100px" | [[BSL:Statements|<tt>}</tt>]]
| align="center" width="100px" | [[BSL:Functions|<tt>(</tt>]]
| align="center" width="100px" | [[BSL:Functions|<tt>)</tt>]]
|-
| align="center" colspan="4" style="border-top:1px solid red; border-right:1px solid red; border-bottom:2px solid red; border-left:1px solid red;" |
Click on a separator for details
|}
|-
| align="center" style="border-bottom:3px solid grey;"|
{| border="0"
|+''BSL operators''
|-
| align="center" width="100px" | [[BSL:Operators|<tt>+</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>-</tt>]]
| align="center" width="100px" | [[BSL:Variables|<tt>=</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>!</tt>]]
|-
| align="center" width="100px" | [[BSL:Operators|<tt>and</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>or</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>eq</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>ne</tt>]]
|-
| align="center" width="100px" | [[BSL:Operators|<tt><</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>></tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt><=</tt>]]
| align="center" width="100px" | [[BSL:Operators|<tt>>=</tt>]]
|-
| align="center" colspan="4" style="border-top:1px solid red; border-right:1px solid red; border-bottom:2px solid red; border-left:1px solid red;" |
Click on an operator for details
|}
|-
| align="center" style="border-bottom:3px solid grey;"|
{| border="0"
|+''BSL keywords''
|-
| align="center" width="75px" | [[BSL:Keywords|<tt>at</tt>]]
| align="center" width="75px" | [[BSL:Data|<tt>float</tt>]]
| align="center" width="75px" | [[BSL:Statements|<tt>if</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>repeat</tt>]]
| align="center" width="75px" | [[BSL:Data|<tt>string</tt>]]
|-
| align="center" width="75px" | [[BSL:Data|<tt>bool</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>for</tt>]]
| align="center" width="75px" | [[BSL:Data|<tt>int</tt>]]
| align="center" width="75px" | [[BSL:Functions|<tt>return</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>using</tt>]]
|-
| align="center" width="75px" | [[BSL:Statements|<tt>else</tt>]]
| align="center" width="75px" | [[BSL:Functions|<tt>fork</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>iterate</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>schedule</tt>]]
| align="center" width="75px" | [[BSL:Variables|<tt>var</tt>]]
|-
| align="center" width="75px" | [[BSL:Keywords|<tt>every</tt>]]
| align="center" width="75px" | [[BSL:Functions|<tt>func</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>over</tt>]]
| align="center" width="75px" | [[BSL:Keywords|<tt>sleep</tt>]]
| align="center" width="75px" | [[BSL:Data|<tt>void</tt>]]
|-
| align="center" colspan="5" style="border-top:1px solid red; border-right:1px solid red; border-bottom:2px solid red; border-left:1px solid red;" |
Click on a keyword for details
|}
|}

Oni Model Extractor

2010-06-05T03:57:24Z

Wmjdgla: Undo revision 16573 by Wmjdgla (Talk)

== Oni Model Extractor (or OME) ==
[[Image:ome_screenshot.png|right|v 0.4]]

=== Description ===

This is a Java, GUI-based program allowing one to preview and extract character models, 3D objects, images, sounds and some animations in Oni's [[OBD|.dat]] files. This program is now no longer being actively maintained or developed by the author and its functions have since been superseded by [[Onisplit]].

The detailed functions are as follows:
*previews & exports [[SNDD]] (sound data) as .wav ''(The author says that it can also export as .aif, but that option is not available from the file type drop-down box when exporting. Anybody knows anything about this? -- wmjdgla)''
*previews & exports [[TXMP]] (texture maps) as .png
*previews & exports [[M3GM]] (3D objects) & [[ONCC]] (3D character models) as 3DS Max files (without animations and smoothing groups) or COLLADA files (without animations)
*previews [[TRAM]] (character animations) ''(I got an error when trying to preview this. From the readme, I suspect it's because I didn't "place JOGL JARs and native OS libraries to the lib/jogl directory". However the JOGL project has now been merged with GIT, and their website is rather user-unfriendly in the sense that I have no idea how and where to get the JARs and libraries in question. -- wmjdgla)''

=== Download ===
The current version is 0.65 and you can get it [http://mods.oni2.net/index.php?q=node/52 here] (source included)

=== Plans ===
maybe implement exporting animations to COLLADA in some far future

=== Log ===
10.11.2006 - the project started.

03.12.2006 - ok, I have made a little movement - it can now parse a dat.

16.12.2006 - well, now it is not enough time to deal with it. So, it is temporarily dead.

17.07.2007 - hmm, some movements have been made: i have rewritten some of OniTools' sources in Java. But what i got was not exactly what i was going to get: i found out, that OniTools have rather poor functionality in sense of viewing Oni multimedia data. I'll take a break for now, but some time later i'll return to grab some sources from OniBrowser.

23.11.2007 - so ... a year has already passed

now it can view/extract sounds

25.11.2007 - now it can view/extract images

16.12.2007 - today is saturday, and yesterday was friday; now it can view and extract 3d objects (M3GM)

17.12.2007 - found and fixed a bug: when extracting to 3ds textures were mapped upside-down; also replaced the table with the tree; also slightly modified url

25.12.2007 - oncc viewing/exporting implemented

28.01.2008 (27.01.2008's night) - extracting from M3GM to COLLADA implemented

28.01.2008 (evening) - extracting from ONCC to COLLADA implemented

----

=== Developer ===
Kuchumov Nikolay, grabbing sources from the whole community 

The app is based a bit on OniTools by Ian Patterson, and mostly OniBrowser by Neo and this wiki site 
And i also actively used OniUnPacker for debugging and a little research

----
[[Category:Modding tools]]

Oni Model Extractor

2010-06-05T03:56:59Z

Wmjdgla: Undo revision 16572 by Wmjdgla (Talk)

== Oni Model Extractor (or OME) ==
[[Image:ome_screenshot.png|right|v 0.4]]

=== Description ===

This is a Java, GUI-based program allowing one to preview and extract character models, 3D objects, images, sounds and some animations in Oni's [[OBD|.dat]] files. This program is now no longer being actively maintained or developed by the author and its functions have since been superseded by [[Onisplit]].

The detailed functions are as follows:
*previews & exports [[SNDD]] (sound data) as .wav ''(The author says that it can also export as .aif, but that option is not available from the file type drop-down box when exporting. Anybody knows anything about this? -- wmjdgla)''
*previews & exports [[TXMP]] (texture maps) as .png
*previews & exports [[M3GM]] (3D objects) & [[ONCC]] (3D character models) as 3DS Max files (without animations and smoothing groups) or COLLADA files (without animations)
*previews [[TRAM]] (character animations) ''(I got an error when trying to preview this. From the readme, I suspect it's because I didn't "place JOGL JARs and native OS libraries to the lib/jogl directory". However the JOGL project has now been merged with GIT, and their website is rather user-unfriendly in the sense that I have no idea how and where to get the JARs and libraries in question -- wmjdgla)''

=== Download ===
The current version is 0.65 and you can get it [http://mods.oni2.net/index.php?q=node/52 here] (source included)

=== Plans ===
maybe implement exporting animations to COLLADA in some far future

=== Log ===
10.11.2006 - the project started.

03.12.2006 - ok, I have made a little movement - it can now parse a dat.

16.12.2006 - well, now it is not enough time to deal with it. So, it is temporarily dead.

17.07.2007 - hmm, some movements have been made: i have rewritten some of OniTools' sources in Java. But what i got was not exactly what i was going to get: i found out, that OniTools have rather poor functionality in sense of viewing Oni multimedia data. I'll take a break for now, but some time later i'll return to grab some sources from OniBrowser.

23.11.2007 - so ... a year has already passed

now it can view/extract sounds

25.11.2007 - now it can view/extract images

16.12.2007 - today is saturday, and yesterday was friday; now it can view and extract 3d objects (M3GM)

17.12.2007 - found and fixed a bug: when extracting to 3ds textures were mapped upside-down; also replaced the table with the tree; also slightly modified url

25.12.2007 - oncc viewing/exporting implemented

28.01.2008 (27.01.2008's night) - extracting from M3GM to COLLADA implemented

28.01.2008 (evening) - extracting from ONCC to COLLADA implemented

----

=== Developer ===
Kuchumov Nikolay, grabbing sources from the whole community 

The app is based a bit on OniTools by Ian Patterson, and mostly OniBrowser by Neo and this wiki site 
And i also actively used OniUnPacker for debugging and a little research

----
[[Category:Modding tools]]

Oni Model Extractor

2010-06-05T03:53:22Z

Wmjdgla:

Oni Model Extractor

2010-06-05T03:52:25Z

Wmjdgla:

== Oni Model Extractor (or OME) ==
[[Image:ome_screenshot.png|right|v 0.4]]

=== Description ===

This is a Java, GUI-based program allowing one to preview and extract character models, 3D objects, images, sounds and some animations in Oni's [[OBD|.dat]] files. This program is now no longer being actively maintained or developed by the author and its functions have since been superseded by [[Onisplit]].

The detailed functions are as follows:
*previews & exports [[SNDD]] (sound data) as .wav ''(The author says that it can also export as .aif, but that option is not available from the file type drop-down box when exporting. Anybody knows anything about this? -- wmjdgla)''
*previews & exports [[TXMP]] (texture maps) as .png
*previews & exports [[M3GM]] (3D objects) & [[ONCC]] (3D character models) as 3DS Max files (without animations and smoothing groups) or COLLADA files (without animations)
*previews [[TRAM]] (character animations) ''(I got an error when trying to preview this. From the readme, I suspect it's because I didn't "place JOGL JARs and native OS libraries to the lib/jogl directory". However the JOGL project has now been merged with GIT, and their website is rather user-unfriendly in the sense that I have no idea how and where to get the JARs and libraries in question -- wmjdgla)''

=== Download ===
The current version is 0.65 and you can get it [http://mods.oni2.net/index.php?q=node/52 here] (source included)

=== Plans ===
maybe implement exporting animations to COLLADA in some far future

=== Log ===
10.11.2006 - the project started.

03.12.2006 - ok, I have made a little movement - it can now parse a dat.

16.12.2006 - well, now it is not enough time to deal with it. So, it is temporarily dead.

17.07.2007 - hmm, some movements have been made: i have rewritten some of OniTools' sources in Java. But what i got was not exactly what i was going to get: i found out, that OniTools have rather poor functionality in sense of viewing Oni multimedia data. I'll take a break for now, but some time later i'll return to grab some sources from OniBrowser.

23.11.2007 - so ... a year has already passed

now it can view/extract sounds

25.11.2007 - now it can view/extract images

16.12.2007 - today is saturday, and yesterday was friday; now it can view and extract 3d objects (M3GM)

17.12.2007 - found and fixed a bug: when extracting to 3ds textures were mapped upside-down; also replaced the table with the tree; also slightly modified url

25.12.2007 - oncc viewing/exporting implemented

28.01.2008 (27.01.2008's night) - extracting from M3GM to COLLADA implemented

28.01.2008 (evening) - extracting from ONCC to COLLADA implemented

----

=== Developer ===
Kuchumov Nikolay, grabbing sources from the whole community 

The app is based a bit on OniTools by Ian Patterson, and mostly OniBrowser by Neo and this wiki site 
And i also actively used OniUnPacker for debugging and a little research

----
[[Category:Modding tools]]

Oni Model Extractor

2010-06-05T03:27:40Z

Wmjdgla:

== Oni Model Extractor (or OME) ==
[[Image:ome_screenshot.png|right|v 0.4]]

=== Description ===

This is a Java, GUI-based program allowing one to preview and extract character models, 3D objects, images, sounds and some animations in Oni's .dat files. This program is now no longer being actively maintained or developed by the author and its functions have since been superseded by Onisplit.

The detailed functions are as follows:
*previews & exports [[SNDD]] (sound data) as .wav ''(The author says that it can also export as .aif, but that option is not available from the file type drop-down box when exporting. Anybody knows anything about this? -- wmjdgla)''
*exports [[TXMP]] (texture maps) as .png
*exports [[M3GM]] (3D objects) & [[ONCC]] (3D character models) as 3DS Max files (without animations and smoothing groops) or COLLADA files (without animations)

=== Download ===
The current version is 0.65 and you can get it [http://mods.oni2.net/index.php?q=node/52 here] (source included)

=== Plans ===
maybe implement exporting animations to COLLADA in some far future

=== Log ===
10.11.2006 - the project started.

03.12.2006 - ok, I have made a little movement - it can now parse a dat.

16.12.2006 - well, now it is not enough time to deal with it. So, it is temporarily dead.

17.07.2007 - hmm, some movements have been made: i have rewritten some of OniTools' sources in Java. But what i got was not exactly what i was going to get: i found out, that OniTools have rather poor functionality in sense of viewing Oni multimedia data. I'll take a break for now, but some time later i'll return to grab some sources from OniBrowser.

23.11.2007 - so ... a year has already passed

now it can view/extract sounds

25.11.2007 - now it can view/extract images

16.12.2007 - today is saturday, and yesterday was friday; now it can view and extract 3d objects (M3GM)

17.12.2007 - found and fixed a bug: when extracting to 3ds textures were mapped upside-down; also replaced the table with the tree; also slightly modified url

25.12.2007 - oncc viewing/exporting implemented

28.01.2008 (27.01.2008's night) - extracting from M3GM to COLLADA implemented

28.01.2008 (evening) - extracting from ONCC to COLLADA implemented

----

=== Developer ===
Kuchumov Nikolay, grabbing sources from the whole community 

The app is based a bit on OniTools by Ian Patterson, and mostly OniBrowser by Neo and this wiki site 
And i also actively used OniUnPacker for debugging and a little research

----
[[Category:Modding tools]]

OniSplit

2010-06-04T17:22:26Z

Wmjdgla: /* Misc */

'''OniSplit''', written by [[User_talk:Neo|Neo]], is an integral part of the [[Anniversary Edition]] and an essential modding tool on its own. It does the work of splitting and recombining Oni's data files. But it also does much more, such as extracting and creating textures, 3D and .xml files.

==Getting it==
===Download links===
* Latest version of OniSplit: [http://mods.oni2.net/system/files/OniSplit.exe_.zip v0.9.40]
* A GUI for OniSplit for Windows can be found [http://oni.bungie.org/community/forum/viewtopic.php?pid=9323#p9323 HERE.]
* A GUI for OniSplit for the Mac is found [[AETools|HERE]].

===Requirements===
OniSplit requires .NET 2.0 for Windows and the Mono framework for Mac OS X.

* [http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en .NET 2.0]
* [http://www.go-mono.com/mono-downloads/download.html Latest version of mono (requires OS X 10.4+)]
* [http://edt.oni2.net/AE/MonoFramework10.3.dmg Mono for OS X 10.3]

----

==Using it==
The following actions are listed when calling OniSplit with the <tt>-help</tt> option (another informative option is <tt>-version</tt>)
:The command line must be preceded by either <tt>OniSplit.exe</tt> (Windows) or <tt>mono OniSplit.exe</tt> (Mac OS)
::If OniSplit.exe is not in the current folder, you can provide the full/relative path to it or set the path variable.
:::On the Mac, be sure to use / rather than \ in paths. The following instructions are for Windows by default.
====Conversion between .dat and .oni====
{|
|<tt>-export <target directory> <source file></tt>||Exports source file (.dat) to target directory
|-
|<tt>-import <source directory> <target file></tt>||Imports target file (.dat) from source directory; tries to get target file format from source SNDD
|-
|<tt>-import:sep <source directory> <target file></tt>||Imports target file (.dat) from source directory; uses .dat+.raw+.sep format (Mac and PC Demo)
|-
|<tt>-import:nosep <source directory> <target file></tt>||Imports target file (.dat) from source directory; uses .dat+.raw format (PC retail)
|}
:Note that -import will search subdirectories too. If you find having hundreds or thousand of files .oni in one directory to be unmanageable you can always group them in subdirectories anyway you like. The only exception is that a subdirectory named "noimport" or "_noimport" is always ignored.

====Management of .oni files====
Unless mentioned otherwise, the filename field supports wildcards ("*").
:OniSplit consistently detects and manages "dependencies" of .oni files.
::The dependencies of a file are looked up in its folder and subfolders.
{|
|<tt>-deps <filenames></tt>||Displays a list of .oni files that the specified .oni file depends on
|-
|<tt>-copy <target directory> <filenames></tt>||Copies .oni file and its dependencies to target; skips file if it already exists at destination
|-
|<tt>-move <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; skips file if it already exists at destination
|-
|<tt>-move:overwrite <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; overwrites any existing .oni files
|-
|<tt>-move:delete <target directory> <filenames></tt>||Moves an .oni file and its dependencies to target; doesn't overwrite; deletes source files
|}
====Conversion between .oni/.dat and 3rd party formats====
=====Textures=====
Unless mentioned otherwise, source filenames support wildcards. See [[AE:Modifying textures|HERE]] for a detailed tutorial.
{|
|<tt>-extract:dds <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in DDS format
|-
|<tt>-extract:tga <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in TGA format
|-
|<tt>-extract:png <target directory> <filenames></tt>||Extracts all textures (TXMP) from a Oni .dat/.oni file in PNG format
|-
|align=right|<tt>-create:txmp <targer directory> [-genmipmaps] [-nouwrap] [-novwrap] <nowiki>[-format:bgr32|bgra32|bgr555|bgra5551|bgra4444|dxt1]</nowiki> [-envmap:texture_name] <filename></tt>
|valign=top|Creates .oni file in target directory from source image
|}
The -extract commands can work with .oni files (a single file or several files, wildcards possible) or rip all the TXMPs from a .dat file.

=====Models=====
[[M3GM]]s, [[ONWC]]s, [[ONCC]]s can be exported to the Wavefront .obj and COLLADA .dae formats. For details see [[AE:Importing character models|HERE]] and [[AE:Importing weapon models|HERE]]
{|
|<tt>-extract:obj <target directory> <filenames></tt>||Extracts all M3GM, ONWC and ONCC instances to Wavefront OBJ files
|-
|<tt>-extract:dae <target directory> <filenames></tt>||Extracts all M3GM, ONWC and ONCC instances to Collada files
|-
|<tt>-create:m3gm <target directory> [-tex:texture_name] <filename></tt>||Creates a M3GM .oni in target directory from an .obj file
|-
|<tt>-create:trbs <target directory> [-cel] [-normals] <filename></tt>||Creates a TRBS .oni in target directory from a .dae file
|}
The generic -extract commands can work with .oni files (a single file or several files, wildcards possible) or rip all the TXMP from a .dat file.
:TRBS and ONCC support additional -noanim and -anim options for -extract:dae, see [[AE:Importing character models|HERE]] for details.
::Imported geometry must only contain triangles. See [[AE:Importing character models|HERE]] for additional options (e.g., cel-shading)

====Levels====
OniSplit can convert AKEV files (level geometry) and the associated file types to and from DAE format:

<tt>-extract:dae <target directory> <name of AKEV.oni source file></tt> Extracts all AKEV and related instances to Collada files

The next two steps are used on a folder in which you have placed the DAE and XML-formatted instances of the required files, as well as textures in TGA format.

<tt>-create <target directory> -genmipmaps -format:dxt1 <source directory/>*.xml</tt> Converts all AKEV and related instances to .oni files

<tt>-import:nosep <source directory> <target file name>.dat</tt> The standard command for creating .dat/.raw files from .oni files (remember to use the import:sep option on Mac!)

=====Misc=====
Some more import/export functions, e.g., to rip sounds or rip/replace subtitles.
{|
|<tt>-extract:wav <target directory> <filenames></tt>||Rips all SNDD as .wav into target folder from source .dat or .oni
|-
|<tt>-extract:aif <target directory> <filenames></tt>||Rips all SNDD as .aif into target folder from source .dat or .oni
|-
|<tt>-extract:txt <target directory> <filenames></tt>||Rips all SUBT as .txt into target folder from source .dat or .oni
|-
|<tt>-create:subt <target directory> <filename></tt>||Creates a SUBT .oni file in target folder from a .txt file
|}

=====XML=====
One of the latest features is conversion of an .oni file (binary) into an XML metafile and back. XML files are more explicit and more readily editable.
::Currently xml export/import is limited to files that do not have raw/sep parts. 2-way conversion is known to work for [[BINA]], [[CONS]], [[DOOR]], [[DPge]], [[FILM]], [[HPge]], [[IGHH]], [[IPge]], [[M3GM]], [[OBAN]], [[ONCC]], [[ONCV]], [[ONLD]], [[ONLV]], [[ONGS]], [[ONSK]], [[ONVL]], [[ONWC]], [[OPge]], [[OSBD]], [[PSpc]], [[PSpL]], [[PSUI]], [[TRAC]], [[TRAM]], [[TRIG]], [[TRGE]], [[TRMA]], [[TRSC]], [[TXMB]], [[TXMP]], [[WMCL]], [[WMDD]], [[WMM_]], [[WPge]].
:::For detailed examples and tutorials, see [[AE:XML|HERE]]
{|
|<tt>-extract:xml <target directory> <filenames></tt>||Extracts all instances to XML files
|-
|<tt>-create <target directory> <filename></tt>||Creates an .oni file in the target directory from an XML file
|}

BIG NOTE OF WARNING: some of the above instance types (most importantly ONWC) contain geometry data (M3GM) embedded in them. The geometry can round-trip through xml but versions of OniSplit up to and including 0.9.26 produce an invalid .oni file that may cause Oni to crash.
[[Category:Modding tools]][[Category:Articles that need updating]]

==Change Log==

New OniSplit version: OniSplit v0.9.40

What's new:

:* support for exporting/importing [[OBD:BINA/SABD|sound animations]] to/from xml files
:* better Collada export for environment
:* support for full color transparent textures (-format:bgra32 on the command line, ARGB8888 format in an xml file)
:* different (hopefully better) xml export format for animations (this one is actually from 0.9.38 but since that wasn't mentioned here...)
:* a more or less complete animation importer. This one deservers some notes:
::-unlike other importers that produce .oni files this one produces and .xml file (similar to the one you get when exporting a TRAM)
::when you do
onisplit -create:tram target_dir animation.dae
::in the target dir you'll get a TRAManimation.xml file.
::You need to add some stuff to that file to make it actually work as an animation. In particular the animation type, from/to states and varient needs to be set.
::-For all I know this works with animations exported from Oni and modified in Softimage. If you come up with a completly new animation it should work as long as the skeleton is similar to the one used in Oni.
::-Note that the geometry that is present inside the Collada file is used to compute the "vertical extents" so it better be the same or close to the one the animation is intended for.
::-The biggest problem are the attacks. While it's not difficult to add attacks to the xml file, computing the necessary "extents" is not going to be easy. I guess in the end I'll have to add some command to OniSplit to do it.
::-Everything else that I forgot :)

[[User:Neo|Neo]]

New OniSplit version: [http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/OniSplit/OniSplit|_v0.9.37.zip OniSplit v0.9.37]

What's new:

:* support for transparency in the environment importer

New OniSplit version: OniSplit v0.9.35

What's new:

:* conversion of recorded films (.dat binary files) to xml files that can be used to create FILM .oni files

OniSplit film2xml out_dir film.dat

New OniSplit version: OniSplit v0.9.34

What's new:

:* SNDD importer
::-WAV files (.wav, mono/stereo, 22.05KHz/44.1KHz, uncompressed(PCM)/compressed(MS-ADPCM)) produce SNDD files that are compatible with Oni PC retail.
::-AIFC files (.aif/.aifc/.afc, mono/stereo 22.05KHz, compressed(ima4)) produce SNDD files that are compatible with Oni Mac.
::Example

OniSplit -create out_dir test.aif
OniSplit -create out_dir test.wav

:*LOD support for creating TRBS files. This can be done by creating an xml file containing the following:

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.29.0">
<Instance id="0" type="TRBS">
<Elements>
<Link>barabus_body_1.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_3.dae</Link>
<Link>barabus_body_4.dae</Link>
<Link>barabus_body_5.dae</Link>
</Elements>
</Instance>
</Oni>

::and running the command (assuming the created xml file's name is barabus_body.xml):

OniSplit -create out_dir barabus_body.xml

::It's not strictly necessary to create 5 different geometries for each LOD. The following works just as well:

<?xml version="1.0" encoding="utf-8"?>
<Oni Version="0.9.29.0">
<Instance id="0" type="TRBS">
<Elements>
<Link>barabus_body_1.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_2.dae</Link>
<Link>barabus_body_3.dae</Link>
</Elements>
</Instance>
</Oni>

:*An xml file can contain "links" to other xml/obj/dae files. For example you can have the following line in an ONWC xml file:

<Geometry>pistol.obj</Geometry>

::Assuming the file pistol.obj exists in the same directory an M3GM .oni file will be automatically created from it.

::Relative paths work just as well:

<Geometry>geometry/pistol.obj</Geometry>

:*The -create:subt, -create:txmp and -create:m3gm are sort of obsolete. They still work but now you can simply use '-create' (or just 'create'):

OniSplit -create out_dir crate.dae
OniSplit create out_dir -format:bgr555 -genmipmaps pic.tga
OniSplit create out_dir subtitles.txt

:*Work in progress: the AKEV importer now reads Collada materials so the resulting AKEV is textured.

:Sample levels:
:[http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/noglass.zip TestLevel1] -- This level should look like this in-game: [[:Image:NoGlass Import Test 1.jpg|Image 1]] [[:Image:NoGlass Import Test 2.jpg|Image 2]] [[:Image:NoGlass Import Test 3.jpg|Image 3]]
:[http://cid-639aa31296681bfe.skydrive.live.com/self.aspx/Oni/hexagon.zip TestLevel2] -- This level should look like this in-game: [http://edt.oni2.net/images/hexagon1.jpg Image 1]
:A zip file contains the minimum needed to get a new level running in Oni. To "compile" a level extract it to a folder and run the following commands:

OniSplit -create out -genmipmaps -format:dxt1 *.xml
OniSplit -import:nosep . Oni\GameDataFolder\level1_Final.dat

:(Of course, you need to change the output .dat file path to match your Oni installation path)

:Note1: The hexagon level needs to be scaled up to work properly. Use the envscale option for this:
OniSplit -create out -genmipmaps -format:dxt1 -envscale:40 *.xml

:Note2: I've updated the level files to contain 20 empty corpses to prevent crashes.

Oni (folder)

2010-06-04T15:48:08Z

Wmjdgla:

This is a browseable representation of Oni's file hierarchy under Windows and the Mac OS. 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''', and in Mac OS X it is '''/Applications/Oni'''.

For Windows Vista, four files - '''persist.dat''', '''debugger.txt''', '''key_config.txt''' & '''startup.txt''' are instead located at '''C:\Users\*your username*\AppData\Local\VirtualStore\Program Files\Oni''' by virtue of OS's handling of the game's installation. This does not apply to Oni: AE that is installed on Vista.

'''About the icons''' 
[[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.

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.

;Note
:This list is not exhaustive. 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" align="center"
|+
!
!Windows
!Mac OS X
!Description
{{th}}
!colspan="4" |Folders
|-
|[[Image:Aqua Dot-Red.png]]
|colspan="2"|<center>[[Oni (folder)/GameDataFolder|GameDataFolder]]</center>
|A subfolder with movies, scripts and binary resources
{{th}}
!colspan="4" |Files
|-
|[[Image:Aqua Dot-Red.png]]
|binkw32.dll
|bgcolor=gray|
|Allows Windows Oni to play BINK movies
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/debugger.txt|debugger.txt]]</center>
|Error log; only created if an error occurs while running Oni
|-
|[[Image:Aqua Dot-Red.png]]
|colspan="2"|<center>[[Customizing/Binding|key_config.txt]]</center>
|Key configuration file; if it's missing, Oni will generate a default
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Oni (folder)/license.txt|license.txt]]
|bgcolor=gray|
|Software license and warranty agreement
|-
|[[Image:Aqua Dot-Red.png]]
|[[AE:EXE|Oni.exe]]
|[[AE:OMNI|Oni]]
|The game's executable
|-
|[[Image:Aqua Dot-Blue.png]]
|ONI.url
|bgcolor=gray|
|URL for [http://oni.bungie.com oni.bungie.com] (subdomain is defunct)
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/persist.dat|persist.dat]]</center>
|Save-game file; created by Oni if missing
|-
|[[Image:Aqua Dot-Blue.png]]
|[[Oni (folder)/readme.txt|readme.txt]]
|[[Oni (folder)/Oni ReadMe|Oni ReadMe]]
|Readme file
|-
|[[Image:Aqua Dot-Blue.png]]
|RegisterOni.url
|bgcolor=gray|
|[http://www.godgames.com/main.php?section=support&page=registration URL] for godgames.com (site is defunct)
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[BSL|script_commands.txt]]</center>
|List of BSL commands & variables; created by [[BSL]] command [[dump_docs]]
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/script_debug.txt|script_debug.txt]]</center>
|Log of BSL "contexts"; dumped if Oni is run with [[Customizing#Command-line arguments|-debugfiles]]
|-
|[[Image:Aqua Dot-Yellow.png]]
|colspan="2"|<center>[[Oni (folder)/startup.txt|startup.txt]]</center>
|Event log; dumped (overwritten) every time Oni is run
|-
|[[Image:Aqua Dot-Blue.png]]
|Uninst.isu
|bgcolor=gray|
|Record used by Windows to uninstall Oni (or "Uninstal.log")
|}

[[Category:Game directory map]]

Oni (folder)/persist.dat

2010-06-04T15:45:13Z

Wmjdgla:

{{merge|[[Persist.dat]]}}

The savegame file '''persist.dat''' corresponds to a dump of Oni's memory. It is written at specific moments during the game, e.g. after a new level is loaded, or after a new savepoint is reached. It also registers settings from the option menu and remembers whether the cheats are enabled (i.e. whether you have beaten the game) and whether you have killed [[Griffin]].

The savegame file is a memory dump and has nothing to do with [[dat|instance files]] despite the ".dat" extension (same for saved_film####.dat, ####_corpse.dat, etc). The binary format of a savegame file is detailed below. It applies to PC and PC demo; the Mac build writes all numbers as [[wikipedia:Big Endian|Big Endian]], e.g., the 0x08 field in the header will appear as 00 0C 7F 5C for a Mac savegame. Therefore, savegames are not interchangeable between PC and Mac versions of Oni.

The header of the savegame file is 0x60=612 bytes long. It is followed by an array of 400 savepoints, 0x204=516 bytes each, grouped implicitly into 40 levels, 10 savepoints per level. The first 10 savepoints belong to level 0 and are never written to. The savepoints of the original 14 levels follow. This leaves 25 unused levels at the end of the savegame file.

The level names are taken from the [[ONLD]] files of level 0, except for Chapters 0 and 1: "TCTF Training" (level 1, savepoint 0) and "Syndicate Warehouse" (level 1 savepoint 1) are hardcoded in the engine.
{{table}}{{OBDtable}}
{{OBDth}}
{{OBDtr|0x00|int32|FF0000|0F 00 00 00|15|unknown, maybe 15 levels; if not 15, file is invalid}}
{{OBDtr|0x04|int32|FF0000|0E 0B D0 D0|???|unknown}}
{{OBDtr|0x08|int32|FF0000|5C 7F 0C 00|219+218+214+213+212+211 +210+29+28+26+24+23+22|visibility lock for levels 2 through 31; 0 and 1 unaffected}}
{{OBDtr|0x0C|int32|FF0000|00 00 00 00|none|visibility lock for levels 32 through 63}}
{{OBDtr|0x10|int32|FF0000|00 00 00 00|none|visibility lock for levels 64 through 95}}
{{OBDtr|0x14|int32|FF0000|00 00 00 00|none|visibility lock for levels 96 through 127}}
{{OBDtr|0x18|int32|FF0000|00 00 00 00|none|visibility lock for levels 128 through 159}}
{{OBDtr|0x1C|int32|FF0000|00 00 00 00|none|visibility lock for levels 160 through 191}}
{{OBDtr|0x20|int32|FF0000|00 00 00 00|none|visibility lock for levels 192 through 223}}
{{OBDtr|0x24|int32|FF0000|00 00 00 00|none|visibility lock for levels 224 through 255}}
{{OBDtr|0x28|int32|FFFF00|01 00 00 00|true|whether Griffin was killed: used in Chapters {{C|13|13}} and {{C|14|14}}; set with [[BSL:Functions|func]] [[killed_griffen]](bool), read with [[BSL:Functions|func]] [[did_kill_griffen]]()}}
{{OBDtr|0x2C|int32|00FF00|FE 1B 00 00|212+211+29+28+27 +26+25+24+23+22+21|unknown}}
{{OBDtr|0x30|int32|00FFFF|1F 00 00 00|31|unknown}}
{{OBDtr|0x34|int32|FF00FF|13 00 00 00|19|unknown}}
{{OBDtr|0x38|int32|FFC8C8|01 00 00 00|01|unknown}}
{{OBDtr|0x3C|int32|FFFFC8|04 00 00 00|4|quality: from superlow (0) to superhigh (4)}}
{{OBDtr|0x40|float|C8FFC8|00 00 80 3F|1.000000|sound volume: from 0.0 to 1.0}}
{{OBDtr|0x44|bool32|C8FFFF|06 00 00 00|22+21|bitset: 1 - show subtitles; 2 - invert aiming; 4 - enable cheats}}
{{OBDtr|0x48|int32|FFC8FF|02 00 00 00|2|quality: from Easy (0) to Hard (2)}}
{{OBDtr|0x4C|int16|FFC800|20 03|800|horizontal screen resolution}}
{{OBDtr|0x4E|int16|FFC800|02 58|600|vertical screen resolution}}
{{OBDtr|0x50|int32|C800C8|20 00 00 00|32|color depth}}
{{OBDtr|0x54|float|C87C64|00 00 00 3F|0.500000|gamma correction; from 0.0 to 1.0, 0.5 means no correction}}
{{OBDtr|0x58|int32|B0C3D4|03 00 00 00|3|last loaded level; written at level load}}
{{OBDtr|0x5C|int32|E7CEA5|02 00 00 00|2|last saved savepoint}}
|}

Example of a savepoint (chapter 1, savepoint 2)
{{table}}{{OBDtable}}
{{OBDth}}
{{OBDtr2|0x00|char[64]|FF0000|"Save Point 2"|name of the savepoint in the Load Game dialog}}
{{OBDtr|0x40|int32|FFFF00|01 00 00 00|true|whether the savepoint is visible in the Load Game dialog}}
{{OBDtr|0x44|int32|00FF00|BE 00 00 00|190|current health in hitpoints}}
{{OBDtr|0x48|int32|00FFFF|C8 00 00 00|200|max. health in hitpoints}}
{{OBDtr|0x4C|float|FF00FF|AE 20 FB 43|502.255310|x-position}}
{{OBDtr|0x50|float|FF00FF|03 32 4B 42|50.798839|y-position (height)}}
{{OBDtr|0x54|float|FF00FF|55 12 25 C4|-660.286437|z-position}}
{{OBDtr|0x58|float|FFC8C8|80 06 C1 3F|1.508010|y-rotation (facing)}}
{{OBDtr|0x5C|int32|FFFFC8|00 00 00 00|0|amount of ballistic ammo (red clips)}}
{{OBDtr|0x60|int32|C8FFC8|01 00 00 00|1|amount of energy cells (green clips)}}
{{OBDtr|0x64|int32|C8FFFF|00 00 00 00|0|shield in percent}}
{{OBDtr|0x68|int32|FFC8FF|00 00 00 00|0|phase cloak in frames (1/60 s)}}
{{OBDtr|0x6C|int32|FFC800|01 00 00 00|1|amount of hypos}}
{{OBDtr|0x70|int32|C800C8|00 00 00 00|0|unknown; always 0}}
{{OBDtr|0x74|int32|C87C64|01 00 00 00|true|whether the player has an [[LSI]]}}
{{OBDtr|0x78|int32|B0C3D4|00 00 00 00|0|unknown; always 0}}
{{OBDtr|0x7C|int32|E7CEA5|00 00 00 00|0|unknown; always 0}}
{{OBDtr2|0x80|char[256]|FFDDDD| |unknown, always 0}}
{{OBDtr2|0x180|char[128]|64AAAA|w2_sap|name of player's [[ONWC]] (weapon class) if any}}
{{OBDtr|0x200|int32|EBEBEB|1E 00 00 00|30|ammo filling of the weapon (shots or percent?)}}
|}

[[Category:Oni binary data docs]]

Oni (folder)/persist.dat

2010-06-04T03:36:27Z

Wmjdgla:

{{merge|[[Persist.dat]]}}

The savegame file '''persist.dat''' corresponds to a dump of Oni's memory. It is written at specific moments during the game, e.g. after a new level is loaded, or after a new savepoint is reached. It also registers settings from the option menu and remembers whether the cheats are enabled (i.e. whether you have beaten the game) and whether you have killed [[Griffin]].

Note that for Windows Vista, the file, along with three others( debugger.txt, key_config.txt & startup.txt ) are located at C:\Users\*your username*\AppData\Local\VirtualStore\Program Files\Oni, rather than in the same directory as Oni.exe by virtue of OS's handling of the game's installation. This does not apply to Oni: AE.

The savegame file is a memory dump and has nothing to do with [[dat|instance files]] despite the ".dat" extension (same for saved_film####.dat, ####_corpse.dat, etc). The binary format of a savegame file is detailed below. It applies to PC and PC demo; the Mac build writes all numbers as [[wikipedia:Big Endian|Big Endian]], e.g., the 0x08 field in the header will appear as 00 0C 7F 5C for a Mac savegame. Therefore, savegames are not interchangeable between PC and Mac versions of Oni.

The header of the savegame file is 0x60=612 bytes long. It is followed by an array of 400 savepoints, 0x204=516 bytes each, grouped implicitly into 40 levels, 10 savepoints per level. The first 10 savepoints belong to level 0 and are never written to. The savepoints of the original 14 levels follow. This leaves 25 unused levels at the end of the savegame file.

The level names are taken from the [[ONLD]] files of level 0, except for Chapters 0 and 1: "TCTF Training" (level 1, savepoint 0) and "Syndicate Warehouse" (level 1 savepoint 1) are hardcoded in the engine.
{{table}}{{OBDtable}}
{{OBDth}}
{{OBDtr|0x00|int32|FF0000|0F 00 00 00|15|unknown, maybe 15 levels; if not 15, file is invalid}}
{{OBDtr|0x04|int32|FF0000|0E 0B D0 D0|???|unknown}}
{{OBDtr|0x08|int32|FF0000|5C 7F 0C 00|219+218+214+213+212+211 +210+29+28+26+24+23+22|visibility lock for levels 2 through 31; 0 and 1 unaffected}}
{{OBDtr|0x0C|int32|FF0000|00 00 00 00|none|visibility lock for levels 32 through 63}}
{{OBDtr|0x10|int32|FF0000|00 00 00 00|none|visibility lock for levels 64 through 95}}
{{OBDtr|0x14|int32|FF0000|00 00 00 00|none|visibility lock for levels 96 through 127}}
{{OBDtr|0x18|int32|FF0000|00 00 00 00|none|visibility lock for levels 128 through 159}}
{{OBDtr|0x1C|int32|FF0000|00 00 00 00|none|visibility lock for levels 160 through 191}}
{{OBDtr|0x20|int32|FF0000|00 00 00 00|none|visibility lock for levels 192 through 223}}
{{OBDtr|0x24|int32|FF0000|00 00 00 00|none|visibility lock for levels 224 through 255}}
{{OBDtr|0x28|int32|FFFF00|01 00 00 00|true|whether Griffin was killed: used in Chapters {{C|13|13}} and {{C|14|14}}; set with [[BSL:Functions|func]] [[killed_griffen]](bool), read with [[BSL:Functions|func]] [[did_kill_griffen]]()}}
{{OBDtr|0x2C|int32|00FF00|FE 1B 00 00|212+211+29+28+27 +26+25+24+23+22+21|unknown}}
{{OBDtr|0x30|int32|00FFFF|1F 00 00 00|31|unknown}}
{{OBDtr|0x34|int32|FF00FF|13 00 00 00|19|unknown}}
{{OBDtr|0x38|int32|FFC8C8|01 00 00 00|01|unknown}}
{{OBDtr|0x3C|int32|FFFFC8|04 00 00 00|4|quality: from superlow (0) to superhigh (4)}}
{{OBDtr|0x40|float|C8FFC8|00 00 80 3F|1.000000|sound volume: from 0.0 to 1.0}}
{{OBDtr|0x44|bool32|C8FFFF|06 00 00 00|22+21|bitset: 1 - show subtitles; 2 - invert aiming; 4 - enable cheats}}
{{OBDtr|0x48|int32|FFC8FF|02 00 00 00|2|quality: from Easy (0) to Hard (2)}}
{{OBDtr|0x4C|int16|FFC800|20 03|800|horizontal screen resolution}}
{{OBDtr|0x4E|int16|FFC800|02 58|600|vertical screen resolution}}
{{OBDtr|0x50|int32|C800C8|20 00 00 00|32|color depth}}
{{OBDtr|0x54|float|C87C64|00 00 00 3F|0.500000|gamma correction; from 0.0 to 1.0, 0.5 means no correction}}
{{OBDtr|0x58|int32|B0C3D4|03 00 00 00|3|last loaded level; written at level load}}
{{OBDtr|0x5C|int32|E7CEA5|02 00 00 00|2|last saved savepoint}}
|}

Example of a savepoint (chapter 1, savepoint 2)
{{table}}{{OBDtable}}
{{OBDth}}
{{OBDtr2|0x00|char[64]|FF0000|"Save Point 2"|name of the savepoint in the Load Game dialog}}
{{OBDtr|0x40|int32|FFFF00|01 00 00 00|true|whether the savepoint is visible in the Load Game dialog}}
{{OBDtr|0x44|int32|00FF00|BE 00 00 00|190|current health in hitpoints}}
{{OBDtr|0x48|int32|00FFFF|C8 00 00 00|200|max. health in hitpoints}}
{{OBDtr|0x4C|float|FF00FF|AE 20 FB 43|502.255310|x-position}}
{{OBDtr|0x50|float|FF00FF|03 32 4B 42|50.798839|y-position (height)}}
{{OBDtr|0x54|float|FF00FF|55 12 25 C4|-660.286437|z-position}}
{{OBDtr|0x58|float|FFC8C8|80 06 C1 3F|1.508010|y-rotation (facing)}}
{{OBDtr|0x5C|int32|FFFFC8|00 00 00 00|0|amount of ballistic ammo (red clips)}}
{{OBDtr|0x60|int32|C8FFC8|01 00 00 00|1|amount of energy cells (green clips)}}
{{OBDtr|0x64|int32|C8FFFF|00 00 00 00|0|shield in percent}}
{{OBDtr|0x68|int32|FFC8FF|00 00 00 00|0|phase cloak in frames (1/60 s)}}
{{OBDtr|0x6C|int32|FFC800|01 00 00 00|1|amount of hypos}}
{{OBDtr|0x70|int32|C800C8|00 00 00 00|0|unknown; always 0}}
{{OBDtr|0x74|int32|C87C64|01 00 00 00|true|whether the player has an [[LSI]]}}
{{OBDtr|0x78|int32|B0C3D4|00 00 00 00|0|unknown; always 0}}
{{OBDtr|0x7C|int32|E7CEA5|00 00 00 00|0|unknown; always 0}}
{{OBDtr2|0x80|char[256]|FFDDDD| |unknown, always 0}}
{{OBDtr2|0x180|char[128]|64AAAA|w2_sap|name of player's [[ONWC]] (weapon class) if any}}
{{OBDtr|0x200|int32|EBEBEB|1E 00 00 00|30|ammo filling of the weapon (shots or percent?)}}
|}

[[Category:Oni binary data docs]]