05 - Weaponlayouts.meta

Weaponlayouts.meta

INFO

Questo file è il cuore della tua arma. Definisce nome, statistiche, danno, velocità, tipo di munizioni e molto altro.

Obiettivo	Dettagli
Cosa imparerai	Configurare Weaponlayouts.meta per definire statistiche e comportamento dell’arma
Prerequisiti	Completare Animazioni Arma

---

Struttura Base

<?xml version="1.0" encoding="UTF-8"?>
<CWeaponLayouts>
    <Layout>
        <!-- NOME INTERNO: come verrà referenziata da script e altri meta -->
        <Name>w_m4a1</Name>
        
        <!-- NOME VISIBILE: appare nell'HUD (usa chiave di testo) -->
        <DisplayName>WT_M4A1</DisplayName>
        
        <!-- MODELLO: nome del .ydr senza estensione -->
        <Model>w_m4a1</Model>
        
        <!-- MODELLO FIRST PERSON: se diverso dal TP -->
        <FirstPersonModel>w_m4a1_fp</FirstPersonModel>
        
        <!-- CATEGORIA: a che slot appartiene -->
        <Slot>SLOT_ASSAULTRIFLE</Slot>
        
        <!-- DANNO: danno base per colpo -->
        <Damage>35.0</Damage>
        
        <!-- DISTANZA: portata massima in metri -->
        <MaxHeadShotDistance>200.0</MaxHeadShotDistance>
        
        <!-- VELOCITÀ DEL PROIETTILE -->
        <BulletSpeed>600.0</BulletSpeed>
        
        <!-- MUNIZIONI: tipo di proiettile -->
        <AmmoType>AMMO_PISTOL</AmmoType>
        
        <!-- RATE OF FIRE: colpi al minuto -->
        <InitialSpread>0.5</InitialSpread>
        <Spread>1.0</Spread>
        
        <!-- RICOMPENSA DEL COLPO -->
        <Recoil>0.4</Recoil>
        <RecoilShakeAmplitude>0.5</RecoilShakeAmplitude>
    </Layout>
</CWeaponLayouts>

---

Parametri Dettagliati

Statistiche del Danno

Parametro	Descrizione	Valore Tipico
Damage	Danno per colpo	15 (pistola) — 100 (fucile)
MaxHeadShotDistance	Distanza massima per headshot	100-500 m
BulletDamage	Danno extra del proiettile	0-20
VehicleDamage	Danno ai veicoli	0-50
PhysicsForce	Forza fisica del colpo	10-50

Spread e Precisione

Parametro	Descrizione	Valore Tipico
InitialSpread	Spread al primo colpo	0.1 (preciso) — 1.0 (impreciso)
Spread	Spread massimo dopo colpi continui	0.5 — 5.0
SpreadIncrease	Quanto aumenta lo spread per colpo	0.05 — 0.3
SpreadRecoveryRate	Quanto velocemente si recupera precisione	0.5 — 2.0
Recoil	Quantità di rinculo	0.1 — 1.0

Munizioni

AmmoType	Usato da
AMMO_PISTOL	Pistole
AMMO_SMG	Mitra
AMMO_RIFLE	Fucili d’assalto
AMMO_SHOTGUN	Fucili a pompa
AMMO_SNIPER	Fucili di precisione
AMMO_MG	Mitragliatrici
AMMO_GRENADE	Granate
AMMO_RPG	Lanciarazzi

---

Slots (Categorie)

Slot	Armi
SLOT_PISTOL	Pistole
SLOT_SMG	Mitra
SLOT_ASSAULTRIFLE	Fucili d’assalto
SLOT_SHOTGUN	Fucili a pompa
SLOT_SNIPER	Fucili di precisione
SLOT_MG	Mitragliatrici
SLOT_HEAVY	Armi pesanti
SLOT_THROWN	Lanciabili

INFO

Le armi melee (spade, mazze, coltelli) usano parametri diversi: MeleeHitRange, MeleeDamageType, MeleeSwingSpeed. Vedi la guida completa sulle armi melee.

---

Text Label (DisplayName)

TIP

Aggiungi sempre un AddTextEntry per il DisplayName della tua arma, altrimenti nell’HUD vedrai il nome tecnico invece del nome leggibile.

Le stringhe di testo vanno in un file .gxt2 o in un file .lua:

-- client.lua
-- Questo carica una stringa personalizzata per il nome dell'arma
 
AddTextEntry('WT_M4A1', 'M4A1 Tactical')

---

Weaponpickups.meta (Pickup a Terra)

INFO

Senza il Weaponpickups.meta, l’arma non potrà essere raccolta da terra. È necessario per la maggior parte degli script di spawn.

Per rendere l’arma raccoglibile:

<?xml version="1.0" encoding="UTF-8"?>
<CWeaponPickupLayouts>
    <PickupLayout>
        <Name>PICKUP_WEAPON_M4A1</Name>
        <WeaponName>w_m4a1</WeaponName>
        <Model>w_m4a1</Model>
        <Texture>weapon_m4a1</Texture>
        <AmmoAmount>120</AmmoAmount>
    </PickupLayout>
</CWeaponPickupLayouts>

---

TIP

Prossimo passo: 06 - Weaponcomponents.meta

---

Torna alla: Indice Generale