2 Page 3: Weapon Item Structure & Attributes
Benjamin W Hamby edited this page 2026-03-09 22:20:56 -05:00

//--Weapons are standard Minecraft items containing identifying custom data.--\

Example concept:

 leadlocked_weapon: true
 gun_id: pistol_9mm
 ammo_type: light
 damage: 4
 spread: 0.02
 fire_rate: 8
 mag_size: 12
 reload_time: 40
 range: 50

The plugin checks the leadlocked_weapon tag to determine if the item should function as a gun.

Each weapon must contain a unique gun_id.

//--Core properties required for weapons.--\

 gun_id

 gun_type

 ammo_type

 damage

 semi/burst/auto/pellet(shotgun)

 fire_rate

 spread

 mag_size

 reload_time

 range

//--Optional properties.--\

 pellet_count

 burst_count

 recoil_vertical

 recoil_horizontal

 headshot_multiplier

 armor_penetration

 damage_falloff

These values may be defined in plugin configuration or referenced through custom item data.