XML:BINA/ONIE: Difference between revisions

{{XML_BINA_Header | prev=OBJC/CHAR | type=ONIE | next=PAR3 | name=Oni Impact Effects}}

==General information==

* The XML code on this page is compatible with OniSplit '''v0.9.61.0'''.

* BINAEINOimpact_effects.oni is stored ''globally'' (in AE/AEInstaller/vanilla/level0_Final.dat).

==List of tags, types, and flags==

|width=180px| '''XML tag'''

|width=60px| '''Content type'''

| '''Description'''

| Closes with "</Impact>".

 

Impact owner (Impact Name="...") checks on impact target (Material="...").

 

 

 

:Special ONCC (ONIA) impacts: target was kicked by attacker with this ONIA link, blocked and unblocked

:Punch: Punch was unblocked (probably should be blocked and unblocked condition but isn't, ergo: duplicate of Punch_Hit)

 

| Closes with "</Material>". Can hold multiple <ImpactEffect>s if the component and/or the modifier is different.

: Damage

| Radius of sound sphere that allows AI to hear the sound

| When there are no Particles, you will simply see the tag "<Particles />".

| There can be multiple particle tags. They close with "</Particle>". Watch out for [[#Particle structures|different structures]] when setting the <Location> value.

: 1 - impact location + impact direction * offset?

:: The particle is fixed to character if the origin is a particle-character collision, but not fixed if the origin is a character-character collision (for example, look up the plasma shot "w3_phr_x02" and add it in the particle section of <Impact Name="Kick_Hit">).

===Particle structures===

==Visual guides: weapon, melee, environment==

* Red = start node

* These visual guides don't claim be hundred percent right on a technical level. I can't look into the engine. But they should give a good hint which files are worth caring about and how to debug a mistake: going through all important files, e.g. ''Could it be that my new texture is not registered in TMBD?''

:However, if you think you should add information, or shape this in a more accurate way, then do it. =)

|colspan="2" align="center"|'''Overview of involved files when modding ONIE in relation to weapons'''

|width="50%"|'''If weapon shall have impact effect on environment'''

|'''If weapon shall have impact effect on characters'''

[[Image:ONWC-ONIE-AKEV.png|right|thumb]]

* Weapon fires a particle

* Particle creates a sound and hits textured environment

* Texture’s material name is looked up in TMBD (decals do not work)

* Material file is looked up (can hold parent material)

* Effect is chosen from ONIE by weapon and material

* If parent material* exists then it is possible that a second effect is produced

: *Loser’s material “Explosive” has “Glass” as its parent material, which shatters objects when hit; this can destroy any object - not just the "glassworld".

[[Image:ONWC-ONIE-ONCC.png|right|thumb]]

* Weapon fires a particle

* Particle creates a sound and hits character part

* Character part has an ID (probably through <!--TRMA and-->TRIA), ID is sent to CBPM

* Material file is looked up (can hold parent material)

* Effect is chosen from ONIE by weapon and material

* It seems that effects on characters cannot be created through TMBD (still you can see a failed test there called "Character")

* Custom materials can be used for characters in case they are registered in ONIE

|colspan="2" align="center"|'''Overview of involved files when modding ONIE in relation to animations'''

|width="50%"|'''Special attack'''

|'''Normal attack'''

[[Image:ONCC-ONIE-ONCC_sp-a.png|right|thumb]]

[[Image:ONCC-ONIE-ONCC_n-a.png|right|thumb]]

Every ONCC provides one death sound, and three hurt sounds which are played occasionally when melee damage is dealt for this much damage:

* Heavy hurt sound: 15 HP or more.

* Medium hurt sound: 10-14 HP.

* Light hurt sound: less than 10 HP.

|colspan="2" align="center"|'''Overview of involved files when modding ONIE in relation to characters'''

|width="50%"|'''If character hits ground'''

|'''Something left?'''

[[Image:ONCC-ONIE-AKEV.png|right|thumb]]

* The bone ID is used for the character's impact.

* Effect (particle and sound) is chosen from impact and the material through ONIE.

For example, this is used when ''running around''. Every step will trigger a step sound based on the ground's material: dirt, snow, metal, etc.

==Examples==

===Particle - Character===

====Extra damage for head hits====

w1_tap and w2_sap deals additional damage, amount depends on material "head"/"helmet". Feel free to extend/tweak/criticize.

'''Damage overview:'''

'''Basic modifications/new files:'''

* VDG refused to work properly so I modified it to keep the original effect at least.

* Screaming Cells do too much damage in a short time.

* Added [[AE:New_weapons#w15_smg|w15_smg]] into ONIE.

  head +1 +6 +0.7 (because there are more impact-triggering particle)

  unprotected +0-1 +5 +0.3 ([[Gameplay#Weapon_tips|wall reflected]] beam deals no base damage, only the additional, so yes, the beam gets weaker)

  w5_sbg x 30-32 30 25 ("perfect shot" already dealt over 200 points)

 

* modified w12 again (fixed damage type) and w15 particle (exchanged stun and knockdown values from unprotected and helmet)

* w6_vdg wasn't really fixed until now

==Mod conflicts==

'''Example 2:''' Exploding barrels don't work

* The Impt files, Mtrl and BINADBMT are shipped normally to level0_Final because they aren't duplicates. As a consequence, Grey Fury fully works while exploding barrels do not.

==Mod ideas==