XML:File types

See Modding Oni for an introduction to modding.

See XML for an introduction to XML modding.

The XML namespace is devoted to explaining Oni's data types, originally documented in a technical byte-by-byte manner at OBD, according to the more user-friendly format they appear in when exported by OniSplit as XML. Following is an overview of each data type's function, and whether it has XML documentation available.

Documentation status:

 : available

 : incomplete

 : not available, but that doesn't mean you cannot mod the file type

Location:

global: File(s) found in level0_Final

local: File(s) found in level[1-19]_Final

both: File(s) found in all level files

BINA

Tag	Name	Docs	File	Location
BINA/ONIE		Oni Impact Effects	BINAEINOimpact_effects	global	A list of all impact effects which can happen in the game. That includes weapon particles, hand-to-hand combat, and footsteps. The impact effect is selected according the type of impact (Impt) and the material (Mtrl) which is hit.
{{{7}}}
BINA/PAR3		Particle	BINA3RAP...	global	A type of particle which can be spawned in the game, used by weapons to deal damage, for lighting effects, etc. The list of the specific particles spawned in a certain level is a PART.
{{{7}}}
BINA/SABD		Sound Animation	BINADBAS...	global	A list of the sounds to be played for an animation type. There is one of these for each character variant (ONCV).
{{{7}}}
BINA/TMBD		Texture Materials	BINADBMTTextureMaterials	global	A list of the materials (Mtrl) assigned to each texture map (TXMP). Used by ONIE.
{{{7}}}

OBJC

Tag	Name	Docs	File	Location
BINA/OBJC/CHAR		Characters	BINACJBOCharacter	local	List of characters in a specific level, containing their position, script function names, weapon, ammunition, items, team, combat, melee ID, etc.
{{{7}}}
BINA/OBJC/CMBT		Combat	BINACJBOCombat	global	List of combat profiles for global use, containing conditions that govern the AI's melee, weapon combat, and retreat behavior, based on factors like distance and the enemy's reactions.
{{{7}}}
BINA/OBJC/CONS		Consoles	BINACJBOConsole	local	List of consoles in a specific level, containing their position, script name (ID), screen images, and script function names. Consoles are used to open doors, trigger alarms, or provide information.
{{{7}}}
BINA/OBJC/DOOR		Doors	BINACJBODoor	local	List of doors in a specific level, containing their conditions for when a door opens (e.g., is the action key required?), and what events are triggered by a character who opens the door.
{{{7}}}
BINA/OBJC/FLAG		Flags	BINACJBOFlag	local	List of flags in a specific level, containing their position. Flags are used by level scripts and patrol paths.
{{{7}}}
BINA/OBJC/FURN		Furniture	BINACJBOFurniture	local	List of pieces of furniture in a specific level. This file type can be used to import level objects.
{{{7}}}
BINA/OBJC/MELE		Melee	BINACJBOMelee Profile	global	List of melee profiles for global use. A melee profile contains a simple program that determines how the AI uses its combat moves.
{{{7}}}
BINA/OBJC/NEUT		Neutral	BINACJBONeutral	local	List of neutral character behaviors in a specific level. Every character has a melee, combat and neutral behavior ID. It determines whether a non-player character (NPC) talks to you and whether they give you a power-up.
{{{7}}}
BINA/OBJC/PART		Particles	BINACJBOParticle	local	List of particles in a specific level, containing their position, script name and scaling.
{{{7}}}
BINA/OBJC/PATR		Patrol Paths	BINACJBOPatrol Path	local	List of patrol paths in a specific level, containing an ID which is used by CHAR and the scripting command "ai2_dopath".
{{{7}}}
BINA/OBJC/PWRU		PowerUps	BINACJBOPowerUp	local	List of power-ups (items, e.g. hypo sprays) in a specific level which are spawned at level load, containing their position.
{{{7}}}
BINA/OBJC/SNDG		Sound Groups	BINACJBOSound	local	List of sound groups in a specific level. Sound groups are the invisible spheres which contain ambient sounds. If you come near a machine and you hear a sound, that's because of a sound group.
{{{7}}}
BINA/OBJC/TRGV		Trigger Volumes	BINACJBOTrigger Volume	local	List of trigger volumes in a specific level. They are invisible areas which trigger functions in a script when entered.
{{{7}}}
BINA/OBJC/TRIG		Triggers	BINAJCBOTrigger	local	List of laser triggers in a specific level. There are several forms of triggers, and they can trigger not only turrets (TURR), but also script functions in the level.
{{{7}}}
BINA/OBJC/TURR		Turrets	BINACJBOTurret	local	List of turrets in a specific level. Note that their pods are part of the level geometry. Spawn one manually and it might be located somewhere in the air. Determines their head's position, the weapon inside the turret head, and the team ID to target.
{{{7}}}
BINA/OBJC/WEAP		Weapons	BINACJBOWeapon	local	List of weapons in a specific level, determining their spawn location at level load.
{{{7}}}

Others

Tag	Name	Docs	File	Location
AISA		AI Character Setup Array	AISAlevel##_scripts	local	This file type was probably in the process of being replaced by CHAR when Oni shipped, but it is still used for a few cutscene characters.
{{{7}}}
AKEV		Akira Environment	AKEV...	local	It's the 3D level model (linking to many subtypes for the actual 3D data -- AABB, ABNA, AGDB, AGQG, AGQC, AGQR, AKAA, AKBA, AKBP, AKDA, AKOT, AKVA, IDXA, PLEA, PNTA, TXCA, and TXMA). This type exports as a Collada (.dae) file, meant to be edited in a 3D modeler like Mod Tool.
{{{7}}}
CONS		Console	CONSconsole...	global	There are only three of these models for the consoles used in all of Oni, as documented in Console, though the picture (TXMP) displayed on a specific console varies.
{{{7}}}
DOOR		Door	DOOR...	global	There are 48 types of doors, defined globally for use in the levels.
{{{7}}}
DPge		Diary Page	DPgelev_##_pg_##	global	As seen in the Diary tab of the Pause screen.
{{{7}}}
FILM		Film	FILM...	local	A record of a character's movements, created by a developer recording his gameplay and played back in cutscenes to make an AI perform complex actions. During playback, AIs have no AI. ^_^
{{{7}}}
HPge		Help Page	HPgehelp_pg_01	global	The Help tab of the Pause screen labels the in-game UI and reminds the player of the controls (but only the default bindings, regardless of what the player is actually using...).
{{{7}}}
IGHH		IGUI (In-Game User Interface) HUD Help	IGHHhud_help_info	global	The Help tab of the Pause screen labels the in-game UI using the text found here and the overlay textures it links to.
{{{7}}}
Impt		Impact	Impt...	global	This file is used to build up the hierarchy of impacts. See BINA/ONIE for more information.
{{{7}}}
IPge		Item Page	IPge...	local	As items are picked up, their Item Pages are displayed on the Items tab of the Pause screen.
{{{7}}}
M3GM		Geometry	M3GM...	both	Some of these 3D objects are used by OBAN and PAR3.
{{{7}}}
Mtrl		Material	Mtrl...	global	These files is used to build up the hierarchy of materials. See BINA/ONIE for more information.
{{{7}}}
OBAN		Object Animation	OBAN...	both	Yes, this is used to animate objects, but also characters and cutscene cameras.
{{{7}}}
OFGA		Object Furniture Geometry Array	OFGA...	N/A	Used to import objects with no functions. (Door, consoles, etc. get imported by their object collections. See ONLV for more information.)
{{{7}}}
ONCC		Oni Character Class	ONCC...	local	Here a type of character (Konoko, Striker, etc.) is assigned its weapon skill, behavior ID, vision radius, jumping height, sounds, 3D model (TRBS), animation collection (TRAC), textures (TRMA), and much more. The XML file contains also the character's body part material (CBPM), body part impacts (CBPI), and particles for animations (ONCP and ONIA).)
{{{7}}}
ONCV		Oni Character Variant	ONCV...	global	Used to create a pool of characters from which an AI can be randomly spawned, in order to create a natural variation in appearance. A flag in a CHAR determines which variant the character falls under. It can be also used to upgrade characters on the Hard difficulty level, also determined by a flag in the CHAR.)
{{{7}}}
ONGS		Oni Game Settings	ONGSgame_settings	global	Here you can modify the game's health bar, hypo spray strength, game difficulty, autoprompts (text messages when picking up a new kind of item), etc.
{{{7}}}
ONLD		Oni Game Level Descriptor	ONLDlevel_##	global	Contains the level's number, the number of the next level, and the level's name as it appears on the Load Game screen.
{{{7}}}
ONLV		Oni Game Level	ONLV...	local	Holds, among other things, the name of the BSL folder with the scripts for this level, and links to the AKEV, ONSK, and AISA.
{{{7}}}
ONSK		Oni Sky Class	ONSK...	local	It's essentially a box of textures that sits on the level, so you will need five images for the top, north, east, south and west. The bottom has no image.
{{{7}}}
ONVL		Oni Variant List	ONVLvariant_list	global	It's used to randomize characters' appearances in conjunction with ONCV.
{{{7}}}
ONWC		Oni Weapon Class	ONWCw...	global	Describes the primary and secondary fire mode and more, and links to its particles (PAR3), a 3D model (M3GM), and textures (TXMP).
{{{7}}}
OPge		Objective Page	OPgelevel_##	local	This is the source of the text that appears in the Objective tab of the Pause screen.
{{{7}}}
OSBD		Oni Sound Binary Data	OSBD...	global	They determine how sounds (SNDD) get played.
{{{7}}}
PSpc		Part Specification	PSpc...	both	Specifies coordinates in a certain TXMP which contains a collection of UI elements. The coordinates are used to cut out specific elements for use in drawing the windows in the game.
{{{7}}}
PSpL		Part Specification List	PSpLpartspec_list	global	Links to the PSpc used for the plain-color background of a particular UI (the in-game UI uses black and the out-game UI uses transparency).
{{{7}}}
PSUI		Part Specification UI	PSUIpsui_...	global	Specifies the PSpcs used to paint a certain style of UI. There are only two of these files in Oni, and only PSUIpsui_oniUI is actually used.
{{{7}}}
StNA		String Array	StNA...	global	StNA files are obsolete. However, in the XML docs for it, you'll find collections of flags used by TRAM.
{{{7}}}
SUBT		Subtitle Array	SUBT...	global	This is just here for informational purposes, because subtitle files are extracted to TXT files, not XML.
{{{7}}}
TRAC		(Totoro) Animation Collection	TRAC...	both	Used to build a hierarchy of moves (TRAMs) which form a weighted moveset, based on which parent TRAC(s) a character's TRAC inherits from.
{{{7}}}
TRAM		Totoro Animation Sequence	TRAM...	both	The core animation data for character moves. Exports to Collada (.dae) + XML. The XML file contains the animation's Oni-specific flags, links to particles, and so on.
{{{7}}}
TRAS		Totoro Animation Sequence	TRAS...	both	The pose keyframes defined here are interpolated and overlaid on characters when they aim with weapons.
{{{7}}}
TRBS		Totoro Body Set	TRBS...	local	The 3D model of a character. Character classes (ONCCs) link to these. The 3D data will be imported as Collada (.dae) files, but exporting the ONCC might be preferable.
{{{7}}}
TRGE		Trigger Emitter	TRGEtrigger_emitter_0	global	This file links to the one 3D model (M3GM) used for all laser triggers. Used by TRIG.
{{{7}}}
TRIG		Trigger	TRIG...	global	A laser trigger class.
{{{7}}}
TRMA		Texture Map Array	TRMA...	local	The list of textures used for each body part of a certain character.
{{{7}}}
TRSC		Screen (Aiming) Collection	TRSC...	both	Essentially just links to the TRAS of a character.
{{{7}}}
TXMB		Texture Map Big	TXMB...	both	A series of concatenated TXMPs, used for creating splash screens, like the Main Menu background and level intro/win/loss screens.
{{{7}}}
TXMP		Texture Map	TXMP...	both	This type covers all images in Oni (except the ones larger than 256x256, which are built with TXMB).
{{{7}}}
TxtC		Text Console	TxtClevel_...	local	The pages of text for a given console.
{{{7}}}
WMCL		WM (Window Manager) Cursor List	WMCLcursor_list	global	Simply links to the PSpc which links to the image used for the mouse pointer that appears in Oni.
{{{7}}}
WMDD		WM (Window Manager) Dialog Data	WMDD...	global	Describes the structure of screens like the Main Menu. Because Oni's UI is partially hardcoded, adding new buttons would require engine modding.
{{{7}}}
WMM		WM (Window Manager) Menu	WMM...	global	Drop-down menus used in WMDDs. This type is actually "WMM_", using the underscore in lieu of a fourth letter, but the wiki won't let us end a page in an underscore, so here we call it "WMM".
{{{7}}}
WPge		Weapon Page	WPgew...	global	This is the source for the text and images that appear in the Weapons tab of the Pause screen.
{{{7}}}