XML:ONCC: Difference between revisions

From OniGalore
Jump to navigation Jump to search
mNo edit summary
(→‎Variants, geometry, health, etc.: moved supershield info to new Shields page)
 
(54 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
{{XML_File_Header | prev=OFGA | type=ONCC | next=ONCV | name=Oni Character Class}}


 
==General information==
{{Template:XMLModdingHints}}
* The XML on this page is compatible with OniSplit '''v0.9.61.0'''.
{| border=0 cellspacing=20 cellpadding=0 align=center
| The xml code on this page is compatible with onisplit '''v0.9.61.0'''
|}
 
 
=ONCC: Oni Character Class=
'''general information'''
* ONCP, ONIA, OBPI and OBPM are part of '''ONCC*.oni''' files.
* ONCP, ONIA, OBPI and OBPM are part of '''ONCC*.oni''' files.
* ONCC files can be found in Edition/GameDataFolder/level0_Final
* ONCC files are global; they can be found in AE/AEInstaller/vanilla/level0_Final.dat.
* Things that still need deeper explanation:
: '''<DamageFactors>'''
: <CoverConstants>
: <AutoFreezeConstants>
: <LODConstants>
 


==<AirConstants>==
==<AirConstants>==
;Units:times are in frames
;Units
:heights are in world units
*Times are in frames
:velocities are in world units per frames
*Heights are in world units
:accelerations are in world units per frames squared
*Velocities are in world units per frames
;Downwards velocity: could correspond to the steady push experienced when neither jumping nor falling
*Accelerations are in world units per frames squared
:would be roughly equivalent to the starting velocity of a fall
:although the value .55 seems right, the "sinking" seems to be hardcoded now
;Gravity timer:Seems to be hardcoded now (could be the time until gravity switches on)
;Jetpack timer:You can press JUMP multiple times during the time window [http://mods.oni2.net/node/83 (quite fun!)]
;Falling height: let FH1 be <MaxNoDamageFallingHeight>
:let FH2 be <MaxDamageFallingHeight>
:let BH be the base health of the character
:let FH be the actual falling height
:then, if FH > FH2, the character is killed
:if FH < FH1, the character takes no damage
:if FH1 < FH < FH2, the character takes damage (FH - FH1) / (FH2 - FH1) * BH


{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px|<FallGravity>
!width=120px| Content type
|width=40px| float
! Description
| downwards velocity? (always 0.55)
|-
| <FallGravity>
| float
| Always 0.55. Used as the speed of a fall when predicting if an attack will hit a target when the attacker is in midair. It seems to be a bug that this is looked at, as <JumpGravity> actually controls the character's gravity while going up <u>and</u> down.
|-
|-
| <JumpGravity>
| <JumpGravity>
| float
| float
| downward gravity acceleration
| Always in range 0.05-0.07. The strength of gravity (as acceleration per frame) for the entire duration of a jump.
|-
|-
| <JumpStartVelocity>
| <JumpStartVelocity>
| float
| float
| starting velocity for a simple (tap) JUMP
| Starting velocity for a simple jump (tapping JUMP)
|-
|-
| <MaxVelocity>
| <MaxVelocity>
| float
| float
| limit velocity for jumping and gravity flight
| Maximum velocity for jumping and falling
|-
|-
| <JetpackAcceleration>
| <JetpackAcceleration>
| float
| float
| upward acceleration (jetpack) if you hold JUMP  
| Upward acceleration for the duration of time that you hold down JUMP  
|-
|-
| <FramesFallGravity>
| <FramesFallGravity>
| int16
| int16
| gravity timer? (always 7)
| Always 7. After this many frames, <FallGravity> is used for the deceleration of a jump when predicting if an attack will hit a target when the attacker is in midair; before that many frames, <JumpGravity> is used for the prediction. It seems to be a bug that this is field is looked at, as <JumpGravity> controls a character's gravity while going up <u>and</u> down.
|-
|-
| <JetpackTimer>
| <JetpackTimer>
| int16
| int16
| time during which you can use the jetpack
| Standard value is 14, but ranges from 4 (Elite Striker) to 20 (Konoko). This misleadingly-named field is the number of frames for which you can continue holding down JUMP to increase the height of your jump. [http://mods.oni2.net/node/83 This mod] vastly increases the value of this field for Barabas. When shapeshifted to him, you can keep ascending by holding JUMP; pressing JUMP multiple times during the time window is also allowed.
|-
|-
| <MaxNoDamageFallingHeight>
| <MaxNoDamageFallingHeight>
| float
| float
| maximal falling height without damage
| Maximum falling height without taking damage (see below)
|-
|-
| <MaxDamageFallingHeight>
| <MaxDamageFallingHeight>
| float
| float
| maximal falling height with damage
| Maximum falling height with damage
:Let FH1 be <MaxNoDamageFallingHeight>
:Let FH2 be <MaxDamageFallingHeight>
:Let BH be the base health of the character
:Let FH be the actual falling height
:Then, if FH > FH2, the character is killed
:If FH < FH1, the character takes no damage
:If FH1 < FH < FH2, the character takes damage (FH - FH1) / (FH2 - FH1) * BH
|}
|}


==<ShadowConstants>==
==<ShadowConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <Texture>
!width=120px| Content type
|width=40px| float
! Description
| <font color="#777777">TXMP</font>file<font color="#777777">.oni</font>
|-
| <Texture>
| link
| TXMPfile<font color="#777777">.oni (file suffix not used)</font>  
|-
|-
| <MaxHeight>
| <MaxHeight>
| float
| float
| height where the shadow fades out completely
| Height where the diameter of the shadow shrinks to <SizeMin>
|-
|-
| <FadeHeight>
| <FadeHeight>
| float
| float
| height where the diameter of the shadow decreases and the shadow fades out half
| Height range over which the diameter of the shadow decreases from <SizeMax> to <SizeFade> and the shadow starts to fades out from <AlphaMax> to <AlphaFade>
|-
|-
| <SizeMax>
| <SizeMax>
| float
| float
| height where the diameter of the shadow decreases
| Maximum diameter of the shadow
|-
|-
| <SizeFade>
| <SizeFade>
| float
| float
| height where the diameter of the shadow decreases
| Diameter that the shadow shrinks to when <FadeHeight> is reached
|-
|-
| <SizeMin>
| <SizeMin>
| float
| float
| height where the diameter of the shadow decreases
| Minimum diameter of the shadow
|-
|-
| <AlphaMax>
| <AlphaMax>
| int16
| int16
| transparency of the shadow for the first part of a jump
| Starting transparency of the shadow as the character rises towards <FadeHeight>
|-
|-
| <AlphaFade>
| <AlphaFade>
| int16
| int16
| transparency of the shadow for the second part of a jump
| Starting transparency of the shadow when the character begins to get above <FadeHeight>
|}
|}


==<JumpConstants>==
==<JumpConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <JumpDistance>
!width=120px| Content type
|width=40px| float
! Description
| always the same (25)
|-
| <JumpDistance>
| float
| Always 25; unused
|-
|-
| <JumpHeight>
| <JumpHeight>
| int8
| int8
| always the same (22)
| Always 22; unused
|-
|-
| <JumpDistanceSquares>
| <JumpDistanceSquares>
| int8
| int8
| always the same (6)
| Always 6; unused
|}
|}


==<CoverConstants>==
==<CoverConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <RayIncrement>
!width=120px| Content type
|width=40px| float
! Description
|always the same (40)
|-
| <RayIncrement>
| float
| Always 40; unused
|-
|-
| <RayMax>
| <RayMax>
| float
| float
| always the same (300)
| Always 300; unused
|-
|-
| <RayAngle>
| <RayAngle>
| float
| float
| always the same (0.017453 = PI/180)  
| Always 0.017453 /180); unused
|-
|-
| <RayAngleMax>
| <RayAngleMax>
| float
| float
| always the same (1.57 = PI/2)  
| Always 1.57 /2); unused
|}
|}


==<AutoFreezeConstants>==
==<AutoFreezeConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <DistanceXZ>
!width=120px| Content type
|width=40px| float
! Description
| always the same (5)
|-
| <DistanceXZ>
| float
| Always 5; unused
|-
|-
| <DistanceY>
| <DistanceY>
| float
| float
| always the same (1)
| Always 1; unused
|}
|}


==<InventoryConstants>==
==<InventoryConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <HypoRegenerationRate>
!width=120px| Content type
|width=40px| int16
! Description
| (inverse) hypo regeneration rate in frames per health point; overhealth regeneration rate is not affected by this
|-
|valign=top| <HypoRegenerationRate>
|valign=top| int16
| Hypo healing speed in ticks per health point; overhealth regeneration rate is not affected by this


if rate = 60; if a hypo restores 50HP then we get 60/1 * 50 = 3000 frames (50s)<br>  
If rate = 60 and a hypo restores 50HP then we get a total healing time of 60 * 50 = 3000 ticks (50s)<br>  
if rate = 6; if a hypo restores 50HP then we get 6/1 * 50 = 300 frames (5s)<br>
If rate = 6 and a hypo restores 50HP then we get 6 * 50 = 300 ticks (5s)<br>
if rate = 0 it becomes rate = 1 at runtime, so regeneration will still take 50 frames (< 1s)
If rate = 0, it becomes rate = 1 at runtime so regeneration will take 50 ticks (<1s)
|}
|}


==<LODConstants>==
Distances from camera used to choose which [[XML:TRBS|LOD]] (level of detail) to use for a character model. The numbers are stored as squares of the distance in order to be compared quickly against the square of the current distance from the camera without having to perform any square root operations.


==<LODConstants>==
{| class="wikitable" width="100%"
{|
!width=150px| XML tag
{{table}}
!width=120px| Content type
|width=200px| <Float>
! Description
|width=40px| float
|-
| always the same (193600); this is 440 squared
| <Float>
| float
| Always 193,600 (440<sup>2</sup>). Threshold for Super-Low LOD. If the camera is more than 440 world units (147ft or 44m) from a character, this LOD is selected.
|-
|-
| <Float>
| <Float>
| float
| float
| always the same (48400); this is 220 squared
| Always 48,400 (220<sup>2</sup>). Threshold for Low LOD. If the camera is more than 220 world units (73ft or 22m) from a character, this LOD is selected.
|-
|-
| <Float>
| <Float>
| float
| float
| always the same (12100); this is 110 squared
| Always 12,100 (110<sup>2</sup>). Threshold for Medium LOD. If the camera is more than 110 world units (37ft or 11m) from a character, this LOD is selected.
|-
|-
| <Float>
| <Float>
| float
| float
| always the same (0)
| Always 0. This means that the High LOD will always be selected if the camera is 110wu or less from a character.
|-
|-
| <Float>
| <Float>
| float
| float
| always the same (0)
| Always 0. This Super-High LOD is never reached by only looking at camera distance, but continue reading below.
|}
|}


After the above distance-from-camera filter is applied, Oni performs additional calculations which could end up raising or lowering the LOD for this character. See the Graphics article's [[Graphics#LOD|LOD section]] for the details of the logic.


==<HurtSoundConstants>==
==<HurtSoundConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <BasePercentage>
!width=120px| Content type
|width=40px|int16
! Description
| hurt_base_percentage; always the same (35)
|-
| <BasePercentage>
| int16
| Always 35; minimum chance of playing a pain sound (but the actual calculation is much more complicated; see below)
|-
|-
| <MaxPercentage>
| <MaxPercentage>
| int16
| int16
| hurt_max_percentage; always the same (90)
| Always 90; maximum chance of playing a pain sound
|-
|-
| <PercentageThreshold>
| <PercentageThreshold>
| int16
| int16
| hurt_percentage_threshold; always the same (15)
| Always 15; at least this much damage must be done to play a pain sound
|-
|-
| <Timer>
| <Timer>
| int16
| int16
| hurt_timer; always the same (120)
| Always 120; time in ticks before the damage tracker used for this AI's pain sounds resets
|-
|-
| <MinTimer>
| <MinTimer>
| int16
| int16
| hurt_min_timer; always the same (35)
| Always 35; time in ticks that must pass between pain sounds being played, no matter any other considerations
|-
|-
| <MaxLight>
| <MaxLight>
| int16
| int16
| always the same (1)
| Always 1; number of times that AI will play light pain sound before "upgrading" to a medium pain sound upon subsequent damage
|-
|-
| <MaxMedium>
| <MaxMedium>
| int16
| int16
| always the same (2)
| Always 2; number of times that AI will play medium pain sound before "upgrading" to a heavy pain sound upon subsequent damage
|-
|-
| <DeathChance>
| <DeathChance>
| int16
| int16
| always the same (100)
| Always 100; chance of playing a death sound
|-
|-
| <VolumeTreshold>
| <VolumeTreshold>
| int16
| int16
| hurt_volume_threshold; always the same (10)
| Always 10; at least this much damage must be done for the AI to play the pain sound at maximum volume
|-
|-
| <MediumTreshold>
| <MediumTreshold>
| int16
| int16
| hurt_medium_threshold; always the same (12)
| Always 12; after this much cumulative damage, a light pain sound gets upgraded to a medium pain sound
|-
|-
| <HeavyTreshold>
| <HeavyTreshold>
| int16
| int16
| hurt_heavy_threshold; always the same (22)
| Always 22; after this much cumulative damage, a medium pain sound gets upgraded to a heavy pain sound
|-
|-
| <MinVolume>
| <MinVolume>
| float
| float
| minimal sound volume
| Minimal sound volume, e.g. 0.5, used when determining the volume of the pain sound to be played (before <VolumeTreshold> damage is reached and the volume becomes 100%)
|-
|-
| <LightSound>
| <LightSound>
Line 271: Line 275:
|}
|}


If the AI is in an alerted state, has not been hurt within the last <Timer> ticks, and the damage being done is at least <PercentageThreshold>, the chance of playing a pain sound is <BasePercentage> + (damage done * (<MaxPercentage> - <BasePercentage>)) / <PercentageThreshold>. If the AI is alerted and has already received damage within the last <Timer> ticks, they will not play a hurt sound. If the AI is ''not'' in an alerted state, they will always play a hurt sound.


==<AIConstants>==
==<AIConstants>==
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <Flags>
!width=120px| Content type
|width=40|flag
! Description
|-
|valign=top| <Flags>
|valign=top| flag
|
|
: NoStartleAnim
: NoStartleAnim
: EnableMeleeFireDodge
: EnableMeleeFireDodge
: ShootDodge (requires EnableMeleeFireDodge; AI tries to face shooter and shoot back while dodging)
: ShootDodge (requires EnableMeleeFireDodge; AI tries to face shooter and shoot back while dodging)
: RunAwayDodge (requires EnableMeleeFireDodge; overrides ShootDodge; firingspread/projectile dodge enabled for weapons; AI isn't shooting, it just tends to run away, not facing shooter)
: RunAwayDodge (requires EnableMeleeFireDodge; overrides ShootDodge; firing spread/projectile dodge enabled for weapons; AI isn't shooting, it just tends to run away, not facing shooter)
: NotUsed
: NotUsed
|-
|-
Line 290: Line 298:
| <DazedMinFrames>
| <DazedMinFrames>
| int16
| int16
| minimal fallen time; number of frames for which AI remains in *fallen* position when it is knockdowned
| Minimum number of frames for which AI remains in fallen position when it is knocked down
|-
|-
| <DazedMaxFrames>
| <DazedMaxFrames>
| int16
| int16
| maximal fallen time; number of frames for which AI remains in *fallen* position when it is knockdowned
| Maximum number of frames for which AI remains in fallen position when it is knocked down
|-
|-
| <DodgeReactFrames>
| <DodgeReactFrames>
| uint32
| uint32
| number of frames after which AI realizes that it is in the firing spread and it starts dodging
| Number of frames after which AI realizes that it is inside a firing spread and starts dodging
|-
|-
| <DodgeTimeScale>
|valign=top| <DodgeTimeScale>
| float
|valign=top| float
| minimal firingspread dodge amount; IMO similar to maneouvre variable, it tells AI how long it should perform dodging/hiding in response to some time spent inside firing spread (so setting this very high means that once enemy starts dodging/hiding, he will perform it even after firing spread disappears)
| Minimum firing spread dodge amount; similar to the maneuver variable, it tells the AI how long it should continue dodging/hiding in response to being inside a firing spread (so setting this very high means that once the enemy starts dodging/hiding, it will continue even after the firing spread disappears)
|-
|-
| <DodgeWeightScale>
| <DodgeWeightScale>
| float
| float
| maximal firingspread dodge amount; IMO similar to maneouvre variable
| Dampens dodging of firing spread/projectile; the higher it is, the lower priority the AI gives to dodging
|-
|-
| <Targeting>
| <Targeting>
|
|
| see [[#<Targeting>|HERE]]
| See [[#<Targeting>|HERE]]
|-
|-
| <WeaponSkills>
| <WeaponSkills>
|
|
| see [[#<WeaponSkills>|HERE]]
| See [[#<WeaponSkills>|HERE]]
|-
|-
| <DeadMakeSureDelay>
| <DeadMakeSureDelay>
| int32
| int32
| always the same (90), AI waits at the corpse for some time?
| Always 90; how long AI will continue shooting a dead body to make sure it's dead
|-
|-
| <InvestigateBodyDelay>
| <InvestigateBodyDelay>
| int32
| int32
| always the same (240), unused ?
| Always 240; how long AI will stand over dead body before returning to last job
|-
|-
| <LostContactDelay>
| <LostContactDelay>
| int32
| int32
| always the same (180)
| Always 180; how long after losing sight of target until AI engages pursuit mode
|-
|-
| <DeadTauntChance>
| <DeadTauntChance>
| int32
| int32
| chance of AI doing a taunt when player or AI's of another team dies
| Chance of AI taunting a dead body
|-
|-
| <GoForGunChance>
| <GoForGunChance>
| int32
| int32
| determines possibility that AI will run to some weapon and take it; can be checked in devmode by *debug_gun_behavior* command  
| Chance of AI running to some weapon to pick it up; can be checked in Dev Mode with the '''debug_gun_behavior''' command  
|-
|-
| <RunPickupChance>
| <RunPickupChance>
| int32
| int32
| this value is possibility of AI running weapon pickup (acrobatics, slides) instead of normal "stop->pickup"; this is calculated AFTER engine decides that AI should run for weapon
| Chance of AI performing a running weapon pickup (including acrobatics moves, slides) instead of the normal "stop and pick up"; this is calculated ''after'' the engine decides that the AI will go for a gun
|-
|-
| <CombatId>
| <CombatId>
| int16
| int16
| [[OBD_talk:BINA/OBJC/CMBT|combat profile ID]]
| [[XML:BINA/OBJC/CMBT|Combat profile ID]]
|-
|-
| <MeleeId>
| <MeleeId>
| int16
| int16
| [[OBD_talk:BINA/OBJC/MELE|melee profile ID]]
| [[XML:BINA/OBJC/MELE|Melee profile ID]]
|-
|-
| <SoundConstants>
| <SoundConstants>
|
|
| see [[OBD_talk:SNDD#step_1:_preparing_the_TRAM|HERE]]
| See [[XML:SNDD#Step_1:_Preparing_the_TRAM|HERE]]
|-
|-
| <HostileThreatDefiniteTimer>
|valign=top| <HostileThreatDefiniteTimer>
| int32
|valign=top| int32
| how long will AI know exactly where its enemy is even if it can't see him with central vision-field; AI attacks him; can be checked by *ai2_report_verbose* command (this command causes random crashes, beware)
| How long an AI will know exactly where its enemy is even if it can't see him with its central vision field, and attempt to attack him
|-
|-
| <HostileThreatStrongTimer>
|valign=top| <HostileThreatStrongTimer>
| int32
|valign=top| int32
| how long will AI remain in strong feeling that there is the enemy, but will not attack him but investigate; can be checked by *ai2_report_verbose* command
| How long an AI will remain strongly convinced that there is an enemy, but will investigate his presence rather than attempt to attack him
|-
|-
| <HostileThreatWeakTimer>
|valign=top| <HostileThreatWeakTimer>
| int32
|valign=top| int32
| how long will AI remain in weak feeling of an enemy, just looking around aimlessly (Glance pursue mode); can be checked by *ai2_report_verbose* command
| How long an AI will remain weakly convinced of an enemy's presence, looking around aimlessly to find him (Glance pursuit mode)
|-
|-
| <FriendlyThreatDefiniteTimer>
|valign=top| <FriendlyThreatDefiniteTimer>
| int32
|valign=top| int32
| how long will AI know exactly where its ally (Syndicate saw Syndicate for example) is even if it can't see him with central vision-field; AI simply knows there is someone else nearby; maybe has further possibilities; can be checked by *ai2_report_verbose* command (this command causes random crashes, beware)
| This field is mislabeled, as it is actually the decay time for dropping back from high alert to medium alert and does not concern friendly AIs
|-
|-
| <FriendlyThreatStrongTimer>
|valign=top| <FriendlyThreatStrongTimer>
| int32
|valign=top| int32
| how long will AI remain in strong feeling that there is someone else, but will not try to find him or look at him; can be checked by *ai2_report_verbose* command
| This field is mislabeled, as it is actually the decay time for dropping back from medium alert to low alert and does not concern friendly AIs
|-
|-
| <FriendlyThreatWeakTimer>
|valign=top| <FriendlyThreatWeakTimer>
| int32  
|valign=top| int32  
| how long will AI remain in weak feeling of ally, doing its usual job; can be checked by *ai2_report_verbose* command
| This field is mislabeled, as it is actually the decay time for dropping back from low alert to no alert status and does not concern friendly AIs
|-
|-
| <EarshotRadius>
| <EarshotRadius>
| float
| float
| earshot radius; defines size of the sound-collision sphere around AI
| Hearing radius; defines the size of the sound-detection sphere around an AI
|}
|}


You can observe the running of the various timers above by using the '''ai2_report_verbose''' command in the dev console (beware, this command causes random crashes).


===<Targeting>===
===<Targeting>===
{|
{| class="wikitable" width="100%"
{{table}}
!width=150px| XML tag
|width=200px| <StartleMissAngle>
!width=120px| Content type
| width=40px| float
! Description
| always the same for TURR and ONCC (0.5)
|-
| <StartleMissAngle>
| float
| Always has value 0.5 for TURR and ONCC; multiplied against target's distance to get error in AI's/turret's first wild shot
|-
|-
| <StartleMissDistance>
| <StartleMissDistance>
| float
| float
| always the same for TURR and ONCC (25)
| Always has value 25 for TURR and ONCC; max value for result of multiplication above
|-
|-
| <PredictAmount>
| <PredictAmount>
| float
| float
| always the same for TURR
| Always has value 1 for TURR and ONCC; accuracy multiplier for prediction of target's position
|-
|-
| <PredictPositionDelayFrames>
| <PredictPositionDelayFrames>
| int32
| int32
| always the same for TURR
| Always has value 0 for TURR and ONCC; max value for how many frames of lookback can be used to predict target's position
|-
|-
| <PredictDelayFrames>
| <PredictDelayFrames>
| int32
| int32
| always the same for TURR
| Always has value 5 for TURR and ONCC; number of frames delay in recognizing target's current position
|-
|-
| <PredictVelocityFrames>
| <PredictVelocityFrames>
| int32
| int32
| always the same for TURR
| Always has value 15 for TURR and ONCC; number of frames over which AI can average target's velocity to help predict position
|-
|-
| <PredictTrendFrames>
| <PredictTrendFrames>
| int32
| int32
| always the same for TURR
| Always has value 60 for TURR and ONCC; size in frames of location buffer for target
|}
|}


The higher <PredictPositionDelayFrames> is, the further back the AI will look in the position buffer which contains past location information for the target, however this value is always 0 in Oni's data, meaning the current location is used. The recognition of the target's current position is delayed by <PredictDelayFrames>, always 5/60 of a second, which represents something like "reaction time when tracking target". <PredictAmount> can be used to add inaccuracy to this prediction by choosing a value below 1.0, but in Oni's data it is always 1.0.


===<WeaponSkills>===
===<WeaponSkills>===
{|width=100%|
Note that all the following tags are declared for each specific weapon in the game.
|valign=top|


{{Table|width=""|align="left"}}
{| class="wikitable" width="100%"
|-BGCOLOR="#E9E9E9" ALIGN=CENTER
!width=150px| XML tag
!Weapon      ||recoil||bestangle||error||decay||inaccuracy||delays
!width=120px| Content type
|-ALIGN=CENTER   
! Description
|'''w0_sec''' || 0.0  || 0.000000|| 0.00|| 1.0 || 1.0      || 0 - 0
|-
|-ALIGN=CENTER   
| <RecoilCompensation>
|'''w1_tap''' || 0.0  || 0.000000|| 0.40|| 0.4 || 0.0      || 30 - 45
| float
|-ALIGN=CENTER   
| Ranges from 0.0 to 1.0; 1.0 means the weapon will not have any recoil when used by this AI
|'''w2_sap''' || 0.3  || 0.013962|| 0.13|| 1.0 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w3_phr''' || 0.3  || 0.010472|| 0.05|| 0.5 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w4_psm''' || 0.3  || 0.015707|| 0.03|| 0.2 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w5_sbg''' || 0.3  || 0.001745|| 0.00|| 0.1 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w6_vdg''' || 0.3  || 0.001745|| 0.13|| 0.9 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w7_scc''' || 0.3  || 0.001745|| 0.05|| 0.1 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w8_mbo''' || 0.3  || 0.005236|| 0.01|| 0.5 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w9_scr''' || 0.3  || 0.010472|| 0.04|| 0.5 || 1.0     || 0 - 0
|-ALIGN=CENTER   
|'''w10_sni'''|| 0.0  || 0.000000|| 0.00|| 1.0 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w11_ba1'''|| 0.0  || 0.000000|| 0.00|| 1.0 || 1.0      || 0 - 0
|-ALIGN=CENTER   
|'''w12_ba2'''|| 0.0  || 0.000000|| 0.00|| 1.0 || 1.0      || 0 - 0
|}
 
|valign=top|
 
{|
{{table}}
|width=200px| <RecoilCompensation>
|width=40px| float
| (float; 0.0 = min, 1.0 = max)
|-       
|-       
| <BestAimingAngle>
| <BestAimingAngle>
| float
| float
| best aiming angle in radians  
| A floor value in radians for aiming inaccuracy so that an AI never has perfect aim
|-
|-
| <ShotGroupError>
| <ShotGroupError>
| float
| float
| shot grouping error
| An error percentage that is multiplied against the AI's final aim
|-
|-
| <ShotGroupDecay>
| <ShotGroupDecay>
| float
| float
| shot grouping decay
| Ranges from 0.0 to 1.0; how quickly the starting shot error decreases or increases (in other words, the middle of this range is desirable for natural-looking weapons handling)
|-
|-
| <ShootingInaccuracyMultiplier>
| <ShootingInaccuracyMultiplier>
| float
| float
| shooting inaccuracy multiplier
| Inaccuracy multiplier indicating AI's skill with this weapon; usually just 1 (no effect on weapon handling), but sometimes 0 (cancels out inaccuracy)
|-
|-
| <MinShotDelay>
| <MinShotDelay>
| uint16
| uint16
| minimum delay between shots in frames
| Minimum delay in ticks before pulling the trigger again
|-
|-
| <MaxShotDelay>
| <MaxShotDelay>
| uint16
| uint16
| maximum delay between shots in frames
| Maximum delay in ticks before pulling the trigger again
|}
|}


;Shooting skills
These can be viewed with e.g. '''ai2_skill_select konoko_generic w1_tap''' and then either '''ai2_skill_show''' (prints to console) or '''ai2_skill_save''' (prints to file). Sample skill settings for one ONCC are shown below.


;AI Shooting Skills
The first weapon (weapon 0) is not in the game anymore, whatever it was. Mutant Muro's thunderbolt is handled as animation-bound particles, although it used to be handled as a weapon (same for Mukade's Devil Star, except '''w10_sni''' is still available). Barabas' Wave Motion Cannon is a bit mixed up since the beam is made of '''w12_ba2''' particles and the grenade is a '''w11_ba1''' particle.
These can be reviewed with e.g. '''ai2_skill_select konoko_generic w1_tap''' and then either '''ai2_skill_show''' (prints to console) or '''ai2_skill_save''' (prints to file)
 
The first weapon (weapon 0) is not in the game anymore, whatever that was. Muro's thunderbolt is handled as animation-bound particles, although it used to be handled as a weapon (same for Mukade's ball, except '''w10_sni''' is still available) ('''w12_ba2''' and '''w11_ba1''' are a bit mixed up : the beam is made of '''w12_ba2''' particles, and the grenade is a '''w11_ba1''' particle...)
{| class="wikitable" style="text-align:center"
|- bgcolor="#e9e9e9"
!Weapon      ||recoil||best angle||error||decay||inaccuracy||delays
|- align=center   
|'''w0_sec''' || 0.0  || 0.000000 || 0.00 || 1.0 || 1.0      || 0 - 0
|- align=center   
|'''w1_tap''' || 0.0  || 0.000000 || 0.40 || 0.4 || 0.0      || 30 - 45
|- align=center   
|'''w2_sap''' || 0.3  || 0.013962 || 0.13 || 1.0 || 1.0      || 0 - 0
|- align=center   
|'''w3_phr''' || 0.3  || 0.010472 || 0.05 || 0.5 || 1.0      || 0 - 0
|- align=center   
|'''w4_psm''' || 0.3  || 0.015707 || 0.03 || 0.2 || 1.0      || 0 - 0
|- align=center   
|'''w5_sbg''' || 0.3  || 0.001745 || 0.00 || 0.1 || 1.0      || 0 - 0
|- align=center   
|'''w6_vdg''' || 0.3  || 0.001745 || 0.13 || 0.9 || 1.0      || 0 - 0
|- align=center   
|'''w7_scc''' || 0.3  || 0.001745 || 0.05 || 0.1 || 1.0      || 0 - 0
|- align=center   
|'''w8_mbo''' || 0.3  || 0.005236 || 0.01 || 0.5 || 1.0      || 0 - 0
|- align=center   
|'''w9_scr''' || 0.3  || 0.010472 || 0.04 || 0.5 || 1.0      || 0 - 0
|- align=center   
|'''w10_sni'''|| 0.0  || 0.000000 || 0.00 || 1.0 || 1.0      || 0 - 0
|- align=center   
|'''w11_ba1'''|| 0.0  || 0.000000 || 0.00 || 1.0 || 1.0      || 0 - 0
|- align=center   
|'''w12_ba2'''|| 0.0  || 0.000000 || 0.00 || 1.0 || 1.0      || 0 - 0
|}
|}


===<VisionConstants>===
===<VisionConstants>===
;Vision Field
{| class="wikitable" width="100%"
 
!width=150px| XML tag
The "range" and "max" values are logically angles but the cosine of the angle is stored instead for performace reasons. We have the following angles (in degrees):
!width=120px| Content type
 
! Description
{|
|-
|
| <CentralDistance>
: <VerticalRange>0.766044438</VerticalRange>
| float
: <CentralRange>0.819152057</CentralRange>
| Central vision distance
: <CentralMax>0.57357645 </CentralMax>
: <PeripheralRange>0.1736482</PeripheralRange>
: <PeripheralMax>-0.42261824</PeripheralMax>
|
: = 40°
: = 35°
: = 55°
: = 80°
: = 115°
|}
 
Within "range" the "distance" field is used to compute visibility (character is visible if the distance between AI and character is < "distance" field). Between "range" and "max" the visibility distance decreases gradually towards 0. The vision field can be made visible with the script command *ai2_showvision =1* but it should be noted that the rendering might not be accurate. In particular the peripheral vision field it's missing the central segment.
 
 
{|
{{table}}
|width=200px| <CentralDistance>
|width=40px| float
| central vision distance
|-
|-
| <PeripheralDistance>
| <PeripheralDistance>
| float
| float
| peripheral vision distance
| Peripheral vision distance
|-
|-
| <VerticalRange>
| <VerticalRange>
| float
| float
| vertical vision range
| Vertical vision range
|-
|-
| <CentralRange>
| <CentralRange>
| float
| float
| central vision range
| Central vision range
|-
|-
| <CentralMax>
| <CentralMax>
| float
| float
| central vision max
| Central vision max
|-
|-
| <PeripheralRange>
| <PeripheralRange>
| float
| float
| peripheral vision range
| Peripheral vision range
|-
|-
| <PeripheralMax>
| <PeripheralMax>
| float
| float
| peripheral vision max
| Peripheral vision max
|}
|}


;Vision field
An AI's vision field is composed of a central area and peripheral area. See [[AI#Vision_and_hearing|HERE]] for details and illustrations. Put in terms of the data fields above, a character is visible if the distance between the AI and the character is less than the "distance" field. Between each area's "range" and "max" settings, the visibility distance decreases gradually towards 0. The vision field can be seen with the scripting command '''ai2_showvision=1''', but it should be noted that the visualization of the peripheral vision field is missing its central segment.
The "range" and "max" values are angles, but stored as cosines of the angles for performance reasons. Here are some sample angles converted from cosine to degrees:


==ONCV, death particle, TRBS, TRMA, TRAC, TRAS, health, daodan, etc.==
{|
{|
{{table}}
|
|width=200px| <Variant>
: <VerticalRange>0.766044438</VerticalRange>
|width=40px|link
: <CentralRange>0.819152057</CentralRange>
| <font color="#777777">ONCV</font>file<font color="#777777">.oni</font>, defines variants and upgrades  
: <CentralMax>0.57357645</CentralMax>
: <PeripheralRange>0.1736482</PeripheralRange>
: <PeripheralMax>-0.42261824</PeripheralMax>
|
: = 40°
: = 35°
: = 55°
: = 80°
: = 115°
|}
 
==Variants, geometry, health, etc.==
{| class="wikitable" width="100%"
!width=150px| XML tag
!width=120px| Content type
! Description
|-
| <Variant>
| link
| <font color="#777777">ONCV</font>file<font color="#777777">.oni</font>, which defines variants and upgrades; see [[XML:ONCV]] for explanation
|-
|-
| <Particles>
| <Particles>
| link
| link
| [[#ONCP: character particle|ONCP]] instance number (#N)
| [[#ONCP: Oni Character Particle (Array)|ONCP]] instance number (#N)
|-
|-
| <Impacts>
| <Impacts>
| link
| link
| [[#ONIA: Oni character impact array|ONIA]] instance number (#N)
| [[#ONIA: Oni Character Impact Array|ONIA]] instance number (#N)
|-
|-
| <ImpactModifierName>
|valign=top| <ImpactModifierName>
| flag
|valign=top| flag
| used to choose correct effect from [[OBD_talk:BINA/ONIE#XML_flags|ONIE]]; impact name -> material name -> modifier (<Component> must be probably "Impact")
| Used to choose the correct effect from [[XML:BINA/ONIE#List_of_tags.2C_types.2C_and_flags|ONIE]]; impact name -> material name -> modifier (<Component> probably has to be "Impact")
: Any
: Any
: Light
: Light
Line 571: Line 584:
| <Impacts>
| <Impacts>
| link
| link
| holds a lot <ONCCImpact><Name><font color="#777777">Impt</font>name<font color="#777777">.oni</font></Name></ONCCImpact> for character-environment collision; see [[OBD_talk:BINA/ONIE#Visual_guides:_weapon.2C_melee.2C_environment|... ONIE in relation to characters]]
| Holds a lot of links of the format <ONCCImpact><Name><font color="#777777">Impt</font>name<font color="#777777">.oni</font></Name></ONCCImpact> for character-environment collision (see [[XML:BINA/ONIE#Visual_guides:_weapon.2C_melee.2C_environment|HERE]] to learn about that). This seems to be a series of slots for specific animation types so that those animations inherit the Impt value (name). See for example <ONCCImpact><Name>"Fall_LandHard"</Name></ONCCImpact> and the StNA anim type Fall_LandHard.
|-
|-
| <DeathParticle>
| <DeathParticle>
| link
| link
| in vanilla Oni only Mad Bomber uses it
| Only used by the Mad Bomber (his smoking foot)
|-
|-
| <BodySet>
| <BodySet>
Line 587: Line 600:
| <BodyMaterials>
| <BodyMaterials>
| link
| link
| [[#CBPM: character body part materials|CBPM]] instance number (#N)
| [[#CBPM: Character Body Part Materials|CBPM]] instance number (#N)
|-
|-
| <BodyImpacts>
| <BodyImpacts>
| link
| link
| [[#CBPI: character body part impacts|CBPI]] instance number (#N)
| [[#CBPI: Character Body Part Impacts|CBPI]] instance number (#N)
|-
|-
| <FightModeTimer>
| <FightModeTimer>
| int32
| int32
| fight mode timer in 1/60 seconds
| After fight mode is initiated, the character's COMidle animations will play for at least this many ticks. The character will then return to his non-COM idle animations as soon after that as an animation plays which has no COM variant, such as running, so that the COMidle loop has a reason to break. You can see the fight mode timer with '''chr_debug_characters=1'''.
|-
|-
| <IdleAnimation1Timer>
| <IdleAnimation1Timer>
| int32
| int32
| first idle animation timer in 1/60 seconds
| Always 30,000 (= 8.333 minutes). The minimum ticks before an Idle type animation can be played (the engine will add a few frames to the counter, so the exact time is always different). Idle type animation are rarely seen by players because of the long wait time, and are not to be confused with typical idle animations, which use Stand as their type. Idle type animations can be seen in [https://www.youtube.com/watch?v=qbo2Q-VD6dc this video].
|-
|-
| <IdleAnimation2Timer>
| <IdleAnimation2Timer>
| int32
| int32
| second idle animation timer in 1/60 seconds
| Always 30,000 (= 8.333 minutes). The time in ticks before an idle animation is played again.
|-
|-
| <Health>
| <Health>
| int32
| int32
| basic health of the character model; extra health information for every unique character are stored in the [[OBD_talk:BINA/OBJC/CHAR#XML|BINACJBOCharacter.oni]] file
| Base health of the character class; additional health information for each unique character spawned from a class is stored in the [[XML:BINA/OBJC/CHAR#XML_structure|BINACJBOCharacter.oni]] file. If playing on Hard, non-player characters also receive a boost of +25% max HP (this number comes from the [[OBD:ONGS|ONGS]]).
|-
|-
| <FeetBones>
|valign=top| <FeetBones>
| flag
|valign=top| flag
|
|
Unused. Can be:
: LeftFoot
: LeftFoot
: RightFoot
: RightFoot
Line 617: Line 631:
| <MinBodySizeFactor>
| <MinBodySizeFactor>
| float
| float
| minimal body size factor
| Minimum body size factor (for an explanation of body size scaling, see the "Body size factor" on [[OBD:ONCC]])
|-
|-
| <MaxBodySizeFactor>
| <MaxBodySizeFactor>
| float
| float
| maximal body size factor  
| Maximum body size factor  
|-
|-
| <DamageFactors>
| <DamageFactors>
|
|
| see [[#<DamageFactors>|HERE]]
| See [[#<DamageFactors>|HERE]]
|-
|-
| <BossShieldProtectAmount>
| <BossShieldProtectAmount>
| float
| float
| BossShield Protect Amount
| Damage reducer, multiplied against all incoming DamageTypes (can also be applied with '''chr_boss_shield(ai_name)''')
|-
|-
| <Animations>
| <Animations>
Line 641: Line 655:
| <AIRateOfFire>
| <AIRateOfFire>
| int16
| int16
| AI Rate of Fire
| Unused
|-
|-
| <DeathDeleteDelay>
| <DeathDeleteDelay>
| int16
| int16
| time between death and deletion, in frames (about 3 seconds for mad bomber)
| Always 0 except for Mad Bomber, who is 190. The time in ticks that must pass between the character's death and their deletion (replacement by corpse model).
|-
|-
| <WeaponHand>
|valign=top| <WeaponHand>
| flag
|valign=top| flag
|
| Which hand a character uses to hold their weapon. Only ninjas (including Mukade and the ninjabots) are lefthanded.
: 0 (right)
: 0 (right)
: 1 (left)
: 1 (left)
Line 655: Line 669:
| <HasDaodanPowers>
| <HasDaodanPowers>
| int8
| int8
| when set to 1 indicates that character has daodan powers (character does more damage in overpower mode)
| When set to 1, the character has Daodan powers (can overheal with hypos, and do more damage in this overpower mode)
|-
|-
| <HasSupershield>
|valign=top| <HasSupershield>
| int8
|valign=top| int8
| when set to 1 indicates that character has supershield
|
* is visible as red shield when overpowered
Only used by Mutant Muro. When set to 1, the character has a [[supershield]].
* needs daodan flag above and 51% overpower to be enabled; chenille cheat works too
* now it prevents damage from weapon fire and melee (exception are throws)
* received (melee) hits cause not blue block flashes but orange flares (see [http://paradox.oni2.net/Bilder/blocked_attacks_on_51percent_overpower_plus_daodan-flag_plus_supershield.png HERE])
|-
|-
| <CantTouchThis>
| <CantTouchThis>
| int8
| int8
| when set to 1, generically turns on canttouchthis cheat for this ONCC (used by ONCCMutantMuro)
| Only used by Mutant Muro. When set to 1, forces on the [[Cheats|"canttouchthis" cheat]] for this character.
|}
|}


===<DamageFactors>===
The float values in these seven tags correspond to damage types (see [[Particle damage types]] for details). Each one is a multiplier against the StunDamage and Knockback parameters of the DamageBlast and DamageChar PAR3 actions, which utilize these DamageTypes. The values range from 0.0-1.0, where 1.0 totally cancels out damage of that type.


===<DamageFactors>===
{| class="wikitable" width="100%"
The following 7 float values corespond to damage types.
!width=150px| XML tag
{|
!width=120px| Content type
{{table}}
! Description
|width=200px| <Float>
|-
|width=40px| float
| <Float>
| somthing with normal damage ?
| float
| "Normal" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| something with minor stun ?
| "MinorStun" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| major stun timer; specifies how long should be this char stunned when hit with w6_vdg; the longest time possible to be stunned is when this field is zero. Then this ONCC is stunned for 200 frames (30 frames for initial stagger + the rest of the frames is stun animation). The shortest time is for 1.000000 (no stagger/stun at all)
| "MajorStun" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| something with minor knockdown ?
| "MinorKnockdown" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| something with major knockdown ?
| "MajorKnockdown" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| something with blownup ?
| "Blownup" DamageType multiplier
|-
|-
| <Float>
| <Float>
| float
| float
| something with pickup ?
| "Pickup" DamageType multiplier
|}
|}


 
==ONCP: Oni Character Particle (Array)==
==[[OBD:ONCP|ONCP]]: Oni Character Particle (Array)==
* [[OBD:ONCP|ONCPs]] is used for attaching particles to animations. Search for the "Particles" tag in a TRAM XML to see this array.
* ONCP is used for giving particle to animations. Search for "Particles" tag in TRAM file.




Line 721: Line 734:
     </ONCP>
     </ONCP>


: <Name> is anchor for TRAM link; vanilla names:
: <Name> is used for linking from a TRAM; here are the names available in Oni's data:
:: '''acid''' - for death event in bio lab (level 3)
:: acid - for Konoko's death event in Vago Biotech (level 3)
:: barabwave - for Baraba's earthquaker
:: barabwave - for Barabas' earthquaker
:: blanka - for one of MutantMuro's special attacks
:: blanka - for Mutant Muro's repelling lightning attack
:: '''contrail''' - for colored heavy attacks (character specific <Type>)
:: contrail - for attacks that use colored contrails (character specific <Type>)
:: daodan - Konoko's daodan blow
:: daodan - for the blast from Konoko's Daodan super-surge
:: daodan2 - Konoko's daodan blow (last level)
:: daodan2 - for the blast from Konoko's final Daodan super-surge at the end of the game
:: '''death'''
:: death - the dust-like death particle
:: '''dust'''
:: dust - the ground-level particle when player lands from a great height
:: fireball - Mukade's devil star
:: fireball - Mukade's Devil Star
:: flash - attack impact flash
:: flash - attack impact flash
:: '''glow''' - colored glow particle for attacks
:: glow - colored glow particle for attacks
:: murowave - for MutantMuro's ''ass bomb''
:: murowave - for Mutant Muro's ''ass bomb''
:: '''snap''' - health indicator particle ?
:: snap - for Muro's neck snap move?
:: teleport - for Mukade's teleport animation
:: teleport - for Mukade's teleport animation
:: '''thud'''
:: thud
:: thunderbolt - for one of MutantMuro's special attacks
:: thunderbolt - for Mutant Muro's attraction lightning attack
:: '''trail''' - white color contrail for standard attacks
:: trail - white-colored contrail for standard attacks
:: rocket - for Baraba's jetpack
:: rocket - for Barabas' jetpack
:: super_attractor - for MutantMuro
:: super_attractor - for MutantMuro
:: super_glow - body daodan glow particle
:: super_glow - Daodan glow particle for body
:: super_l_hand - left hand daodan glow particle (<BodyPart>LeftFist)
:: super_l_hand - Daodan glow particle for left hand (<BodyPart>LeftFist)
:: super_r_hand - right hand daodan glow particle (<BodyPart>RightFist)
:: super_r_hand - Daodan glow particle for right hand (<BodyPart>RightFist)
: <Type> provide particle (file name without prefix BINA3RAP and without suffix .oni)
: <Type> provides the particle class (file name without prefix BINA3RAP and without suffix .oni)
: <BodyPart> means bone Id, see [[OBD:TRIA#Bones|TRIA]]; also allowed: "KillImpact"
: <BodyPart> means the bone ID; see [[OBD:TRIA#Bones|TRIA]] and [[XML:TRBS]]
 
:: The bones have these names in XML:
 
Pelvis
==[[OBD:ONIA|ONIA]]: Oni Character Impact Array==
LeftThigh
* ONIA is used for special attacks as kind of extension to [[#OBPI:_character_body_part_impacts|CBPI]] in ONIE.
LeftCalf
* <Name> is anchor for TRAM link, <Type> and <Modifier> are links for ONIE. "Light", "Medium" and "Heavy" are possible modifier.
LeftFoot
* See [[OBD_talk:BINA/ONIE#ONIE:_impact_effects|ONIE]] for more information.
RightThigh
RightCalf
RightFoot
Mid
Chest
Neck
Head
LeftShoulder
LeftArm
LeftWrist
LeftFist
RightShoulder
RightArm
RightWrist
RightFist
KillImpact
None


==ONIA: Oni Character Impact Array==
* [[OBD:ONIA|ONIAs]] are used for special attacks, as a kind of extension to [[#CBPI:_Character_Body_Part_Impacts|CBPI]] in ONIEs. See [[XML:BINA/ONIE|ONIE]] for more information.
* <Name> is used for linking from a TRAM. <Type> and <Modifier> are for links to ONIE. "Light", "Medium" and "Heavy" are the possible choices for <Modifier>.


'''XML structure'''
'''XML structure'''
Line 765: Line 797:
     </ONIA>
     </ONIA>


 
==CBPM: Character Body Part Materials==
==[[OBD_talk:ONCC#CBPM|CBPM]]: Character Body Part Materials==
* [[OBD:CBPM|CBPMs]] link to [[XML:Mtrl|Mtrls]] which are used by [[XML:BINA/ONIE|ONIEs]].
* CBPM link to [[OBD_talk:Mtrl#Mtrl:_materials|Mtrl]] files which are used by [[OBD_talk:BINA/ONIE#ONIE:_impact_effects|ONIE]].
 


'''XML structure'''
'''XML structure'''


The link Id is equal to bone list in [[OBD:TRIA#Bones|TRIA]]. For example: eleventh material links to character's head.
The link ID lines up with the bone list in [[OBD:TRIA#Bones|TRIA]]. For example, the eleventh material links to the character's head.


     <CBPM id="7">
     <CBPM id="7">
Line 798: Line 828:
     </CBPM>
     </CBPM>


 
==CBPI: Character Body Part Impacts==
==[[OBD:CBPI|CBPI]]: Character Body Part Impacts==
* [[OBD:CBPI|CBPIs]] link to [[XML:Impt|Impts]] which are used by [[XML:BINA/ONIE|ONIEs]].
* They link to [[OBD_talk:Impt#Impt:_impacts|Impt]] files which are used by [[OBD_talk:BINA/ONIE#ONIE:_impact_effects|ONIE]].
* Special attacks have their own Impts. See [[#ONIA:_Oni_Character_Impact_Array|ONIA]].
* Special attacks have there own Impt files. See [[#ONIA:_Oni_character_impact_array|ONIA]].
 


'''XML structure'''
'''XML structure'''


The link Id is equal to bone list in [[OBD:TRIA#Bones|TRIA]]. For example: eleventh material links to character's head.
The link ID lines up with the bone list in [[OBD:TRIA#Bones|TRIA]]. For example, the eleventh impact links to the character's head.
     <CBPI id="8">
     <CBPI id="8">
         <HitImpacts>
         <HitImpacts>
Line 873: Line 901:
     </CBPI>
     </CBPI>


=special ONCC overview=
==List of all ONCCs==
"Here you can download the complete overview of all used different ONCC files as a text file.<BR>Copy it to a spreadsheet calculation program like Excel." - '''[[User_talk:Ssg|ssg]]'''
  barabus
*http://ssg.oni2.net/subfold/text/oni_oncc_dp.txt
  bdfem_1
*http://ssg.oni2.net/subfold/text/oni_oncc_dc.txt
  bdfem_2
  bdfem_3
  bdfem_4
  bd_1
  bd_2
  bd_3
  bd_4
  bd_5
  comguy_1
  comguy_2
  comguy_3
  CopfemA1
  CopfemA2
  CopmaleA1
  CopmaleA2
  CopmaleA3
  CopmaleA4
  elite_easy_1
  elite_easy_2
  elite_easy_3
  elite_hard_1
  elite_hard_2
  elite_hard_3
  elite_med_1
  elite_med_2
  elite_med_3
  generic_female_1
  generic_female_2
  generic_female_3
  generic_female_4
  generic_female_5
  generic_female_6
  generic_female_7
  generic_female_8
  generic_female_9
  generic_male_1
  generic_male_2
  generic_male_3
  generic_male_4
  generic_male_5
  generic_male_6
  griffin_generic
  griffin_swat
  k3
  k4_A
  k4_F
  k4_G
  k4_K
  k4_L
  konoko_generic
  mad_bomber
  muro_generic
  mutantmuro
  ninjabot
  ninja_easy_1
  ninja_easy_2
  ninja_easy_3
  ninja_hard_1
  ninja_hard_2
  ninja_hard_3
  ninja_med_1
  ninja_med_2
  ninja_med_3
  red_easy_1
  red_easy_2
  red_easy_3
  red_hard_1
  red_hard_2
  red_hard_3
  red_med_1
  red_med_2
  red_med_3
  security_guard_1
  security_guard_2
  Shinzom_generic
  SH_dream_lab
  SH_generic
  sniper_generic
  striker_dream_lab
  striker_easy_1
  striker_easy_2
  striker_easy_3
  striker_hard_1
  striker_hard_2
  striker_hard_3
  striker_med_1
  striker_med_2
  striker_med_3
  super_ninja_1
  tanker_easy_1
  tanker_hard_1
  tanker_med_1
  TCTF_lite_1
  TCTF_lite_blackops_1
  TCTF_swat_1
  TCTF_swat_blackops_1
  thug_air_1
  thug_air_2
  thug_air_3
  thug_air_4
  thug_air_5
  thug_mfg_1
  thug_mfg_2
  thug_mfg_3
  thug_mfg_4
  thug_mfg_5
  thug_neuro_1
  thug_neuro_2
  thug_neuro_3
  thug_neuro_4
  thug_neuro_5
  thug_pow_1
  thug_pow_2
  thug_pow_3
  thug_pow_4
  thug_pow_5
  thug_wh_1
  thug_wh_2
  thug_wh_3
  thug_wh_4
  thug_wh_5
 
==New character balance==
To know if a character you're creating is sufficiently balanced, you should compare Oni's vanilla characters against it. Factors that could be taken into account:
* Basic:
** Health
** Block chances (melee profile)
** Attack strength (per combat TRAM)
** Attack speed (frame count per combat TRAM)
* Advanced:
** Damage multipliers (<DamageFactors>)
** Average damage of combat animation set
** Average damage per second (DPS)
 
{{XML}}

Latest revision as of 02:34, 26 October 2023

ONCC : Oni Character Class
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.
XML.png
XML

OFGA << Other file types >> ONCV

switch to OBD page

General information

  • The XML on this page is compatible with OniSplit v0.9.61.0.
  • ONCP, ONIA, OBPI and OBPM are part of ONCC*.oni files.
  • ONCC files are global; they can be found in AE/AEInstaller/vanilla/level0_Final.dat.

<AirConstants>

Units
  • Times are in frames
  • Heights are in world units
  • Velocities are in world units per frames
  • Accelerations are in world units per frames squared
XML tag Content type Description
<FallGravity> float Always 0.55. Used as the speed of a fall when predicting if an attack will hit a target when the attacker is in midair. It seems to be a bug that this is looked at, as <JumpGravity> actually controls the character's gravity while going up and down.
<JumpGravity> float Always in range 0.05-0.07. The strength of gravity (as acceleration per frame) for the entire duration of a jump.
<JumpStartVelocity> float Starting velocity for a simple jump (tapping JUMP)
<MaxVelocity> float Maximum velocity for jumping and falling
<JetpackAcceleration> float Upward acceleration for the duration of time that you hold down JUMP
<FramesFallGravity> int16 Always 7. After this many frames, <FallGravity> is used for the deceleration of a jump when predicting if an attack will hit a target when the attacker is in midair; before that many frames, <JumpGravity> is used for the prediction. It seems to be a bug that this is field is looked at, as <JumpGravity> controls a character's gravity while going up and down.
<JetpackTimer> int16 Standard value is 14, but ranges from 4 (Elite Striker) to 20 (Konoko). This misleadingly-named field is the number of frames for which you can continue holding down JUMP to increase the height of your jump. This mod vastly increases the value of this field for Barabas. When shapeshifted to him, you can keep ascending by holding JUMP; pressing JUMP multiple times during the time window is also allowed.
<MaxNoDamageFallingHeight> float Maximum falling height without taking damage (see below)
<MaxDamageFallingHeight> float Maximum falling height with damage
Let FH1 be <MaxNoDamageFallingHeight>
Let FH2 be <MaxDamageFallingHeight>
Let BH be the base health of the character
Let FH be the actual falling height
Then, if FH > FH2, the character is killed
If FH < FH1, the character takes no damage
If FH1 < FH < FH2, the character takes damage (FH - FH1) / (FH2 - FH1) * BH

<ShadowConstants>

XML tag Content type Description
<Texture> link TXMPfile.oni (file suffix not used)
<MaxHeight> float Height where the diameter of the shadow shrinks to <SizeMin>
<FadeHeight> float Height range over which the diameter of the shadow decreases from <SizeMax> to <SizeFade> and the shadow starts to fades out from <AlphaMax> to <AlphaFade>
<SizeMax> float Maximum diameter of the shadow
<SizeFade> float Diameter that the shadow shrinks to when <FadeHeight> is reached
<SizeMin> float Minimum diameter of the shadow
<AlphaMax> int16 Starting transparency of the shadow as the character rises towards <FadeHeight>
<AlphaFade> int16 Starting transparency of the shadow when the character begins to get above <FadeHeight>

<JumpConstants>

XML tag Content type Description
<JumpDistance> float Always 25; unused
<JumpHeight> int8 Always 22; unused
<JumpDistanceSquares> int8 Always 6; unused

<CoverConstants>

XML tag Content type Description
<RayIncrement> float Always 40; unused
<RayMax> float Always 300; unused
<RayAngle> float Always 0.017453 (π/180); unused
<RayAngleMax> float Always 1.57 (π/2); unused

<AutoFreezeConstants>

XML tag Content type Description
<DistanceXZ> float Always 5; unused
<DistanceY> float Always 1; unused

<InventoryConstants>

XML tag Content type Description
<HypoRegenerationRate> int16 Hypo healing speed in ticks per health point; overhealth regeneration rate is not affected by this

If rate = 60 and a hypo restores 50HP then we get a total healing time of 60 * 50 = 3000 ticks (50s)
If rate = 6 and a hypo restores 50HP then we get 6 * 50 = 300 ticks (5s)
If rate = 0, it becomes rate = 1 at runtime so regeneration will take 50 ticks (<1s)

<LODConstants>

Distances from camera used to choose which LOD (level of detail) to use for a character model. The numbers are stored as squares of the distance in order to be compared quickly against the square of the current distance from the camera without having to perform any square root operations.

XML tag Content type Description
<Float> float Always 193,600 (4402). Threshold for Super-Low LOD. If the camera is more than 440 world units (147ft or 44m) from a character, this LOD is selected.
<Float> float Always 48,400 (2202). Threshold for Low LOD. If the camera is more than 220 world units (73ft or 22m) from a character, this LOD is selected.
<Float> float Always 12,100 (1102). Threshold for Medium LOD. If the camera is more than 110 world units (37ft or 11m) from a character, this LOD is selected.
<Float> float Always 0. This means that the High LOD will always be selected if the camera is 110wu or less from a character.
<Float> float Always 0. This Super-High LOD is never reached by only looking at camera distance, but continue reading below.

After the above distance-from-camera filter is applied, Oni performs additional calculations which could end up raising or lowering the LOD for this character. See the Graphics article's LOD section for the details of the logic.

<HurtSoundConstants>

XML tag Content type Description
<BasePercentage> int16 Always 35; minimum chance of playing a pain sound (but the actual calculation is much more complicated; see below)
<MaxPercentage> int16 Always 90; maximum chance of playing a pain sound
<PercentageThreshold> int16 Always 15; at least this much damage must be done to play a pain sound
<Timer> int16 Always 120; time in ticks before the damage tracker used for this AI's pain sounds resets
<MinTimer> int16 Always 35; time in ticks that must pass between pain sounds being played, no matter any other considerations
<MaxLight> int16 Always 1; number of times that AI will play light pain sound before "upgrading" to a medium pain sound upon subsequent damage
<MaxMedium> int16 Always 2; number of times that AI will play medium pain sound before "upgrading" to a heavy pain sound upon subsequent damage
<DeathChance> int16 Always 100; chance of playing a death sound
<VolumeTreshold> int16 Always 10; at least this much damage must be done for the AI to play the pain sound at maximum volume
<MediumTreshold> int16 Always 12; after this much cumulative damage, a light pain sound gets upgraded to a medium pain sound
<HeavyTreshold> int16 Always 22; after this much cumulative damage, a medium pain sound gets upgraded to a heavy pain sound
<MinVolume> float Minimal sound volume, e.g. 0.5, used when determining the volume of the pain sound to be played (before <VolumeTreshold> damage is reached and the volume becomes 100%)
<LightSound> char[32] OSBDfile.imp.oni (only the file name)
<MediumSound> char[32] OSBDfile.imp.oni (only the file name)
<HeavySound> char[32] OSBDfile.imp.oni (only the file name)
<DeathSound> char[32] OSBDfile.imp.oni (only the file name)

If the AI is in an alerted state, has not been hurt within the last <Timer> ticks, and the damage being done is at least <PercentageThreshold>, the chance of playing a pain sound is <BasePercentage> + (damage done * (<MaxPercentage> - <BasePercentage>)) / <PercentageThreshold>. If the AI is alerted and has already received damage within the last <Timer> ticks, they will not play a hurt sound. If the AI is not in an alerted state, they will always play a hurt sound.

<AIConstants>

XML tag Content type Description
<Flags> flag
NoStartleAnim
EnableMeleeFireDodge
ShootDodge (requires EnableMeleeFireDodge; AI tries to face shooter and shoot back while dodging)
RunAwayDodge (requires EnableMeleeFireDodge; overrides ShootDodge; firing spread/projectile dodge enabled for weapons; AI isn't shooting, it just tends to run away, not facing shooter)
NotUsed
<RotationSpeed> float AI rotation speed factor. Reference rotation speed is about 1 turn (360°) per second. The setting is only effective if the AI is in control, so it's a bit like the AI's mouse sensitivity :)
<DazedMinFrames> int16 Minimum number of frames for which AI remains in fallen position when it is knocked down
<DazedMaxFrames> int16 Maximum number of frames for which AI remains in fallen position when it is knocked down
<DodgeReactFrames> uint32 Number of frames after which AI realizes that it is inside a firing spread and starts dodging
<DodgeTimeScale> float Minimum firing spread dodge amount; similar to the maneuver variable, it tells the AI how long it should continue dodging/hiding in response to being inside a firing spread (so setting this very high means that once the enemy starts dodging/hiding, it will continue even after the firing spread disappears)
<DodgeWeightScale> float Dampens dodging of firing spread/projectile; the higher it is, the lower priority the AI gives to dodging
<Targeting> See HERE
<WeaponSkills> See HERE
<DeadMakeSureDelay> int32 Always 90; how long AI will continue shooting a dead body to make sure it's dead
<InvestigateBodyDelay> int32 Always 240; how long AI will stand over dead body before returning to last job
<LostContactDelay> int32 Always 180; how long after losing sight of target until AI engages pursuit mode
<DeadTauntChance> int32 Chance of AI taunting a dead body
<GoForGunChance> int32 Chance of AI running to some weapon to pick it up; can be checked in Dev Mode with the debug_gun_behavior command
<RunPickupChance> int32 Chance of AI performing a running weapon pickup (including acrobatics moves, slides) instead of the normal "stop and pick up"; this is calculated after the engine decides that the AI will go for a gun
<CombatId> int16 Combat profile ID
<MeleeId> int16 Melee profile ID
<SoundConstants> See HERE
<HostileThreatDefiniteTimer> int32 How long an AI will know exactly where its enemy is even if it can't see him with its central vision field, and attempt to attack him
<HostileThreatStrongTimer> int32 How long an AI will remain strongly convinced that there is an enemy, but will investigate his presence rather than attempt to attack him
<HostileThreatWeakTimer> int32 How long an AI will remain weakly convinced of an enemy's presence, looking around aimlessly to find him (Glance pursuit mode)
<FriendlyThreatDefiniteTimer> int32 This field is mislabeled, as it is actually the decay time for dropping back from high alert to medium alert and does not concern friendly AIs
<FriendlyThreatStrongTimer> int32 This field is mislabeled, as it is actually the decay time for dropping back from medium alert to low alert and does not concern friendly AIs
<FriendlyThreatWeakTimer> int32 This field is mislabeled, as it is actually the decay time for dropping back from low alert to no alert status and does not concern friendly AIs
<EarshotRadius> float Hearing radius; defines the size of the sound-detection sphere around an AI

You can observe the running of the various timers above by using the ai2_report_verbose command in the dev console (beware, this command causes random crashes).

<Targeting>

XML tag Content type Description
<StartleMissAngle> float Always has value 0.5 for TURR and ONCC; multiplied against target's distance to get error in AI's/turret's first wild shot
<StartleMissDistance> float Always has value 25 for TURR and ONCC; max value for result of multiplication above
<PredictAmount> float Always has value 1 for TURR and ONCC; accuracy multiplier for prediction of target's position
<PredictPositionDelayFrames> int32 Always has value 0 for TURR and ONCC; max value for how many frames of lookback can be used to predict target's position
<PredictDelayFrames> int32 Always has value 5 for TURR and ONCC; number of frames delay in recognizing target's current position
<PredictVelocityFrames> int32 Always has value 15 for TURR and ONCC; number of frames over which AI can average target's velocity to help predict position
<PredictTrendFrames> int32 Always has value 60 for TURR and ONCC; size in frames of location buffer for target

The higher <PredictPositionDelayFrames> is, the further back the AI will look in the position buffer which contains past location information for the target, however this value is always 0 in Oni's data, meaning the current location is used. The recognition of the target's current position is delayed by <PredictDelayFrames>, always 5/60 of a second, which represents something like "reaction time when tracking target". <PredictAmount> can be used to add inaccuracy to this prediction by choosing a value below 1.0, but in Oni's data it is always 1.0.

<WeaponSkills>

Note that all the following tags are declared for each specific weapon in the game.

XML tag Content type Description
<RecoilCompensation> float Ranges from 0.0 to 1.0; 1.0 means the weapon will not have any recoil when used by this AI
<BestAimingAngle> float A floor value in radians for aiming inaccuracy so that an AI never has perfect aim
<ShotGroupError> float An error percentage that is multiplied against the AI's final aim
<ShotGroupDecay> float Ranges from 0.0 to 1.0; how quickly the starting shot error decreases or increases (in other words, the middle of this range is desirable for natural-looking weapons handling)
<ShootingInaccuracyMultiplier> float Inaccuracy multiplier indicating AI's skill with this weapon; usually just 1 (no effect on weapon handling), but sometimes 0 (cancels out inaccuracy)
<MinShotDelay> uint16 Minimum delay in ticks before pulling the trigger again
<MaxShotDelay> uint16 Maximum delay in ticks before pulling the trigger again
Shooting skills

These can be viewed with e.g. ai2_skill_select konoko_generic w1_tap and then either ai2_skill_show (prints to console) or ai2_skill_save (prints to file). Sample skill settings for one ONCC are shown below.

The first weapon (weapon 0) is not in the game anymore, whatever it was. Mutant Muro's thunderbolt is handled as animation-bound particles, although it used to be handled as a weapon (same for Mukade's Devil Star, except w10_sni is still available). Barabas' Wave Motion Cannon is a bit mixed up since the beam is made of w12_ba2 particles and the grenade is a w11_ba1 particle.

Weapon recoil best angle error decay inaccuracy delays
w0_sec 0.0 0.000000 0.00 1.0 1.0 0 - 0
w1_tap 0.0 0.000000 0.40 0.4 0.0 30 - 45
w2_sap 0.3 0.013962 0.13 1.0 1.0 0 - 0
w3_phr 0.3 0.010472 0.05 0.5 1.0 0 - 0
w4_psm 0.3 0.015707 0.03 0.2 1.0 0 - 0
w5_sbg 0.3 0.001745 0.00 0.1 1.0 0 - 0
w6_vdg 0.3 0.001745 0.13 0.9 1.0 0 - 0
w7_scc 0.3 0.001745 0.05 0.1 1.0 0 - 0
w8_mbo 0.3 0.005236 0.01 0.5 1.0 0 - 0
w9_scr 0.3 0.010472 0.04 0.5 1.0 0 - 0
w10_sni 0.0 0.000000 0.00 1.0 1.0 0 - 0
w11_ba1 0.0 0.000000 0.00 1.0 1.0 0 - 0
w12_ba2 0.0 0.000000 0.00 1.0 1.0 0 - 0

<VisionConstants>

XML tag Content type Description
<CentralDistance> float Central vision distance
<PeripheralDistance> float Peripheral vision distance
<VerticalRange> float Vertical vision range
<CentralRange> float Central vision range
<CentralMax> float Central vision max
<PeripheralRange> float Peripheral vision range
<PeripheralMax> float Peripheral vision max
Vision field

An AI's vision field is composed of a central area and peripheral area. See HERE for details and illustrations. Put in terms of the data fields above, a character is visible if the distance between the AI and the character is less than the "distance" field. Between each area's "range" and "max" settings, the visibility distance decreases gradually towards 0. The vision field can be seen with the scripting command ai2_showvision=1, but it should be noted that the visualization of the peripheral vision field is missing its central segment.

The "range" and "max" values are angles, but stored as cosines of the angles for performance reasons. Here are some sample angles converted from cosine to degrees:

<VerticalRange>0.766044438</VerticalRange>
<CentralRange>0.819152057</CentralRange>
<CentralMax>0.57357645</CentralMax>
<PeripheralRange>0.1736482</PeripheralRange>
<PeripheralMax>-0.42261824</PeripheralMax>
= 40°
= 35°
= 55°
= 80°
= 115°

Variants, geometry, health, etc.

XML tag Content type Description
<Variant> link ONCVfile.oni, which defines variants and upgrades; see XML:ONCV for explanation
<Particles> link ONCP instance number (#N)
<Impacts> link ONIA instance number (#N)
<ImpactModifierName> flag Used to choose the correct effect from ONIE; impact name -> material name -> modifier (<Component> probably has to be "Impact")
Any
Light
Medium
Heavy
<Impacts> link Holds a lot of links of the format <ONCCImpact><Name>Imptname.oni</Name></ONCCImpact> for character-environment collision (see HERE to learn about that). This seems to be a series of slots for specific animation types so that those animations inherit the Impt value (name). See for example <ONCCImpact><Name>"Fall_LandHard"</Name></ONCCImpact> and the StNA anim type Fall_LandHard.
<DeathParticle> link Only used by the Mad Bomber (his smoking foot)
<BodySet> link TRBSfile.oni
<BodyTextures> link TRMAfile.oni
<BodyMaterials> link CBPM instance number (#N)
<BodyImpacts> link CBPI instance number (#N)
<FightModeTimer> int32 After fight mode is initiated, the character's COMidle animations will play for at least this many ticks. The character will then return to his non-COM idle animations as soon after that as an animation plays which has no COM variant, such as running, so that the COMidle loop has a reason to break. You can see the fight mode timer with chr_debug_characters=1.
<IdleAnimation1Timer> int32 Always 30,000 (= 8.333 minutes). The minimum ticks before an Idle type animation can be played (the engine will add a few frames to the counter, so the exact time is always different). Idle type animation are rarely seen by players because of the long wait time, and are not to be confused with typical idle animations, which use Stand as their type. Idle type animations can be seen in this video.
<IdleAnimation2Timer> int32 Always 30,000 (= 8.333 minutes). The time in ticks before an idle animation is played again.
<Health> int32 Base health of the character class; additional health information for each unique character spawned from a class is stored in the BINACJBOCharacter.oni file. If playing on Hard, non-player characters also receive a boost of +25% max HP (this number comes from the ONGS).
<FeetBones> flag

Unused. Can be:

LeftFoot
RightFoot
<MinBodySizeFactor> float Minimum body size factor (for an explanation of body size scaling, see the "Body size factor" on OBD:ONCC)
<MaxBodySizeFactor> float Maximum body size factor
<DamageFactors> See HERE
<BossShieldProtectAmount> float Damage reducer, multiplied against all incoming DamageTypes (can also be applied with chr_boss_shield(ai_name))
<Animations> link TRACfile.oni
<AimingScreens> link TRASfile.oni
<AIRateOfFire> int16 Unused
<DeathDeleteDelay> int16 Always 0 except for Mad Bomber, who is 190. The time in ticks that must pass between the character's death and their deletion (replacement by corpse model).
<WeaponHand> flag Which hand a character uses to hold their weapon. Only ninjas (including Mukade and the ninjabots) are lefthanded.
0 (right)
1 (left)
<HasDaodanPowers> int8 When set to 1, the character has Daodan powers (can overheal with hypos, and do more damage in this overpower mode)
<HasSupershield> int8

Only used by Mutant Muro. When set to 1, the character has a supershield.

<CantTouchThis> int8 Only used by Mutant Muro. When set to 1, forces on the "canttouchthis" cheat for this character.

<DamageFactors>

The float values in these seven tags correspond to damage types (see Particle damage types for details). Each one is a multiplier against the StunDamage and Knockback parameters of the DamageBlast and DamageChar PAR3 actions, which utilize these DamageTypes. The values range from 0.0-1.0, where 1.0 totally cancels out damage of that type.

XML tag Content type Description
<Float> float "Normal" DamageType multiplier
<Float> float "MinorStun" DamageType multiplier
<Float> float "MajorStun" DamageType multiplier
<Float> float "MinorKnockdown" DamageType multiplier
<Float> float "MajorKnockdown" DamageType multiplier
<Float> float "Blownup" DamageType multiplier
<Float> float "Pickup" DamageType multiplier

ONCP: Oni Character Particle (Array)

  • ONCPs is used for attaching particles to animations. Search for the "Particles" tag in a TRAM XML to see this array.


XML structure

   <ONCP id="3">
       <Particles>
           <ONCPParticle>
               <Name>...</Name>
               <Type>...</Type>
               <BodyPart>...</BodyPart>
           </ONCPParticle>
           [...]
       </Particles>
   </ONCP>
<Name> is used for linking from a TRAM; here are the names available in Oni's data:
acid - for Konoko's death event in Vago Biotech (level 3)
barabwave - for Barabas' earthquaker
blanka - for Mutant Muro's repelling lightning attack
contrail - for attacks that use colored contrails (character specific <Type>)
daodan - for the blast from Konoko's Daodan super-surge
daodan2 - for the blast from Konoko's final Daodan super-surge at the end of the game
death - the dust-like death particle
dust - the ground-level particle when player lands from a great height
fireball - Mukade's Devil Star
flash - attack impact flash
glow - colored glow particle for attacks
murowave - for Mutant Muro's ass bomb
snap - for Muro's neck snap move?
teleport - for Mukade's teleport animation
thud
thunderbolt - for Mutant Muro's attraction lightning attack
trail - white-colored contrail for standard attacks
rocket - for Barabas' jetpack
super_attractor - for MutantMuro
super_glow - Daodan glow particle for body
super_l_hand - Daodan glow particle for left hand (<BodyPart>LeftFist)
super_r_hand - Daodan glow particle for right hand (<BodyPart>RightFist)
<Type> provides the particle class (file name without prefix BINA3RAP and without suffix .oni)
<BodyPart> means the bone ID; see TRIA and XML:TRBS
The bones have these names in XML:
Pelvis
LeftThigh
LeftCalf
LeftFoot
RightThigh
RightCalf
RightFoot
Mid
Chest
Neck
Head
LeftShoulder
LeftArm
LeftWrist
LeftFist
RightShoulder
RightArm
RightWrist
RightFist
KillImpact
None

ONIA: Oni Character Impact Array

  • ONIAs are used for special attacks, as a kind of extension to CBPI in ONIEs. See ONIE for more information.
  • <Name> is used for linking from a TRAM. <Type> and <Modifier> are for links to ONIE. "Light", "Medium" and "Heavy" are the possible choices for <Modifier>.

XML structure

   <ONIA id="4">
       <Impacts>
           <ONIAImpact>
               <Name>...</Name>
               <Type>Bar_Super_Punch</Type>
               <Modifier>Heavy</Modifier>
           </ONIAImpact>
           [...]
   </ONIA>

CBPM: Character Body Part Materials

XML structure

The link ID lines up with the bone list in TRIA. For example, the eleventh material links to the character's head.

   <CBPM id="7">
        <Materials>
            <Link>MtrlCloth</Link>
            <Link>MtrlCloth</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlCloth</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlCloth</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
            <Link>MtrlArmor</Link>
        </Materials>
   </CBPM>

CBPI: Character Body Part Impacts

XML structure

The link ID lines up with the bone list in TRIA. For example, the eleventh impact links to the character's head.

   <CBPI id="8">
       <HitImpacts>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptKick_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptHead_Hit</Link>
           <Link>ImptHead_Hit</Link>
           <Link>ImptHead_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptHead_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptPunch_Hit</Link>
           <Link>ImptPunch_Hit</Link>
       </HitImpacts>
       <BlockedImpacts>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptKick_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptHead_Blocked</Link>
           <Link>ImptHead_Blocked</Link>
           <Link>ImptHead_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptHead_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
           <Link>ImptPunch_Blocked</Link>
       </BlockedImpacts>
       <KilledImpacts>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptKick_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptHead_Killed</Link>
           <Link>ImptHead_Killed</Link>
           <Link>ImptHead_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptHead_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptPunch_Killed</Link>
           <Link>ImptPunch_Killed</Link>
       </KilledImpacts>
   </CBPI>

List of all ONCCs

 barabus
 bdfem_1
 bdfem_2
 bdfem_3
 bdfem_4
 bd_1
 bd_2
 bd_3
 bd_4
 bd_5
 comguy_1
 comguy_2
 comguy_3
 CopfemA1
 CopfemA2
 CopmaleA1
 CopmaleA2
 CopmaleA3
 CopmaleA4
 elite_easy_1
 elite_easy_2
 elite_easy_3
 elite_hard_1
 elite_hard_2
 elite_hard_3
 elite_med_1
 elite_med_2
 elite_med_3
 generic_female_1
 generic_female_2
 generic_female_3
 generic_female_4
 generic_female_5
 generic_female_6
 generic_female_7
 generic_female_8
 generic_female_9
 generic_male_1
 generic_male_2
 generic_male_3
 generic_male_4
 generic_male_5
 generic_male_6
 griffin_generic
 griffin_swat
 k3
 k4_A
 k4_F
 k4_G
 k4_K
 k4_L
 konoko_generic
 mad_bomber
 muro_generic
 mutantmuro
 ninjabot
 ninja_easy_1
 ninja_easy_2
 ninja_easy_3
 ninja_hard_1
 ninja_hard_2
 ninja_hard_3
 ninja_med_1
 ninja_med_2
 ninja_med_3
 red_easy_1
 red_easy_2
 red_easy_3
 red_hard_1
 red_hard_2
 red_hard_3
 red_med_1
 red_med_2
 red_med_3
 security_guard_1
 security_guard_2
 Shinzom_generic
 SH_dream_lab
 SH_generic
 sniper_generic
 striker_dream_lab
 striker_easy_1
 striker_easy_2
 striker_easy_3
 striker_hard_1
 striker_hard_2
 striker_hard_3
 striker_med_1
 striker_med_2
 striker_med_3
 super_ninja_1
 tanker_easy_1
 tanker_hard_1
 tanker_med_1
 TCTF_lite_1
 TCTF_lite_blackops_1
 TCTF_swat_1
 TCTF_swat_blackops_1
 thug_air_1
 thug_air_2
 thug_air_3
 thug_air_4
 thug_air_5
 thug_mfg_1
 thug_mfg_2
 thug_mfg_3
 thug_mfg_4
 thug_mfg_5
 thug_neuro_1
 thug_neuro_2
 thug_neuro_3
 thug_neuro_4
 thug_neuro_5
 thug_pow_1
 thug_pow_2
 thug_pow_3
 thug_pow_4
 thug_pow_5
 thug_wh_1
 thug_wh_2
 thug_wh_3
 thug_wh_4
 thug_wh_5

New character balance

To know if a character you're creating is sufficiently balanced, you should compare Oni's vanilla characters against it. Factors that could be taken into account:

  • Basic:
    • Health
    • Block chances (melee profile)
    • Attack strength (per combat TRAM)
    • Attack speed (frame count per combat TRAM)
  • Advanced:
    • Damage multipliers (<DamageFactors>)
    • Average damage of combat animation set
    • Average damage per second (DPS)