Repository navigation
Wreck & loot system
This page covers the WreckSettings, LootCategories, and LootCrates blocks. Together, they control what happens after the helicopter crashes: the wreck object, how many crates spawn, what loot is inside them, and how to integrate with LBMaster for advanced loot presets.
Controls the wreck object and how crates are physically distributed around it.
"WreckSettings": {
"WreckClassName": "BS_AH64D_Crashed",
"CrateCount": 5,
"CrateClassNames": [
"BS_Military_Flat",
"BS_Military_Medium"
],
"CrateSpawnRadiusMin": 4.0,
"CrateSpawnRadiusMax": 7.0
}
| Option | Type | Default | Description |
|---|---|---|---|
| WreckClassName | String | "BS_AH64D_Crashed" | The class name of the wreck object that replaces the helicopter after the crash. Leave as default unless using a custom model. |
| CrateCount | Integer | 5 | Number of loot crates to spawn around the wreck. Minimum: 1, Maximum: 20. |
| CrateClassNames | Array of Strings | ["BS_Military_Flat", "BS_Military_Medium"] | Pool of crate class names. When a crate is spawned without a specific assignment (see LootCrates below), a random type is chosen from this pool. |
| CrateSpawnRadiusMin | Float (meters) | 4.0 | Minimum distance from the wreck center where crates can spawn. |
| CrateSpawnRadiusMax | Float (meters) | 7.0 | Maximum distance from the wreck center. Crates spawn randomly within this ring. |
-
Category names are case-sensitive.
"Weapons"inLootCrates.Presetsmust exactly match the key inLootCategories. -
Use
SpawnChanceto create rarity tiers. See the rarity guide table above. - Attachments are flexible. If an attachment slot is occupied, the mod places the item in the weapon's internal inventory instead. You won't lose any items.
-
You can create as many categories as you want. "BuildingMaterials", "RaidTools", "ExpansionGear" — any name works as long as the
Presetsarray references it. -
You can repeat categories in Presets.
["Ammo", "Ammo"]draws from the Ammo pool twice, doubling the item count. - Test on an empty server. Spawn the helicopter, let it crash, and check the crates to verify your loot tables are working.
- Mix LBMaster and built-in loot. Some crates can use LBMaster presets while others use the built-in system — they're configured per-crate independently.
This page covers the WreckSettings, LootCategories, and LootCrates blocks. Together, they control what happens after the helicopter crashes: the wreck object, how many crates spawn, what loot is inside them, and how to integrate with LBMaster for advanced loot presets.
Controls the wreck object and how crates are physically distributed around it.
"WreckSettings": {
"WreckClassName": "BS_AH64D_Crashed",
"CrateCount": 5,
"CrateClassNames": [
"BS_Military_Flat",
"BS_Military_Medium"
],
"CrateSpawnRadiusMin": 4.0,
"CrateSpawnRadiusMax": 7.0
}| Option | Type | Default | Description |
|---|---|---|---|
WreckClassName |
String | "BS_AH64D_Crashed" |
The class name of the wreck object that replaces the helicopter after the crash. Leave as default unless using a custom model. |
CrateCount |
Integer | 5 |
Number of loot crates to spawn around the wreck. Minimum: 1, Maximum: 20. |
CrateClassNames |
Array of Strings | ["BS_Military_Flat", "BS_Military_Medium"] |
Pool of crate class names. When a crate is spawned without a specific assignment (see LootCrates below), a random type is chosen from this pool. |
CrateSpawnRadiusMin |
Float (meters) | 4.0 |
Minimum distance from the wreck center where crates can spawn. |
CrateSpawnRadiusMax |
Float (meters) | 7.0 |
Maximum distance from the wreck center. Crates spawn randomly within this ring. |
How crates spawn: Each crate gets a random position in a circle around the wreck. The mod automatically adjusts each crate's Y position to match the terrain height and aligns its rotation to the ground surface normal. This means crates sit naturally on slopes and uneven ground.
Example — Many crates spread wide:
"WreckSettings": {
"WreckClassName": "BS_AH64D_Crashed",
"CrateCount": 10,
"CrateClassNames": [
"BS_Military_Flat",
"BS_Military_Medium"
],
"CrateSpawnRadiusMin": 6.0,
"CrateSpawnRadiusMax": 15.0
}Example — Few crates packed tight:
"WreckSettings": {
"WreckClassName": "BS_AH64D_Crashed",
"CrateCount": 3,
"CrateClassNames": [
"BS_Military_Flat"
],
"CrateSpawnRadiusMin": 2.0,
"CrateSpawnRadiusMax": 5.0
}All crate types extend BS_Loot_Base and share these behaviors:
-
Burning on spawn: Crates spawn on fire for
EventSettings.CrateBurningTimeseconds. During this time they display the name "Burning Crate" and cannot be opened. - Opening: After the fire goes out, players can interact to open the crate. The lid opens with an animation and sound.
- Cannot be moved: Crates cannot be picked up or placed into inventory.
- Auto-destroy when empty: Once all items have been taken from a crate, it marks itself for deletion.
| Class Name | Description |
|---|---|
BS_Military_Flat |
A low-profile military crate |
BS_Military_Medium |
A taller military crate |
The built-in loot system uses two concepts working together:
- Loot Categories — Named pools of items (e.g. "Weapons", "Medical") with spawn rules.
- Loot Crates — Assignments that tell each specific crate which categories to use.
The flow is:
LootCrates[0] → uses Presets: ["Weapons", "Ammo"]
↓ ↓
LootCategories LootCategories
["Weapons"] ["Ammo"]
↓ ↓
Picks 1-2 items Picks 3-6 items
from Weapons pool from Ammo pool
↓ ↓
All spawned inside Crate #1
A category is a named group of items with spawn rules. You define as many categories as you want, each with its own item pool.
"LootCategories": {
"CategoryName": {
"Min": 1,
"Max": 3,
"Items": [
...
]
}
}| Field | Type | Description |
|---|---|---|
Min |
Integer | Minimum number of items to spawn from this category. |
Max |
Integer | Maximum number of items. The actual count is randomized between Min and Max. |
Items |
Array | List of possible items to pick from. |
Each item inside a category has three fields:
{
"LootClass": "M4A1",
"LootAttachments": [
"Mag_STANAG_30Rnd",
"M4_OEBttstck",
"M4_PlasticHndgrd"
],
"SpawnChance": 1.0
}| Field | Type | Default | Description |
|---|---|---|---|
LootClass |
String | — | The DayZ class name of the item (e.g. "M4A1", "BandageDressing", "NVGoggles"). |
LootAttachments |
Array of Strings | [] |
Attachments to add to the item. Each string is a class name. The mod tries to attach them first; if the slot is full, it places them in the item's inventory instead. Use [] for items with no attachments. |
SpawnChance |
Float (0.0–1.0) | 1.0 |
Probability that this item actually spawns when randomly selected. 1.0 = 100% (always), 0.5 = 50%, 0.1 = 10% (very rare). |
How spawn selection works: The system picks a random item from the category, rolls against its
SpawnChance. If the roll succeeds, the item spawns. If it fails, the system picks another random item and tries again. It repeats up to 20 attempts total or until it reaches the target count (random betweenMinandMax). This means rare items (lowSpawnChance) can appear but are never guaranteed.
| SpawnChance | Rarity | Use For |
|---|---|---|
1.0 |
Common | Standard ammo, bandages, food |
0.7 – 0.8 |
Uncommon | Good weapons like FAL, AKM |
0.4 – 0.6 |
Rare | Extended magazines, sniper rifles |
0.2 – 0.35 |
Very Rare | NVGs, C4, RPGs |
0.05 – 0.1 |
Ultra Rare | Endgame items, one-of-a-kind loot |
"Weapons": {
"Min": 1,
"Max": 2,
"Items": [
{
"LootClass": "M4A1",
"LootAttachments": [
"Mag_STANAG_30Rnd",
"M4_OEBttstck",
"M4_PlasticHndgrd"
],
"SpawnChance": 1.0
},
{
"LootClass": "SVD",
"LootAttachments": [
"Mag_SVD_10Rnd",
"PSO1Optic"
],
"SpawnChance": 0.4
},
{
"LootClass": "FAL",
"LootAttachments": [
"Mag_FAL_20Rnd",
"Fal_OeBttstck"
],
"SpawnChance": 0.7
}
]
}This spawns 1 to 2 weapons per crate that uses this category. The M4A1 always spawns if selected (100%), the FAL has a 70% chance, and the SVD is rare at 40%.
"Ammo": {
"Min": 3,
"Max": 6,
"Items": [
{
"LootClass": "AmmoBox_556x45_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "AmmoBox_308Win_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "AmmoBox_545x39_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Mag_STANAG_60Rnd",
"LootAttachments": [],
"SpawnChance": 0.6
},
{
"LootClass": "Mag_AKM_Drum75Rnd",
"LootAttachments": [],
"SpawnChance": 0.4
},
{
"LootClass": "M67Grenade",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
}Spawns 3 to 6 ammo items. Standard ammo boxes always appear, but the extended STANAG mag (60%) and AK drum mag (40%) are less common.
"Medical": {
"Min": 2,
"Max": 5,
"Items": [
{
"LootClass": "BloodBagIV",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "SalineBagIV",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "BandageDressing",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Morphine",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "TetracyclineAntibiotics",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
}"Supplies": {
"Min": 3,
"Max": 5,
"Items": [
{
"LootClass": "TacticalBacon",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Canteen",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "DuctTape",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Battery9V",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Pliers",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "NailBox",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
}"Gear": {
"Min": 1,
"Max": 2,
"Items": [
{
"LootClass": "PlateCarrierVest",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "NVGoggles",
"LootAttachments": [],
"SpawnChance": 0.35
},
{
"LootClass": "Mich2001Helmet",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Rangefinder",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
}Only 1 to 2 gear items per crate. Night vision goggles are highly coveted at only 35% spawn chance.
You can use class names from any loaded mod:
"RaidTools": {
"Min": 1,
"Max": 3,
"Items": [
{
"LootClass": "Expansion_C4_Explosive",
"LootAttachments": [],
"SpawnChance": 0.2
},
{
"LootClass": "Expansion_RPG7",
"LootAttachments": [
"Expansion_PG7VM"
],
"SpawnChance": 0.3
},
{
"LootClass": "BreachingCharge",
"LootAttachments": [],
"SpawnChance": 0.5
}
]
}Important: The class names must match exactly what's registered in DayZ. If a class doesn't exist, the item simply won't spawn (no error).
Show how attachments work in practice — a weapon with optic, magazine, suppressor, and handguard:
"KittedWeapons": {
"Min": 1,
"Max": 1,
"Items": [
{
"LootClass": "M4A1",
"LootAttachments": [
"Mag_STANAG_30Rnd",
"M4_RISHndgrd",
"M68Optic",
"M4_Suppressor"
],
"SpawnChance": 1.0
},
{
"LootClass": "AK74",
"LootAttachments": [
"Mag_AK74_30Rnd",
"AK_WoodBttstck",
"AK_WoodHndgrd",
"PSO1Optic",
"AK_Suppressor"
],
"SpawnChance": 0.8
},
{
"LootClass": "SVD",
"LootAttachments": [
"Mag_SVD_10Rnd",
"PSO1Optic",
"GhillieBushrag_Mossy"
],
"SpawnChance": 0.3
}
]
}Note on attachments: If an attachment can't fit in the weapon's slot (e.g. the slot is already taken by another attachment), the mod will place it inside the weapon's inventory instead. So you won't lose any items.
The LootCrates array defines what goes into each specific crate. Each entry maps to a crate by index: first entry = crate #1, second entry = crate #2, etc.
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Weapons",
"Ammo"
]
}| Field | Type | Description |
|---|---|---|
ClassName |
String | The crate class to spawn for this slot. Overrides the random selection from WreckSettings.CrateClassNames. |
LBPresetName |
String |
(Optional) LBMaster preset name. If set and LBMaster is installed, this preset is used instead of the built-in Presets. Leave as "" to use built-in loot. See [LBMaster Integration](#lbmaster-integration) below. |
Presets |
Array of Strings | Names of loot categories (from LootCategories) to spawn inside this crate. Multiple categories are combined — all their items go into the same crate. |
⚠️ Critical: If you haveCrateCount: 5but only 3 entries inLootCrates, crates 4 and 5 will spawn with a random type fromCrateClassNamesand will have no loot. Always make sureLootCrateshas at least as many entries asCrateCount.
"LootCrates": [
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Weapons",
"Ammo"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "",
"Presets": [
"Medical",
"Supplies"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Gear",
"Ammo"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Medical"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "",
"Presets": [
"Weapons",
"Ammo"
]
}
]Result:
| Crate # | Type | Contents |
|---|---|---|
| 1 | BS_Military_Flat | 1–2 weapons + 3–6 ammo |
| 2 | BS_Military_Medium | 2–5 medical + 3–5 supplies |
| 3 | BS_Military_Flat | 1–2 gear + 3–6 ammo |
| 4 | BS_Military_Flat | 2–5 medical |
| 5 | BS_Military_Medium | 1–2 weapons + 3–6 ammo |
"LootCrates": [
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Weapons"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Ammo"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "",
"Presets": [
"Medical"
]
}
]Each crate has one purpose. Players know "the flat crates have guns, the medium one has meds."
"LootCrates": [
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Weapons",
"Weapons",
"Ammo",
"Ammo"
]
}
]You can repeat category names! This crate draws from "Weapons" twice (2–4 weapons total) and "Ammo" twice (6–12 ammo items total). Great for a high-value single crate.
If you use the LBMaster loot mod, you can use its preset system instead of (or alongside) the built-in loot.
- Set
LBPresetNamein a crate entry to the name of your LBMaster preset. - If LBMaster is installed (
#ifdef LBmaster_Rework) and the preset is found, it fills the crate. - If LBMaster is not installed or the preset name is not found, the system falls back to the built-in
Presetsarray.
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "LBMaster_Military_Tier4",
"Presets": [
"Weapons",
"Ammo"
]
}-
With LBMaster loaded: Crate is filled by
LBMaster_Military_Tier4preset.Presetsis ignored. -
Without LBMaster: Crate gets items from the
WeaponsandAmmocategories.
"LootCrates": [
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "Military_WeaponsCrate",
"Presets": [
"Weapons",
"Ammo"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "Military_MedicalCrate",
"Presets": [
"Medical",
"Supplies"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "Military_GearCrate",
"Presets": [
"Gear"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "Military_AmmoDump",
"Presets": [
"Ammo"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "Military_EliteCrate",
"Presets": [
"Weapons",
"Gear",
"Ammo"
]
}
]Tip: Always define both
LBPresetNameandPresetsas a fallback. This ensures your server works correctly even if LBMaster is temporarily removed or a preset name changes.
Here is a full, copy-paste-ready config block with everything properly structured.
"LootCategories": {
"Weapons": {
"Min": 1,
"Max": 2,
"Items": [
{
"LootClass": "M4A1",
"LootAttachments": [
"Mag_STANAG_30Rnd",
"M4_OEBttstck",
"M4_PlasticHndgrd"
],
"SpawnChance": 1.0
},
{
"LootClass": "SVD",
"LootAttachments": [
"Mag_SVD_10Rnd",
"PSO1Optic"
],
"SpawnChance": 0.4
},
{
"LootClass": "FAL",
"LootAttachments": [
"Mag_FAL_20Rnd",
"Fal_OeBttstck"
],
"SpawnChance": 0.7
},
{
"LootClass": "AKM",
"LootAttachments": [
"Mag_AKM_30Rnd"
],
"SpawnChance": 0.8
}
]
},
"Ammo": {
"Min": 3,
"Max": 6,
"Items": [
{
"LootClass": "AmmoBox_556x45_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "AmmoBox_308Win_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "AmmoBox_545x39_20Rnd",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Mag_STANAG_60Rnd",
"LootAttachments": [],
"SpawnChance": 0.6
},
{
"LootClass": "Mag_AKM_Drum75Rnd",
"LootAttachments": [],
"SpawnChance": 0.4
},
{
"LootClass": "M67Grenade",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
},
"Medical": {
"Min": 2,
"Max": 5,
"Items": [
{
"LootClass": "BloodBagIV",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "SalineBagIV",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "BandageDressing",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Morphine",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "TetracyclineAntibiotics",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
},
"Supplies": {
"Min": 3,
"Max": 5,
"Items": [
{
"LootClass": "TacticalBacon",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Canteen",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "DuctTape",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Battery9V",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Pliers",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "NailBox",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
},
"Gear": {
"Min": 1,
"Max": 2,
"Items": [
{
"LootClass": "PlateCarrierVest",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "NVGoggles",
"LootAttachments": [],
"SpawnChance": 0.35
},
{
"LootClass": "Mich2001Helmet",
"LootAttachments": [],
"SpawnChance": 1.0
},
{
"LootClass": "Rangefinder",
"LootAttachments": [],
"SpawnChance": 1.0
}
]
}
}"LootCrates": [
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Weapons",
"Ammo"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "",
"Presets": [
"Medical",
"Supplies"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Gear",
"Ammo"
]
},
{
"ClassName": "BS_Military_Flat",
"LBPresetName": "",
"Presets": [
"Medical"
]
},
{
"ClassName": "BS_Military_Medium",
"LBPresetName": "",
"Presets": [
"Weapons",
"Ammo"
]
}
]"WreckSettings": {
"WreckClassName": "BS_AH64D_Crashed",
"CrateCount": 5,
"CrateClassNames": [
"BS_Military_Flat",
"BS_Military_Medium"
],
"CrateSpawnRadiusMin": 4.0,
"CrateSpawnRadiusMax": 7.0
}| Crate # | Type | Contents |
|---|---|---|
| 1 | BS_Military_Flat | 1–2 weapons (with attachments) + 3–6 ammo items |
| 2 | BS_Military_Medium | 2–5 medical items + 3–5 survival supplies |
| 3 | BS_Military_Flat | 1–2 gear pieces (plate carrier, NVGs, etc.) + 3–6 ammo |
| 4 | BS_Military_Flat | 2–5 medical items |
| 5 | BS_Military_Medium | 1–2 weapons (with attachments) + 3–6 ammo items |
-
Category names are case-sensitive.
"Weapons"inLootCrates.Presetsmust exactly match the key inLootCategories. -
Use
SpawnChanceto create rarity tiers. See the rarity guide table above. - Attachments are flexible. If an attachment slot is occupied, the mod places the item in the weapon's internal inventory instead. You won't lose any items.
-
You can create as many categories as you want. "BuildingMaterials", "RaidTools", "ExpansionGear" — any name works as long as the
Presetsarray references it. -
You can repeat categories in Presets.
["Ammo", "Ammo"]draws from the Ammo pool twice, doubling the item count. - Test on an empty server. Spawn the helicopter, let it crash, and check the crates to verify your loot tables are working.
- Mix LBMaster and built-in loot. Some crates can use LBMaster presets while others use the built-in system — they're configured per-crate independently.