1 Page 5: Gun Registration
Benjamin W Hamby edited this page 2026-03-09 22:26:08 -05:00

Weapons can be introduced into the system using two methods.

//--Datapack Item Method--\

Weapons can be created directly through datapacks using custom data.

Example concept:

 minecraft:custom_data
 {
   gun_id: "pistol_9mm",
   leadlocked_weapon: true
 }

These items can then appear in:

 Loot tables

 Structures

 Supply drops

 Command rewards

DeadFall will primarily distribute weapons using this method.

//--Plugin Registry Method--\

Weapons can also be defined inside a plugin JSON registry.

Example concept:

 {
   "gun_id": "pistol_9mm",
   "ammo_type": "light",
   "damage": 4,
   "fire_rate": 8,
   "spread": 0.02,
   "mag_size": 12
 }

When the plugin detects an item containing the matching gun_id, the defined weapon properties are applied.

This allows new weapons to be added without modifying plugin code.