With the development of
fastman92 Limit Adjuster, it eventually became possible to add new weapons.
Old mods did (and some new ones still do) use the hard-coded weapon IDs for their functionality.
For example: If the mod wants to identify the weapon M4, it will use the constant weapon ID 31.
Ok, but what if the user adds a new weapon? The ID of the new weapon will not be 31; it will be 70 or above!
And if this weapon behaves exactly the same as the M4, then how to identify it?
Well, the creator of the mod could read the weapon info, using command
GET_WEAPONINFO: The weapon's animation group ID, fire type etc.
But it's still not enough.
That's where weapon highest parent types come in: See
this comment for more info.
Here are the contents of gtasa_weapon_config.dat for fastman92 Limit Adjuster from the Added Weapons Pack:
Código: Selecionar tudo
# Author: fastman92
# fastman92 limit adjuster required to apply new weapon types
#
# ALL WEAPONS
#-----------------------------------------------
# A: int weaponTypeID, can be -1 to find first free ID
# B: string weaponTypeName
# C: int statIndex
# D: bool bCanBeUsedForSecondPlayer
# E: bool bHasWeaponAmmoToBeUsed
# F: int AmmoForWeapon_OnStreet
# G: int PickupMsgColor.red
# H: int PickupMsgColor.green
# I: int PickupMsgColor.blue
# J: float PickupMsgUnk4
# K: string parentWeaponType - optional parameter
#
# Weapons with statIndex specified will require poor, standard and professional line in weapon.dat.
# Additionally the weapons with statIndex specified and which derive from PISTOL will also require special line.
#
# weaponType statIndex bCanBeUsedForSecondPlayer bHasWeaponAmmoToBeUsed AmmoForWeapon_OnStreet PickupMsgColor PickupMsgUnk4 parentWeaponType
# A B C D E F G H I J K
0 UNARMED -1 1 1 0 128 128 128 1.0
1 BRASSKNUCKLE -1 1 1 1 128 128 128 1.0
2 GOLFCLUB -1 1 1 1 97 194 247 1.0
3 NIGHTSTICK -1 1 1 1 97 194 247 1.0
4 KNIFE -1 1 1 1 97 194 247 1.0
5 BASEBALLBAT -1 1 1 1 97 194 247 1.0
6 SHOVEL -1 1 0 1 97 194 247 1.0
7 POOLCUE -1 1 0 1 97 194 247 1.0
8 KATANA -1 1 1 1 97 194 247 1.0
9 CHAINSAW -1 0 1 1 97 194 247 1.0
10 DILDO1 -1 1 1 1 97 97 97 1.0
11 DILDO2 -1 1 1 1 97 97 97 1.0
12 VIBE1 -1 1 1 1 97 97 97 1.0
13 VIBE2 -1 1 1 1 97 97 97 1.0
14 FLOWERS -1 1 1 1 97 97 97 1.0
15 CANE -1 1 0 1 97 97 97 1.0
16 GRENADE -1 1 0 8 27 89 130 1.0
17 TEARGAS -1 1 0 8 27 89 130 1.0
18 MOLOTOV -1 1 0 8 27 89 130 1.0
19 ROCKET -1 1 0 8 27 89 130 1.0
20 ROCKET_HS -1 1 0 4 27 89 130 1.0
21 FREEFALL_BOMB -1 1 0 4 27 89 130 1.0
22 PISTOL 69 1 0 30 149 194 24 1.0
23 PISTOL_SILENCED 70 1 0 10 149 194 24 1.0
24 DESERT_EAGLE 71 1 0 10 149 194 24 1.0
25 SHOTGUN 72 1 0 15 45 155 90 1.0
26 SAWNOFF 73 1 0 10 45 155 90 1.0
27 SPAS12 74 1 0 10 45 155 90 1.0
28 MICRO_UZI 75 1 0 60 255 227 79 1.0
29 MP5 76 1 0 60 255 227 79 1.0
30 AK47 77 1 0 80 254 137 0 1.0
31 M4 78 1 0 80 254 137 0 1.0
32 TEC9 79 1 0 60 255 227 79 1.0
33 COUNTRYRIFLE -1 1 0 20 249 131 215 1.0
34 SNIPERRIFLE -1 0 0 10 249 131 215 1.0
35 RLAUNCHER -1 0 0 4 164 40 178 1.0
36 RLAUNCHER_HS -1 1 0 3 164 40 178 1.0
37 FTHROWER -1 1 0 100 164 40 178 1.0
38 MINIGUN -1 1 0 500 164 40 178 1.0
39 SATCHEL_CHARGE -1 1 0 5 164 40 178 1.0
40 DETONATOR -1 1 0 1 164 40 178 1.0
41 SPRAYCAN -1 1 0 500 97 194 247 1.0
42 EXTINGUISHER -1 1 0 500 69 69 69 1.0
43 CAMERA -1 1 0 36 69 69 69 1.0
44 NIGHTVISION -1 1 0 0 69 69 69 1.0
45 INFRARED -1 1 0 0 69 69 69 1.0
46 PARACHUTE -1 0 1 1 69 69 69 1.0
# additional settings for some weapons
! SET_ASSOCIATED_WEAPON RLAUNCHER ROCKET
! SET_ASSOCIATED_WEAPON RLAUNCHER_HS ROCKET_HS
! SET_ASSOCIATED_WEAPON SATCHEL_CHARGE DETONATOR
# IDs 47 to 59 are reserved for internal game usage
# 47 LAST_WEAPONTYPE
# 48 ARMOUR
# 49 RAMMEDBYCAR
# 50 RUNOVERBYCAR
# 51 EXPLOSION
# 52 UZI_DRIVEBY
# 53 DROWNING
# 54 FALL
# 55 UNIDENTIFIED
# 56 ANYMELEE
# 57 ANYWEAPON
# 58 FLARE
# 59 TANK_GRENADE
# IDs 60 to 69 are reserved for limit adjuster future use
# 60 JETPACK_TYPE
# 61 BINOCULARS_TYPE, derived from NIGHTVISION
# ----------------------------------- added weapons -----------------------------------
# you will add entries of new weapons probably here
# weaponType statIndex bCanBeUsedForSecondPlayer bHasWeaponAmmoToBeUsed AmmoForWeapon_OnStreet PickupMsgColor PickupMsgUnk4 parentWeaponType
# A B C D E F G H I J K
#70 JETPACK -1 1 0 0 69 69 69 1.0 JETPACK_TYPE
#71 SKATEBOARD -1 1 1 1 97 194 247 1.0 BASEBALLBAT
#72 BINOCULARS -1 1 0 0 69 69 69 1.0 BINOCULARS_TYPE
73 SW38 69 1 0 30 149 194 24 1.0 PISTOL
74 GREENGLOCK 69 1 0 30 149 194 24 1.0 PISTOL
75 GLOCKSILENT 70 1 0 10 149 194 24 1.0 PISTOL_SILENCED
76 COLTSAA 71 1 0 10 149 194 24 1.0 DESERT_EAGLE
77 COLTPYTHON 71 1 0 10 149 194 24 1.0 DESERT_EAGLE
78 EQUALIZER 71 1 0 10 149 194 24 1.0 DESERT_EAGLE
79 WHITEM9 69 1 0 30 149 194 24 1.0 PISTOL
80 USPTACTICAL 69 1 0 30 149 194 24 1.0 PISTOL
81 SILENTMK23 70 1 0 10 149 194 24 1.0 PISTOL_SILENCED
82 BERETTAM9 69 1 0 30 149 194 24 1.0 PISTOL
83 DOUBLEBARREL 74 1 0 10 45 155 90 1.0 SPAS12
84 ITHACA 72 1 0 15 45 155 90 1.0 SHOTGUN
85 MARINE 72 1 0 15 45 155 90 1.0 SHOTGUN
86 MOSSBERG 72 1 0 15 45 155 90 1.0 SHOTGUN
87 PIGEON 72 1 0 15 45 155 90 1.0 SHOTGUN
88 REMINGTONS 72 1 0 15 45 155 90 1.0 SHOTGUN
89 SHORTY 72 1 0 15 45 155 90 1.0 SHOTGUN
90 SKORPION 79 1 0 60 255 227 79 1.0 TEC9
91 TEC9V2 79 1 0 60 255 227 79 1.0 TEC9
92 GOLDMAC10 75 1 0 60 255 227 79 1.0 MICRO_UZI
93 GOLDUZIV1 75 1 0 60 255 227 79 1.0 MICRO_UZI
94 GOLDUZIV2 75 1 0 60 255 227 79 1.0 MICRO_UZI
95 MAC10 75 1 0 60 255 227 79 1.0 MICRO_UZI
96 TMP 75 1 0 60 255 227 79 1.0 MICRO_UZI
97 UZI 75 1 0 60 255 227 79 1.0 MICRO_UZI
98 GOLDUZIC 76 1 0 60 255 227 79 1.0 MP5
99 MP5K 76 1 0 60 255 227 79 1.0 MP5
100 MP5KV2 76 1 0 60 255 227 79 1.0 MP5
101 P90 76 1 0 60 255 227 79 1.0 MP5
102 UZICARBINE 76 1 0 60 255 227 79 1.0 MP5
103 AK74 77 1 0 80 254 137 0 1.0 AK47
104 AUG 78 1 0 80 254 137 0 1.0 M4
105 FAMAS 77 1 0 80 254 137 0 1.0 AK47
106 M4A1 78 1 0 80 254 137 0 1.0 M4
107 M16A1 77 1 0 80 254 137 0 1.0 AK47
108 RUGER14 78 1 0 80 254 137 0 1.0 M4
109 RUGER14V2 77 1 0 80 254 137 0 1.0 AK47
110 SIG552 78 1 0 80 254 137 0 1.0 M4
111 XM8 77 1 0 80 254 137 0 1.0 AK47
112 USAS12 74 1 0 10 45 155 90 1.0 SPAS12
113 GLOCK18C 69 1 0 30 149 194 24 1.0 PISTOL
114 M60 77 1 0 80 254 137 0 1.0 AK47
115 M249 77 1 0 80 254 137 0 1.0 AK47
116 MAC10SILENT 75 1 0 60 255 227 79 1.0 PISTOL_SILENCED
117 BAT1 -1 1 1 1 97 194 247 1.0 BASEBALLBAT
118 BAT2 -1 1 1 1 97 194 247 1.0 BASEBALLBAT
119 BATBETA -1 1 1 1 97 194 247 1.0 BASEBALLBAT
120 BATGTA3 -1 1 1 1 97 194 247 1.0 BASEBALLBAT
121 BATLCS -1 1 1 1 97 194 247 1.0 BASEBALLBAT
122 BATNAIL -1 1 1 1 97 194 247 1.0 BASEBALLBAT
123 KNIFEBUTTERFLY -1 1 1 1 97 194 247 1.0 KNIFE
124 KNIFECOMBAT -1 1 1 1 97 194 247 1.0 KNIFE
125 KNIFESCISSORS -1 1 1 1 97 194 247 1.0 KNIFE
126 KNIFETRENCH -1 1 1 1 97 194 247 1.0 KNIFE
127 HOCKEYSTICK -1 1 1 1 97 194 247 1.0 GOLFCLUB
128 AXE -1 1 0 1 97 97 97 1.0 CANE
129 GAFFHOOK -1 1 0 1 97 97 97 1.0 CANE
130 SLEDGEHAMMER -1 1 0 1 97 97 97 1.0 BASEBALLBAT
131 FOAMFINGER -1 1 1 1 128 128 128 1.0 BRASSKNUCKLE
132 SHOCKPADDLE -1 1 1 1 128 128 128 1.0 BRASSKNUCKLE
133 CLEAVER -1 1 1 1 97 97 97 1.0 KNIFE
134 HAMMER -1 1 1 1 97 97 97 1.0 VIBE1
135 WRENCH -1 1 1 1 97 97 97 1.0 VIBE1
136 MACHETE -1 1 1 1 97 97 97 1.0 KNIFE
137 SCREWDRIVER -1 1 1 1 97 97 97 1.0 DILDO2
138 TASER -1 1 1 1 97 97 97 1.0 DILDO2
139 TRANQUILIZER -1 0 0 10 249 131 215 1.0 PISTOL_SILENCED
140 M82 -1 0 0 10 249 131 215 1.0 SNIPERRIFLE
141 DRAGUNOV -1 0 0 10 249 131 215 1.0 SNIPERRIFLE
142 M21 -1 0 0 10 249 131 215 1.0 SNIPERRIFLE
143 PSG1 -1 0 0 10 249 131 215 1.0 SNIPERRIFLE
144 SCOUT -1 0 0 10 249 131 215 1.0 SNIPERRIFLE
See:
# K: string parentWeaponType - optional parameter.
In GTA SA, the behavior of vanilla weapons is hard-coded. So, to add a new weapon with vanilla behavior, it is required to set a vanilla weapon as its parent weapon type, e.g., adding a new weapon
M4_SILENCED must have parent weapon type
PISTOL_SILENCED for it to behave as a silenced weapon.
Well, what if a mod wants to work on all silenced weapons? This isn't possible through WeaponInfo.
But you can do this through an exported function of the fastman92 Limit Adjuster:
GetWeaponHighestParentType.
Here is a CLEO script that checks for the player's current weapon, and if it is silenced, and displays "SILENCED" as subtitles:
Código: Selecionar tudo
{$CLEO .cs}
01F5: 0@ = get_player_actor 0
0AB1: cleo_call @GetWeaponHighestParentType 0 _Ret- _GetWeaponHighestParentType 1@
while true
0470: 2@ = actor 0@ current_weapon
0AB1: cleo_call @getWeaponType 2 _GetWeaponHighestParentType 1@ _iWeaponID 2@ _Ret- _iWeaponID 2@
if 2@ == 23
then
0AD1: show_formatted_text_highpriority "SILENCED" time 0
end
wait 0
end
:GetWeaponHighestParentType
10@ = 0
if 0AA2: 11@ = load_dynamic_library "$fastman92limitAdjuster.asi"
then
if 0AA4: 12@ = get_dynamic_library_procedure "GetWeaponHighestParentType" library 11@
then
0085: 10@ = 12@
end
0AA3: free_dynamic_library 11@
end
0AB2: cleo_return 1 10@
:getWeaponType
if 0@ > 0
then
0AA7: call_function_return 0@ num_params 1 pop 1 1@ 10@
if 10@ <> -1
then
0085: 1@ = 10@
end
end
0AB2: cleo_return 1 1@
Parent weapon types are, for the most part, not that important. But in some mods, it can give a significant improvement- like
playing weapon sounds.
