OBD:ONWC: Difference between revisions

From OniGalore
Jump to navigation Jump to search
(added skill indexes used by the vanilla weapons)
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{OBD_File_Header | type=ONWC | prev=ONVL | next=OPge | name=Oni Weapon Class | family=Level | align=center}}
{{OBD_File_Header | type=ONWC | prev=ONVL | next=OPge | name=Oni Weapon Class | family=Character | align=center}}




All ONWC files are 0 byte files. That means that Oni takes the information out of the ONWC files of level 0. Below is an example of an ONWC file of level 0. The first pic shows the beginning of this file. The second pic the end of it.  
ONWC files in level[1-19]_Final are 0-byte files. The actual data is in the ONWC files of level 0; below is an example.
 


Unless specified otherwise, the coordinates are relative to the weapon's mesh (x = forwards, y = left, z = up).
Unless specified otherwise, the coordinates are relative to the weapon's mesh (x = forwards, y = left, z = up).
Line 9: Line 8:


==0x000 to 0x0D7 - Weapon main part ==
==0x000 to 0x0D7 - Weapon main part ==
 
[[Image:onwc_a.gif]]
 
[[image:onwc_a.gif]]




Line 47: Line 44:


;Crosshair
;Crosshair
:Default crosshair appears where the laser sight hits environment, corpses, etc
:Default crosshair appears where the laser sight hits environment, corpses, etc.
:Locked crosshair appears when the laser sight hits characters (including the shooter)
:Locked crosshair appears when the laser sight hits characters (including the shooter)
:"Tunnel" is used by '''w8_mbo''' as a complement to the crosshair
:"Tunnel" is used by '''w8_mbo''' as a complement to the crosshair
Line 67: Line 64:
{{OBDtr| 0x060 | link    |C87C64| 01 76 0E 00 | 3702          | link to 03702-.M3GM }}
{{OBDtr| 0x060 | link    |C87C64| 01 76 0E 00 | 3702          | link to 03702-.M3GM }}
{{OBDtr2|0x064 | char[32] |B0C3D4| w1_tap                      | weapon name }}
{{OBDtr2|0x064 | char[32] |B0C3D4| w1_tap                      | weapon name }}
{{OBDtr| 0x084 | float    |E7CEA5| 00 00 80 3F | 1.000000      | weapon mouse sensitivity (applies on AI, too) }}
{{OBDtr| 0x084 | float    |E7CEA5| 00 00 80 3F | 1.000000      | weapon mouse sensitivity (applies to AI, too) }}
{{OBDtr| 0x088 | float    |E7CEA5| A6 92 2B 3D | 0.041888      | recoil base (e.g. for w1_tap and w2_sap) }}
{{OBDtr| 0x088 | float    |E7CEA5| A6 92 2B 3D | 0.041888      | recoil base (e.g. for w1_tap and w2_sap) }}
{{OBDtr| 0x08C | float    |E7CEA5| 92 0A 86 3E | 0.261799      | recoil max }}
{{OBDtr| 0x08C | float    |E7CEA5| 92 0A 86 3E | 0.261799      | recoil max }}
Line 73: Line 70:
{{OBDtr| 0x094 | float    |E7CEA5| E2 A3 7B 3B | 0.003839      | recoil return speed }}
{{OBDtr| 0x094 | float    |E7CEA5| E2 A3 7B 3B | 0.003839      | recoil return speed }}
{{OBDtr| 0x098 | float    |E7CEA5| 88 C3 E4 3A | 0.001745      | recoil firing return speed }}
{{OBDtr| 0x098 | float    |E7CEA5| 88 C3 E4 3A | 0.001745      | recoil firing return speed }}
{{OBDtr| 0x09C | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector X}}
{{OBDtr| 0x09C | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector X (disabled IK stuff) }}
{{OBDtr| 0x0A0 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector Y}}
{{OBDtr| 0x0A0 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector Y}}
{{OBDtr| 0x0A4 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector Z }}
{{OBDtr| 0x0A4 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandVector Z }}
Line 82: Line 79:
{{OBDtr| 0x0B8 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandPosition Y}}
{{OBDtr| 0x0B8 | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandPosition Y}}
{{OBDtr| 0x0BC | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandPosition Z}}
{{OBDtr| 0x0BC | float    |E7CEA5| 00 00 00 00 | 0.000000      | secondHandPosition Z}}
{{OBDtr| 0x0C0 | int16    |FFDDDD| 00 00      | 0              | freeTime ???; always zero }}
{{OBDtr| 0x0C0 | int16    |FFDDDD| 00 00      | 0              | freeTime (unused); always zero }}
{{OBDtr| 0x0C2 | int16    |FFDDDD| 95 00      | 149            | recoil animation type (149 <nowiki>=</nowiki> autopistol_recoil) }}
{{OBDtr| 0x0C2 | int16    |FFDDDD| 95 00      | 149            | recoil animation type (149 {{=}} autopistol_recoil) }}
{{OBDtr| 0x0C4 | int16    |FFDDDD| A4 00      | 164            | reload animation type (164 <nowiki>=</nowiki> reload_pistol) }}
{{OBDtr| 0x0C4 | int16    |FFDDDD| A4 00      | 164            | reload animation type (164 {{=}} reload_pistol) }}
{{OBDtr| 0x0C6 | int16    |FFDDDD| 19 00      | 25            | pause after reload in 1/60 seconds }}
{{OBDtr| 0x0C6 | int16    |FFDDDD| 19 00      | 25            | pause after reload in 1/60 seconds }}
{{OBDtr| 0x0C8 | int16    |FFDDDD| 0A 00      | 10            | amount of shots }}
{{OBDtr| 0x0C8 | int16    |FFDDDD| 0A 00      | 10            | amount of shots }}
Line 103: Line 100:


:0x00 '''01''' 00 00 - knockdown switcher; used for w4_psm, see below
:0x00 '''01''' 00 00 - knockdown switcher; used for w4_psm, see below
:0x00 '''02''' 00 00 - unknown; used for w5_sbg and w11_ba1
:0x00 '''02''' 00 00 - explosive; used for w5_sbg and w11_ba1
:0x00 '''04''' 00 00 - secondary fire enabled
:0x00 '''04''' 00 00 - secondary fire enabled
:0x00 '''08''' 00 00 - barabbas weapon; see below
:0x00 '''08''' 00 00 - barabbas weapon; see below
Line 118: Line 115:




'''stun switcher''' - if enemy is inside shooting distance (between min and max) and is '''knockdown'''ed/'''stun'''ed or '''blownup'''ed, AI with this weapon switches to melee for a time specified in a *fight timer* field
'''stun switcher''' - if enemy is inside shooting distance (between min and max) and is '''knockdown'''ed/'''stun'''ed or '''blownup'''ped, AI with this weapon switches to melee for a time specified in a *fight timer* field


'''knockdown switcher''' -  if enemy is inside shooting distance (between min and max) and is '''knockdown'''ed or '''blownup'''ed, AI with this weapon switches to melee for a time specified in a *fight timer* field
'''knockdown switcher''' -  if enemy is inside shooting distance (between min and max) and is '''knockdown'''ed or '''blownup'''ped, AI with this weapon switches to melee for a time specified in a *fight timer* field


'''barabbas weapon''' - reload disabled; also used for ai2_barabbas_retrievegun (it teleports a weapon to a character); nearest available gun becomes chosen if character had no weapon to beginn, then always this weapon is teleported back to character (when command used again)
'''barabbas weapon''' - reload disabled; also used for ai2_barabbas_retrievegun (it teleports a weapon to a character); nearest available gun becomes chosen if character had no weapon to begin, then always this weapon is teleported back to character (when command used again)


==0x0D8 to 0x1D7 - Firing modes==
==0x0D8 to 0x1D7 - Firing modes==
Every ONWC has 2 firing mode slots (128 = 0x80 bytes each.)
Every ONWC has 2 firing mode slots (128 = 0x80 bytes each.)


The number of slots actually used by the weapon is specified at 0xCA.
The number of slots actually used by the weapon is specified at 0xCA.


===0x0D8 to 0x157 - Primary firing mode===
===0x0D8 to 0x157 - Primary firing mode===
{{Table}}
{{Table}}
{{OBDth}}
{{OBDth}}
{{OBDtr| 0x0D8 | int32    |64AAAA| 00 00 00 00 | 0              | firing mode options; the following bits are possible (values in hex):
{{OBDtr| 0x0D8 | int32    |64AAAA| 00 00 00 00 | 0              | firing mode options; only the following bit is used (value in hex):
:0x'''01''' 00 00 00 - unknown; something to do with keeping/altering "prediction" when the target changes
:0x'''01''' 00 00 00 - No wild shots}}
}}
 
{{OBDtr| 0x0DC | float    |EBEBEB| 23 A6 7F 3F | 0.998629      | transform matrix XX }}
{{OBDtrMatrix4x3|0x0DC|EBEBEB|23 A6 7F 3F|05 6D 56 3D|F4 8D A9 37|05 6D 56 BD|23 A6 7F 3F|D0 1D 0E B5|F4 8D A9 B7|D0 1D 0E B5|00 00 80 3F|00 00 00 00|00 00 00 00|00 00 00 00|0.998629|0.052350|0.000020| -0.052350|0.998629| -0.000001| -0.000020| -0.000001|1.000000|0.000000|0.000000|0.000000| targeting inverse transform matrix - the inverse of the matrix that gives the targeting direction}}
{{OBDtr| 0x0E0 | float    |EBEBEB| 05 6D 56 3D | 0.052350      | transform matrix XY }}
 
{{OBDtr| 0x0E4 | float    |EBEBEB| F4 8D A9 37 | 0.000020      | transform matrix XZ }}
{{OBDtrVector3| 0x10C |EBEBEB| 23 A6 7F 3F | AE 6C 56 BD | AF 8D A9 B7 | 0.998629 | -0.052349 | -0.000020 | targeting direction; sets orientation of firingspread }}
{{OBDtr| 0x0E8 | float    |EBEBEB| 05 6D 56 BD | -0.052350      | transform matrix YX }}
{{OBDtrVector3| 0x118 |EBEBEB| DC FE 08 3C | 5C 11 23 3E | 39 C6 2A 3F | 0.008362 | 0.159246 | 0.667087 | targeting origin; sets deviation of AI's aim from target's origin (target's origin + this vector {{=}} direction where to aim and fire) }}
{{OBDtr| 0x0EC | float    |EBEBEB| 23 A6 7F 3F | 0.998629      | transform matrix YY }}
{{OBDtr| 0x124 | float    |EBEBEB| 00 00 61 44 | 900.000000    | prediction speed; the speed of the projectile that AI prediction should take into account when calculating where to fire in order to hit a moving target }}
{{OBDtr| 0x0F0 | float    |EBEBEB| D0 1D 0E B5 | -0.000001      | transform matrix YZ }}
{{OBDtr| 0x128 | float    |EBEBEB| 00 00 20 41 | 10.000000      | max. inaccuracy angle; sets max angle between weapon's aiming vector and target's position; when AI exceeds this angle (by recoil or target running away), AI stops shooting and aims weapon again straight to the target, then resume shooting }}
{{OBDtr| 0x0F4 | float    |EBEBEB| F4 8D A9 B7 | -0.000020      | transform matrix ZX }}
{{OBDtr| 0x12C | float    |EBEBEB| 00 00 20 40 | 2.500000      | aim_radius; always the same; possibly related to the inaccuracy angle above }}
{{OBDtr| 0x0F8 | float    |EBEBEB| D0 1D 0E B5 | -0.000001      | transform matrix ZY }}
{{OBDtr| 0x130 | float    |EBEBEB| 00 00 96 43 | 300.000000    | weapon sound sphere radius; defines radius of the AI sound sphere (gunfire type, see [[AI#Vision and hearing|HERE]] about AI sound spheres) which is created for a short moment when this weapon is fired }}
{{OBDtr| 0x0FC | float    |EBEBEB| 00 00 80 3F | 1.000000      | transform matrix ZZ  }}
{{OBDtr| 0x134 | float    |EBEBEB| 00 00 40 41 | 12.000000      | minimal shooting distance; if target is closer than this, the AI ceases fire and moves away from the target till at least this distance is achieved; this is a '''diameter, not a radius''', so effective distance from AI to target is half of this value }}
{{OBDtr| 0x100 | float    |EBEBEB| 00 00 00 00 | 0.000000      | translation X; always zero for original weapons }}
{{OBDtr| 0x138 | float    |EBEBEB| 00 00 61 44 | 900.000000    | maximum shooting distance; if target is further than this, the AI ceases fire and moves towards the target until it is below this distance }}
{{OBDtr| 0x104 | float    |EBEBEB| 00 00 00 00 | 0.000000      | translation Y; always zero for original weapons }}
{{OBDtr| 0x13C | int16    |8C8CCC| 05 00      | 5              | UNUSED; maximum startle misses; the maximum number of shots to which extra inaccuracy can be added when an AI begins firing at the player (always 5, but Oni does not use this field) }}
{{OBDtr| 0x108 | float    |EBEBEB| 00 00 00 00 | 0.000000       | translation Z; always zero for original weapons }}
{{OBDtr| 0x13E | int16    |8C8CCC| 01 00      | 1              | skill index (links weapon to the [[ONCC]] shooting skill table); here are the values used by Oni's ONWCs:
{{OBDtr| 0x10C | float    |EBEBEB| 23 A6 7F 3F | 0.998629      | firing spread direction X component }}
:0x'''01''' 00 - w0_sec (not in game)
{{OBDtr| 0x110 | float    |EBEBEB| AE 6C 56 BD | -0.052349     | firing spread direction Y component }}
:0x'''02''' 00 - w1_tap
{{OBDtr| 0x114 | float    |EBEBEB| AF 8D A9 B7 | -0.000020     | firing spread direction Z component }}
:0x'''04''' 00 - w2_sap
{{OBDtr| 0x118 | float    |EBEBEB| DC FE 08 3C | 0.008362      | targeting vector origin X component? }}
:0x'''08''' 00 - w3_phr
{{OBDtr| 0x11C | float    |EBEBEB| 5C 11 23 3E | 0.159246      | targeting vector origin Y component? }}
:0x'''10''' 00 - w4_psm
{{OBDtr| 0x120 | float    |EBEBEB| 39 C6 2A 3F | 0.667087       | targeting vector origin Z component? }}
:0x'''20''' 00 - w5_sbg
{{OBDtr| 0x124 | float    |EBEBEB| 00 00 61 44 | 900.000000    | prediction speed; it is some angle; if this angle is for example 90°, then AI, which is shooting this weapon, will try to copy target's movements eg. when target strafes left, armed AI stops shooting and runs left too; if you set it 270°, armed AI is performing opposite actions eg. when you run left, armed AI runs right; while running, AI stops shooting }}
:0x'''40''' 00 - w6_vdg
{{OBDtr| 0x128 | float    |EBEBEB| 00 00 20 41 | 10.000000      | max. inaccurancy angle; sets max angle between weapon's aiming vector and target's position; when AI exceeds this angle (by recoil or target running away), AI stops shooting and aims weapon again straight to the target, then resume shooting }}
:0x'''80''' 00 - w7_scc
{{OBDtr| 0x12C | float    |EBEBEB| 00 00 20 40 | 2.500000      | aim_radius; always the same; possible related to the inaccuracy angle above }}
:0x00 '''01''' - w8_mbo
{{OBDtr| 0x130 | float    |EBEBEB| 00 00 96 43 | 300.000000    | weapon sound sphere radius; when somebody shoots, weapon creates this range; AIs which are inside this range notice there was a shot + they know WHO is the shooter and WHERE he stands (threat strong), can be seen with *ai2_showsounds<nowiki>=</nowiki>1* (but you have to be in a large open area, since those ranges are quite big) }}
:0x00 '''02''' - w9_scr
{{OBDtr| 0x134 | float    |EBEBEB| 00 00 40 41 | 12.000000      | minimal shooting distance; when AI is closer then min.shot.dist., it will stop shooting and attempt to go away from the target until it again reaches higher distance then min.shot.dist. is; you can see its effect when AI is operating SBG and you get too close }}
:0x00 '''04''' - w10_sni (not in game)
{{OBDtr| 0x138 | float    |EBEBEB| 00 00 61 44 | 900.000000    | maximal shooting distance; when AI is further then max.shot.dist., it isn't shooting but running towards target until it reaches max.shot.dist. limit; then AI opens fire; you can see its effect when AI is far away and has w2_sap }}
:0x00 '''08''' - w11_ba1
{{OBDtr| 0x13C | int16    |8C8CCC| 05 00      | 5              | maximum startle misses; probably the maximum number of shots an ai can miss when suprised before he starts aiming }}
:0x00 '''10''' - w12_ba2}}
{{OBDtr| 0x13E | int16    |8C8CCC| 01 00      | 1              | skill index (in the [[ONCC]] shooting skill table) }}
{{OBDtr| 0x140 | int32    |8C8CCC| 00 00 00 00 | 0              | fight timer, 240 for w4_psm, 200 for v6_vdg }}
{{OBDtr| 0x140 | int32    |8C8CCC| 00 00 00 00 | 0              | fight timer, 240 for w4_psm, 200 for v6_vdg }}
{{OBDtr| 0x144 | float    |FF00C8| 00 00 00 00 | 0.000000      | ballistic projectile speed (150 for SBG, 160 for WMC) }}
{{OBDtr| 0x144 | float    |FF00C8| 00 00 00 00 | 0.000000      | ballistic projectile speed for AI prediction purposes; if this field is unused, the projectile is assumed to be infinite speed; field is always zero except 150 for Superball Gun and 160 for Wave Motion Cannon's secondary trigger }}
{{OBDtr| 0x148 | float    |FF00C8| 00 00 00 00 | 0.000000      | ballistic projectile gravity, can be negative for firing at the enemy's feet (0.5 for SBG, 0.3 for WMC) }}
{{OBDtr| 0x148 | float    |FF00C8| 00 00 00 00 | 0.000000      | ballistic projectile gravity for AI prediction purposes; always zero except 0.5 for SBG and 0.3 for WMC's secondary trigger }}
{{OBDtr| 0x14C | float    |FF00C8| 00 00 34 43 | 180.000000    | length of firingspread which aims from weapon; when AI collides with this firingspread, it tries to dodge/hide of it; can be seen by *ai2_showfiringspreads<nowiki>=</nowiki>1* (180 for w1_tap, 150 for w2_sap, 120 for w4_psm) }}
{{OBDtr| 0x14C | float    |FF00C8| 00 00 34 43 | 180.000000    | length of a firing spread; AI will perform gunfire dodging when it finds itself inside of a firing spread (see {{SectionLink|AI|Basic combat behaviors}}); can be visualized with *ai2_showfiringspreads{{=}}1* (180 for w1_tap, 150 for w2_sap, 120 for w4_psm) }}
{{OBDtr| 0x150 | float    |FF00C8| 00 00 40 40 | 3.000000      | length of the firingspread's base side; can be seen by ai2_showfiringspreads<nowiki>=</nowiki>1 }}
{{OBDtr| 0x150 | float    |FF00C8| 00 00 40 40 | 3.000000      | width of the firing spread's base; can be seen by ai2_showfiringspreads{{=}}1 }}
{{OBDtr| 0x154 | float    |FF00C8| 50 77 D6 3D | 0.104719      | angle between firingspread's base and its altitude(length); can be seen by ai2_showfiringspreads<nowiki>=</nowiki>1 (0.1 for w1_tap, 0.21 for w2_sap) }}
{{OBDtr| 0x154 | float    |FF00C8| 50 77 D6 3D | 0.104719      | firing spread's skew; can be seen by ai2_showfiringspreads{{=}}1 (0.1 for w1_tap, 0.21 for w2_sap) }}
|}
|}


Line 177: Line 170:


===0x158 to 0x1D7 - Secondary firing mode===
===0x158 to 0x1D7 - Secondary firing mode===
 
The only vanilla weapon for which these fields are not all zero is '''w11_ba1'''. They are the exact counterparts of the fields at 0xD8 - 0x157.
 
The only original weapon for which these fields are not all zero is '''w11_ba1'''.
 
They are the exact counterparts of the fields at 0xD8 - 0x157.
 


==0x1D8 to 0x6D7 - Weapon particle array==
==0x1D8 to 0x6D7 - Weapon particle array==
 
Every ONWC has 16 particle slots (80 at 0x50 bytes each). The number of slots actually used by the weapon is specified at 0xCA. Offsets are relative to the beginning of a slot.
 
Every ONWC has 16 particle slots (80 = 0x50 bytes each.)
 
The number of slots actually used by the weapon is specified at 0xCA.
 
Offsets are relative to the beginning of a slot.




Line 212: Line 194:
{{OBDtr| 0x040 | int32    |00C8FF| 00 00 00 00 | 0              | runtime only (pointer to particle class) }}
{{OBDtr| 0x040 | int32    |00C8FF| 00 00 00 00 | 0              | runtime only (pointer to particle class) }}
{{OBDtr| 0x044 | int16    |00C8FF| 01 00      | 1              | ammo decrement (different for the 2 firing modes of w11_ba1) }}
{{OBDtr| 0x044 | int16    |00C8FF| 01 00      | 1              | ammo decrement (different for the 2 firing modes of w11_ba1) }}
{{OBDtr| 0x046 | int16    |00C8FF| 0C 00      | 12            | delay between shots in frames (12 frames <nowiki>=</nowiki> 0.2 seconds) }}
{{OBDtr| 0x046 | int16    |00C8FF| 0C 00      | 12            | delay between shots in frames (12 frames {{=}} 0.2 seconds) }}
{{OBDtr| 0x048 | int16    |00C8FF| 04 00      | 4              | 'roughjustice' delay between shots in frames }}
{{OBDtr| 0x048 | int16    |00C8FF| 04 00      | 4              | 'roughjustice' delay between shots in frames }}
{{OBDtr| 0x04A | int16    |00C8FF| 00 00      | 0              | number in frames for active firing mode (1st frame for activate); Used for w4_psm and w11_ba1 }}
{{OBDtr| 0x04A | int16    |00C8FF| 00 00      | 0              | number in frames for active firing mode (1st frame for activate); Used for w4_psm and w11_ba1 }}
{{OBDtr| 0x04C | int16    |00C8FF| 00 00      | 0              | 0 <nowiki>=</nowiki> particle is triggered by fire1; 1 <nowiki>=</nowiki> particle is triggered by fire2; -1 <nowiki>=</nowiki> particle is triggered by both firing modes }}
{{OBDtr| 0x04C | int16    |00C8FF| 00 00      | 0              | 0 {{=}} particle is triggered by fire1; 1 {{=}} particle is triggered by fire2; -1 {{=}} particle is triggered by both firing modes }}
{{OBDtr| 0x04E | int16    |00C8FF| 00 00      | 0              | delay before firing }}
{{OBDtr| 0x04E | int16    |00C8FF| 00 00      | 0              | delay before firing }}
|}
|}
Line 221: Line 203:


;Transformation matrix
;Transformation matrix
:That's what defines orientation, stretching, etc.
:That's what defines orientation, stretching, etc. See [[OBD:CRSA|CRSA]] for details.
:See [[OBD:CRSA|CRSA]] for details.


==0x6D8 to 0x71F - End of file==
==0x6D8 to 0x71F - End of file==
 
[[Image:onwc_e.gif]]
 
[[image:onwc_e.gif]]




Line 241: Line 220:
{{OBDtr| 0x710 | float    |0096C8| 96 4C A9 3D | 0.082666      | y-offset of pickup handle }}
{{OBDtr| 0x710 | float    |0096C8| 96 4C A9 3D | 0.082666      | y-offset of pickup handle }}
{{OBDtr| 0x714 | float    |0096C8| 06 E2 14 3E | 0.145393      | z-offset of pickup handle }}
{{OBDtr| 0x714 | float    |0096C8| 06 E2 14 3E | 0.145393      | z-offset of pickup handle }}
{{OBDtr| 0x718 | float    |0096C8| 00 00 00 00 | 0.000000      | hovering height of unheld weapon }}
{{OBDtr| 0x718 | float    |0096C8| 00 00 00 00 | 0.000000      | hovering height of dropped weapon }}
{{OBDtr| 0x71C | char[4]  |FF80C0| AD DE      | dead          | unused }}
{{OBDtr| 0x71C | char[4]  |FF80C0| AD DE      | dead          | unused }}
|}
|}
Line 249: Line 228:
:They're applied to the lower face of the M3GM's bounding box. The factors above are the ratio between the x/z extent of that face and the half-length/width of the glow textures. So if both factors are 0.5, the glow textures fit the bounding box exactly.
:They're applied to the lower face of the M3GM's bounding box. The factors above are the ratio between the x/z extent of that face and the half-length/width of the glow textures. So if both factors are 0.5, the glow textures fit the bounding box exactly.
;Pickup handle
;Pickup handle
:The tolerance is hardcoded. The offsets are not relative to the weapon's axes, but to the world axes (!).
:The tolerance is hardcoded. The offsets are not relative to the weapon's axes, but to the world axes (!). This is a rather nasty "feature" because the offsets should be relative to the weapon's orientation. The way it is now, the pickup volume of a weapon is not necessarily next to the handle. That's why the WMC is so hard to pick up that some players conclude it's not possible; being the largest weapon, it has the largest potential discrepancy between its visual handle location and its pickup volume.
:This is a rather nasty "feature" (actually, the offsets ''should'' be relative to the weapon's orientation)
:The way it's now, the pickup volume of a WMC is not necessarily next to the handle. That's why it's hard to pick up.




{{OBD_File_Footer | type=ONWC | prev=ONVL | next=OPge | name=Oni Weapon Class | family=Level}}
{{OBD_File_Footer | type=ONWC | prev=ONVL | next=OPge | name=Oni Weapon Class | family=Character}}


{{OBD}}
{{OBD}}

Latest revision as of 17:58, 19 May 2024

ONI BINARY DATA
ONVL << Other file types >> OPge
ONWC : Oni Weapon Class
switch to XML:ONWC page
Overview @ Oni Stuff
OBD.png


ONWC files in level[1-19]_Final are 0-byte files. The actual data is in the ONWC files of level 0; below is an example.

Unless specified otherwise, the coordinates are relative to the weapon's mesh (x = forwards, y = left, z = up).


0x000 to 0x0D7 - Weapon main part

Onwc a.gif


Offset Type Raw Hex Value Description
0x000 res_id 01 75 0E 00 3701 03701-w1_tap.ONWC
0x004 lev_id 01 00 00 00 0 level 0


0x008 to 0x053 - Laser sight parameters

Offset Type Raw Hex Value Description
0x008 float F5 A4 49 40 3.150693 x-offset of laser sight origin
0x00C float F4 2C A5 3B 0.005041 y-offset of laser sight origin
0x010 float 21 4E D2 3E 0.410752 z-offset of laser sight origin
0x014 float 23 A6 7F 3F 0.998629 x-component of laser sight direction
0x018 float AA 6C 56 BD -0.052349 y-component of laser sight direction
0x01C float 69 66 AA B7 -0.000020 z-component of laser sight direction
0x020 float 00 40 9C 45 5000.000000 maximal length of laser sight vector
0x024 color 00 00 FF FF 0, 0, 255; 255 laser sight color (blue, green, red); laser sight transparency
0x028 link 01 94 05 00 1428 crosshair texture (link to 01428-target_1A.TXMP)
0x02C color FF FF FF 00 255, 255, 255; 0 crosshair background color (blue, green, red); crosshair background transparency
0x030 float CD CC 4C 3F 0.800000 crosshair scale factor
0x034 link 01 95 05 00 1428 locked crosshair texture (link to 01429-target_1B.TXMP)
0x038 color FF FF FF 00 255, 255, 255; 0 locked crosshair background color (blue, green, red); locked crosshair background transparency
0x03C float CD CC 4C 3F 0.800000 locked crosshair scale factor
0x040 link 00 00 00 00 unused tunnel texture (link to a TXMP) file
0x044 color FF FF FF 00 255, 255, 255; 0 tunnel background color (blue, green, red); tunnel background transparency
0x048 float 00 00 80 3F 1.000000 tunnel scale factor
0x04C int32 0F 00 00 00 15 number of tunnel textures
0x050 float 00 00 20 41 10.000000 spacing of tunnel textures


Crosshair
Default crosshair appears where the laser sight hits environment, corpses, etc.
Locked crosshair appears when the laser sight hits characters (including the shooter)
"Tunnel" is used by w8_mbo as a complement to the crosshair
w2_sap, w5_sbg, w7_scc and w9_scr use it with no crosshair


0x054 to 0x05F - Ammo meter

Offset Type Raw Hex Value Description
0x054 link 01 7E 0E 00 3710 link to 03710-tap_icon.TXMP
0x058 link 01 7F 0E 00 3711 link to 03711-tap_empty.TXMP
0x05C link 01 80 0E 00 3712 link to 03712-tap_fill.TXMP


0x060 to 0x0D7 - Weapon parameters

Offset Type Raw Hex Value Description
0x060 link 01 76 0E 00 3702 link to 03702-.M3GM
0x064 char[32] w1_tap weapon name
0x084 float 00 00 80 3F 1.000000 weapon mouse sensitivity (applies to AI, too)
0x088 float A6 92 2B 3D 0.041888 recoil base (e.g. for w1_tap and w2_sap)
0x08C float 92 0A 86 3E 0.261799 recoil max
0x090 float 00 00 A0 40 5.000000 recoil factor
0x094 float E2 A3 7B 3B 0.003839 recoil return speed
0x098 float 88 C3 E4 3A 0.001745 recoil firing return speed
0x09C float 00 00 00 00 0.000000 secondHandVector X (disabled IK stuff)
0x0A0 float 00 00 00 00 0.000000 secondHandVector Y
0x0A4 float 00 00 00 00 0.000000 secondHandVector Z
0x0A8 float 00 00 00 00 0.000000 secondHandUpVector X
0x0AC float 00 00 00 00 0.000000 secondHandUpVector Y
0x0B0 float 00 00 00 00 0.000000 secondHandUpVector Z
0x0B4 float 00 00 00 00 0.000000 secondHandPosition X
0x0B8 float 00 00 00 00 0.000000 secondHandPosition Y
0x0BC float 00 00 00 00 0.000000 secondHandPosition Z
0x0C0 int16 00 00 0 freeTime (unused); always zero
0x0C2 int16 95 00 149 recoil animation type (149 = autopistol_recoil)
0x0C4 int16 A4 00 164 reload animation type (164 = reload_pistol)
0x0C6 int16 19 00 25 pause after reload in 1/60 seconds
0x0C8 int16 0A 00 10 amount of shots
0x0CA int16 06 00 6 amount of particles
0x0CC int16 01 00 1 amount of firing modes
0x0CE int16 0A 00 10 pause before reload in 1/60 seconds
0x0D0 int16 04 00 4 release delay; delay between the moment the trigger is released and the moment the weapon stops firing
0x0D2 int16 00 00 0 padding; always zero
0x0D4 int32 30 0x30 C0 02 00 weapon options; the following bits are possible (values in hex):
0x02 00 00 00 - weapon can't be holstered
0x04 00 00 00 - weapon reloads with energy cells
0x08 00 00 00 - weapon is a rifle (two-handed)
0x10 00 00 00 - recoil affects aiming
0x20 00 00 00 - sustained fire (applies only to primary fire)
0x40 00 00 00 - runtime only; do not use
0x80 00 00 00 - stun switcher; used for w6_vdg, see below
0x00 01 00 00 - knockdown switcher; used for w4_psm, see below
0x00 02 00 00 - explosive; used for w5_sbg and w11_ba1
0x00 04 00 00 - secondary fire enabled
0x00 08 00 00 - barabbas weapon; see below
0x00 10 00 00 - heavy weapon; run, jump and creep disabled
0x00 20 00 00 - auto release trigger; used for w11_ba1
0x00 40 00 00 - has release delay; see the release delay field above
0x00 80 00 00 - laser sight visible
0x00 00 02 00 - crosshair scaling, used for w1_tap, w2_sap, w3_phr and w8_mbo
0x00 00 08 00 - weapon doesn't fade
0x00 00 10 00 - drain ammo; used by w4_psm to decrement ammo while firing because its firing mode is continuous rather than repetitive


stun switcher - if enemy is inside shooting distance (between min and max) and is knockdowned/stuned or blownupped, AI with this weapon switches to melee for a time specified in a *fight timer* field

knockdown switcher - if enemy is inside shooting distance (between min and max) and is knockdowned or blownupped, AI with this weapon switches to melee for a time specified in a *fight timer* field

barabbas weapon - reload disabled; also used for ai2_barabbas_retrievegun (it teleports a weapon to a character); nearest available gun becomes chosen if character had no weapon to begin, then always this weapon is teleported back to character (when command used again)

0x0D8 to 0x1D7 - Firing modes

Every ONWC has 2 firing mode slots (128 = 0x80 bytes each.)

The number of slots actually used by the weapon is specified at 0xCA.

0x0D8 to 0x157 - Primary firing mode

Offset Type Raw Hex Value Description
0x0D8 int32 00 00 00 00 0 firing mode options; only the following bit is used (value in hex):
0x01 00 00 00 - No wild shots
0x0DC matrix4x3
23 A6 7F 3F 05 6D 56 3D F4 8D A9 37
05 6D 56 BD 23 A6 7F 3F D0 1D 0E B5
F4 8D A9 B7 D0 1D 0E B5 00 00 80 3F
00 00 00 00 00 00 00 00 00 00 00 00
0.998629 0.052350 0.000020
-0.052350 0.998629 -0.000001
-0.000020 -0.000001 1.000000
0.000000 0.000000 0.000000
targeting inverse transform matrix - the inverse of the matrix that gives the targeting direction


0x10C vector3
23 A6 7F 3F AE 6C 56 BD AF 8D A9 B7
0.998629 -0.052349 -0.000020
targeting direction; sets orientation of firingspread
0x118 vector3
DC FE 08 3C 5C 11 23 3E 39 C6 2A 3F
0.008362 0.159246 0.667087
targeting origin; sets deviation of AI's aim from target's origin (target's origin + this vector = direction where to aim and fire)
0x124 float 00 00 61 44 900.000000 prediction speed; the speed of the projectile that AI prediction should take into account when calculating where to fire in order to hit a moving target
0x128 float 00 00 20 41 10.000000 max. inaccuracy angle; sets max angle between weapon's aiming vector and target's position; when AI exceeds this angle (by recoil or target running away), AI stops shooting and aims weapon again straight to the target, then resume shooting
0x12C float 00 00 20 40 2.500000 aim_radius; always the same; possibly related to the inaccuracy angle above
0x130 float 00 00 96 43 300.000000 weapon sound sphere radius; defines radius of the AI sound sphere (gunfire type, see HERE about AI sound spheres) which is created for a short moment when this weapon is fired
0x134 float 00 00 40 41 12.000000 minimal shooting distance; if target is closer than this, the AI ceases fire and moves away from the target till at least this distance is achieved; this is a diameter, not a radius, so effective distance from AI to target is half of this value
0x138 float 00 00 61 44 900.000000 maximum shooting distance; if target is further than this, the AI ceases fire and moves towards the target until it is below this distance
0x13C int16 05 00 5 UNUSED; maximum startle misses; the maximum number of shots to which extra inaccuracy can be added when an AI begins firing at the player (always 5, but Oni does not use this field)
0x13E int16 01 00 1 skill index (links weapon to the ONCC shooting skill table); here are the values used by Oni's ONWCs:
0x01 00 - w0_sec (not in game)
0x02 00 - w1_tap
0x04 00 - w2_sap
0x08 00 - w3_phr
0x10 00 - w4_psm
0x20 00 - w5_sbg
0x40 00 - w6_vdg
0x80 00 - w7_scc
0x00 01 - w8_mbo
0x00 02 - w9_scr
0x00 04 - w10_sni (not in game)
0x00 08 - w11_ba1
0x00 10 - w12_ba2
0x140 int32 00 00 00 00 0 fight timer, 240 for w4_psm, 200 for v6_vdg
0x144 float 00 00 00 00 0.000000 ballistic projectile speed for AI prediction purposes; if this field is unused, the projectile is assumed to be infinite speed; field is always zero except 150 for Superball Gun and 160 for Wave Motion Cannon's secondary trigger
0x148 float 00 00 00 00 0.000000 ballistic projectile gravity for AI prediction purposes; always zero except 0.5 for SBG and 0.3 for WMC's secondary trigger
0x14C float 00 00 34 43 180.000000 length of a firing spread; AI will perform gunfire dodging when it finds itself inside of a firing spread (see AI § Basic combat behaviors); can be visualized with *ai2_showfiringspreads=1* (180 for w1_tap, 150 for w2_sap, 120 for w4_psm)
0x150 float 00 00 40 40 3.000000 width of the firing spread's base; can be seen by ai2_showfiringspreads=1
0x154 float 50 77 D6 3D 0.104719 firing spread's skew; can be seen by ai2_showfiringspreads=1 (0.1 for w1_tap, 0.21 for w2_sap)


Transform matrix
Probably defines the orientation, scaling and position of the firing spread. It doesn't appear to be used.

0x158 to 0x1D7 - Secondary firing mode

The only vanilla weapon for which these fields are not all zero is w11_ba1. They are the exact counterparts of the fields at 0xD8 - 0x157.

0x1D8 to 0x6D7 - Weapon particle array

Every ONWC has 16 particle slots (80 at 0x50 bytes each). The number of slots actually used by the weapon is specified at 0xCA. Offsets are relative to the beginning of a slot.


Offset Type Raw Hex Value Description
First of 16 elements (black outline).
0x000 float AE 6C 56 3D 0.052349 transformation matrix, xx term
0x004 float 23 A6 7F 3F 0.998629 transformation matrix, xy term
0x008 float C2 53 90 B3 -0.000000... transformation matrix, xz term
0x00C float 23 A6 7F 3F 0.998629 transformation matrix, yx term
0x010 float AE 6C 56 BD -0.052349 transformation matrix, yy term
0x014 float AF 8D A9 B7 -0.000020 transformation matrix, yz term
0x018 float BA 59 A9 B7 -0.000020 transformation matrix, zx term
0x01C float 5B 02 85 35 0.000001 transformation matrix, zy term
0x020 float 00 00 80 BF -1.000000 transformation matrix, zz term
0x024 float 6F 63 57 40 3.365444 x-offset of particle to weapon
0x028 float B3 1D 89 BC -0.016738 y-offset of particle to weapon
0x02C float C5 C1 2A 3F 0.667019 z-offset of particle to weapon
0x030 char[16] w1_tap_e01 particle name (reference to 06226-3RAPw1_tap_e01.BINA)
0x040 int32 00 00 00 00 0 runtime only (pointer to particle class)
0x044 int16 01 00 1 ammo decrement (different for the 2 firing modes of w11_ba1)
0x046 int16 0C 00 12 delay between shots in frames (12 frames = 0.2 seconds)
0x048 int16 04 00 4 'roughjustice' delay between shots in frames
0x04A int16 00 00 0 number in frames for active firing mode (1st frame for activate); Used for w4_psm and w11_ba1
0x04C int16 00 00 0 0 = particle is triggered by fire1; 1 = particle is triggered by fire2; -1 = particle is triggered by both firing modes
0x04E int16 00 00 0 delay before firing


Transformation matrix
That's what defines orientation, stretching, etc. See CRSA for details.

0x6D8 to 0x71F - End of file

Onwc e.gif


Offset Type Raw Hex Value Description
0x6D8 char[32] weapon _empty empty weapon sound (reference to 08993-weapon_empty.imp.OSBD)
0x6F8 int32 00 00 00 00 0 runtime only (pointer to empty weapon sound)
0x6FC link 01 81 0E 00 3713 link to 03713-w1_glow.TXMP
0x700 link 01 82 0E 00 3714 link to 03714-w1_glow_ammo.TXMP
0x704 float 00 00 80 3F 1.000000 x-scale factor of glow textures
0x708 float 00 00 80 3F 1.000000 z-scale factor of glow textures
0x70C float 76 65 EB 3F 1.839034 x-offset of pickup handle
0x710 float 96 4C A9 3D 0.082666 y-offset of pickup handle
0x714 float 06 E2 14 3E 0.145393 z-offset of pickup handle
0x718 float 00 00 00 00 0.000000 hovering height of dropped weapon
0x71C char[4] AD DE dead unused


Glow textures
They're applied to the lower face of the M3GM's bounding box. The factors above are the ratio between the x/z extent of that face and the half-length/width of the glow textures. So if both factors are 0.5, the glow textures fit the bounding box exactly.
Pickup handle
The tolerance is hardcoded. The offsets are not relative to the weapon's axes, but to the world axes (!). This is a rather nasty "feature" because the offsets should be relative to the weapon's orientation. The way it is now, the pickup volume of a weapon is not necessarily next to the handle. That's why the WMC is so hard to pick up that some players conclude it's not possible; being the largest weapon, it has the largest potential discrepancy between its visual handle location and its pickup volume.


ONI BINARY DATA
ONVL << Other file types >> OPge
ONWC : Oni Weapon Class
Character file