From OniGalore
Jump to navigation Jump to search
ONCV : Oni Character Variant
XML modding tips
  • See HERE to start learning about XML modding.
  • See HERE if you are searching for information on how to handle object coordinates.
  • See HERE for some typical modding errors and their causes.

ONCC << Other file types >> ONGS

switch to OBD page

General information

  • The XML on this page is based on OniSplit v0.9.61.0.
  • ONCV*.oni files are global. (They can be found in AE/AEInstaller/vanilla/level0_Final.dat.)
  • This file is used to create randomized appearances for a character and to spawn harder character variants on the Hard difficulty level. Every character in the BINACJBOCharacter can have a flag set (RandomCostume) which allows random selection of an ONCC from the pool formed by links from the ONCCs to a particular ONCV.
This doesn't affect BINACJBOCharacter properties: the character will keep his/her name, melee profile, drop items, etc.
  • New characters with only one costume should use ONCVany.
  • An ONCC referring to a missing ONCV will crash the game. (If you introduce a new ONCV, you must also update ONVL.)
  • It is also used by XML:BINA/SABD to identify which character a set of animation sounds applies to. (Looks like only BINADBASKonoko and BINADBASAny have actual content. The rest are links.)


In ONCVelite_easy.xml, we see that characters in the Elite Striker (easy) class upgrade to the medium variant on Hard difficulty:

<?xml version="1.0" encoding="utf-8"?>
   <ONCV id="0">

The <ParentVariant> is how the pool of variants is constructed. The Elite Striker (easy) has three variants in appearance, described by ONCCelite_easy_1, ONCCelite_easy_2 and ONCCelite_easy_3. Each of these has a Variant tag set to "ONCVelite_easy". When Oni spawns an easy Elite Striker, it looks at all the ONCCs linking to this ONCV and picks one at random.

In ONCVbarabus.xml, we can see that the boss character Barabas doesn't use the Hard difficulty upgrade feature, since there is only one Barabas:

<?xml version="1.0" encoding="utf-8"?>
   <ONCV id="0">

Since the ONCC for Barabas has <ParentVariant> "ONCVbarabus", and no other ONCC does, there is only one possible appearance for Barabas when he spawns in levels.