Armas

Estas funções trabalham com a definição das armas em si — nome, ID, slot e propriedades como dano e alcance. Para dar ou tirar armas de alguém, veja as funções de ped.

Dois jeitos de nomear uma arma

getWeaponNameFromID e getWeaponIDFromName usam os nomes de exibição, que são os nomes que aparecem para o jogador ("Colt 45", "Sawed-off").

Já as funções que recebem uma arma como argumento aceitam o ID numérico ou um nome de argumento, que é uma lista diferente e com apelidos ("pistol", "deagle", "ak-47"). As duas listas estão lado a lado em Lista de armas.

Estas 5 funções existem no servidor e no cliente. Você pode usá-las em scripts declarados em server_files, client_files ou shared_files.

Veja também as funções de Armas exclusivas do servidor.

getWeaponNameFromID Devolve o nome de exibição de uma arma.

getWeaponIDFromName Devolve o ID a partir do nome de exibição.

Lista de armas

ID	Nome de exibição	Nomes aceitos como argumento
0	Fist	fist
1	Brassknuckle	brass_knuckle, brassknuckle
2	Golfclub	golfclub
3	Nightstick	nightstick
4	Knife	knife
5	Bat	baseball_bat, bat
6	Shovel	shovel
7	Poolstick	pool_cue, poolstick
8	Katana	katana
9	Chainsaw	chainsaw
10	Purple Dildo	dildo1
11	Dildo	dildo2, dildo
12	Vibrator	vibe1
13	Silver Vibrator	vibe2, vibrator
14	Flower	flowers, flower
15	Cane	cane
16	Grenade	grenade
17	Teargas	teargas
18	Molotov	molotov
19	Rocket	—
20	Rocket	—
21	Freefall Bomb	—
22	Colt 45	pistol, colt 45
23	Silenced	silenced_pistol, silenced
24	Deagle	desert_eagle, deagle
25	Shotgun	shotgun
26	Sawed-off	sawnoff_shotgun, sawed-off
27	Combat Shotgun	spas12_shotgun, combat shotgun
28	Uzi	uzi
29	MP5	mp5
30	AK-47	ak47, ak-47
31	M4	m4
32	Tec-9	tec9, tec-9
33	Rifle	rifle
34	Sniper	sniper_rifle, sniper
35	Rocket Launcher	rocket_launcher, rocket launcher
36	Rocket Launcher HS	rocket_launcher_hs, rocket launcher hs
37	Flamethrower	flamethrower
38	Minigun	minigun
39	Satchel	satchel
40	Bomb	detonator, bomb
41	Spraycan	spraycan
42	Fire Extinguisher	extinguisher, fire extinguisher
43	Camera	camera
44	Nightvision	nightvision
45	Infrared	infrared
46	Parachute	parachute

Os IDs 19, 20 e 21 existem para efeitos de dano e não podem ser passados por nome. Como 19 e 20 compartilham o nome Rocket, getWeaponIDFromName("Rocket") sempre devolve 19.

getSlotFromWeapon Devolve o slot de inventário a que uma arma pertence.

Propriedades de arma

Cada arma tem um conjunto de valores que definem como ela se comporta: alcance, dano, velocidade de tiro, tamanho do pente e assim por diante. As três funções abaixo leem e escrevem esses valores.

Nem toda arma tem propriedades

Só as armas de fogo — IDs 22 a 42 — têm um conjunto de propriedades. Armas brancas, granadas e paraquedas devolvem false em qualquer consulta — exceto que, no cliente, getOriginalWeaponProperty responde zeros para os IDs de 43 a 58.

Níveis de perícia

Uma arma pode ter valores diferentes conforme a perícia do personagem com ela.

Valor	Nome	Descrição
0	"poor"	Iniciante.
1	"std"	Nível padrão.
2	"pro"	Especialista.
3	—	Não tem nome e não tem conjunto de valores próprio.

Só as armas de 22 a 32 têm variações por perícia. Da 33 em diante todas as perícias compartilham o mesmo conjunto de valores, então o argumento é ignorado.

Propriedades de leitura

Propriedade	Devolve
weapon_range	number
target_range	number
accuracy	number
firing_speed	number
life_span	number
spread	number
move_speed	number
required_skill_level	number
anim_loop_start	number
anim_loop_stop	number
anim_loop_bullet_fire	number
anim2_loop_start	number
anim2_loop_stop	number
anim2_loop_bullet_fire	number
anim_breakout_time	number
radius	number
damage	number
maximum_clip_ammo	number
flags	number
anim_group	number
fire_type	number
model	number
model2	number
weapon_slot	number
aim_offset	number
skill_level	number
default_combo	number
combos_available	number
fire_offset	três numbers — x, y, z

Além dessas, existem as flags, que sempre devolvem true ou false:

flag_aim_no_auto, flag_aim_arm, flag_aim_1st_person, flag_aim_free, flag_move_and_aim, flag_move_and_shoot, flag_type_throw, flag_type_heavy, flag_type_constant, flag_type_dual, flag_anim_reload, flag_anim_crouch, flag_anim_reload_loop, flag_anim_reload_long, flag_shot_slows, flag_shot_rand_speed, flag_shot_anim_abrupt, flag_shot_expands

Propriedades que podem ser alteradas

O conjunto que setWeaponProperty aceita é menor: as demais são só de leitura.

Propriedade	Tipo do valor	Intervalo aceito
weapon_range	number	0 a 350
target_range	number	0 a 300
accuracy	number	0 a 10000
move_speed	number	-1 a 100
anim_loop_start	number	0 a 5
anim_loop_stop	number	0 a 5
anim_loop_bullet_fire	number	0 a 2
anim2_loop_start	number	0 a 5
anim2_loop_stop	number	0 a 5
anim2_loop_bullet_fire	number	0 a 2
anim_breakout_time	number	0 a 5
damage	number	-10000 a 10000
maximum_clip_ammo	number	0 a 1000
flags	number	Alterna bits — veja setWeaponProperty
Qualquer flag_*	bool	true ou false

getWeaponProperty Lê uma propriedade da arma, já com as alterações que os scripts fizeram.

getOriginalWeaponProperty Lê o valor de fábrica de uma propriedade, ignorando qualquer alteração feita por script.