DAYZ EXPANSION PERSONAL STORAGE GUIDE

Placement, config, settings, categories, and full JSON reference

⬇ Download HTML
Guide Overview

DayZ Expansion Personal Storage Setup

This guide walks through the three main parts of a working personal storage setup: the placed world object, the storage definition file, and the Expansion settings file that controls behavior such as item limits, excluded classes, and menu categories. The long raw text has been cleaned up and fully preserved here in a more readable format.

Object ClassExpansionPersonalStorageChest
Storage ID1
Max Items35
Global StorageDisabled

1. World Object Placement

The storage chest first needs to exist in the world as an Expansion object placed in your mission objects file.

File path

/mpmissions/dayzOffline.chernarusplus/expansion/objects

The object entry places ExpansionPersonalStorageChest in the world at a specific position, orientation, and scale.

Object JSON

{
    "Objects": [
        {
            "name": "ExpansionPersonalStorageChest",
            "pos": [
                1397.7984619140626,
                23.20303726196289,
                578.3357543945313
            ],
            "ypr": [
                70.20000457763672,
                0.0,
                -0.0
            ],
            "scale": 0.9999998807907105,
            "enableCEPersistency": 0,
            "customString": ""
        }
    ]
}

name

The class of the placed world object. Here it is the personal storage chest.

pos / ypr

The exact world coordinates and facing direction of the chest.

enableCEPersistency

Set to 0 here. This keeps the object definition simple and controlled by the Expansion setup.

2. Personal Storage Definition

This file tells Expansion what the placed storage object is, what it should be called in the UI, where it is located, and whether it is personal or global.

File path

/mpmissions/dayzOffline.chernarusplus/expansion/personalstorage
  • StorageID should be unique for each storage config.
  • ClassName should match the placed object class.
  • Position and Orientation should match the placed object so the config lines up with the actual chest in world.
  • IsGlobalStorage set to 0 means personal storage, not shared global storage.

Storage JSON

{
    "ConfigVersion": 2,
    "StorageID": 1,
    "ClassName": "ExpansionPersonalStorageChest",
    "DisplayName": "Personal Storage",
    "DisplayIcon": "Backpack",
    "Position": [
        1397.7984619140626,
        23.20303726196289,
        578.3357543945313
    ],
    "Orientation": [
        70.20000457763672,
        0.0,
        -0.0
    ],
    "QuestID": -1,
    "Faction": "",
    "IsGlobalStorage": 0
}

3. Expansion Settings File

This settings file enables personal storage, defines the per-storage item limit, blocks specific classes, and builds the storage menu category structure players see.

Enabled

1 means the personal storage system is turned on.

UsePersonalStorageCase

1 means the feature uses the personal storage case/chest behavior.

MaxItemsPerStorage

35 limits how many items can be stored in each personal storage.

Excluded class names

The raw file excludes SurvivorBase and ExpansionMoneyBase, which prevents those classes from being stored.

Top of the settings JSON

{
    "m_Version": 1,
    "Enabled": 1,
    "UsePersonalStorageCase": 1,
    "MaxItemsPerStorage": 35,
    "ExcludedClassNames": [
        "SurvivorBase",
        "ExpansionMoneyBase"
    ],
    "MenuCategories": [
        ...
    ]
}

4. Menu Categories and Subcategories

The uploaded settings file contains a full category tree. Below is a formatted overview, followed by the uncut full JSON reference.

Top-level categories

CategoryIconMain Included ClassesSubcategories
Ammoset:dayz_inventory image:bulletsAmmunition_Base, Box_BaseAmmo-Boxes, Ammo-Bullets
Containersset:dayz_inventory image:barrelContainer_BaseNone
Consumablesset:dayz_inventory image:foodEdible_BaseDrinks, Fish, Food, Meat, Meds, Vegetables
Equipmentset:dayz_inventory image:bodyClothingBase, Clothing_BaseArmbands, Backpacks, Belts, Blouses & Suits, Boots & Shoes, Caps, Coats & Jackets, Eyewear, Ghillies, Gloves, Hats & Hoods, Helmets, Masks, Pants, Shirts, Skirts & Dresses, Sweaters & Hoodies, Vests
Explosivesset:dayz_inventory image:explosiveExplosivesBase, RemoteDetonator, RemoteDetonatorTriggerNone
Vehiclesset:dayz_inventory image:cat_vehicle_bodyCarScript, BoatScriptNone
Weaponsset:dayz_inventory image:pistolWeapon_Base, Weapon, ButtstockBase, OpticBase, Magazine_BaseAttachments, Assault Rifles, Pistols, Rifles, Shotguns, Sniper-Rifles

Consumables section

This part of the config splits edible and medical items into focused buckets like drinks, fish, food, meat, meds, and vegetables. That gives the storage UI cleaner browsing instead of one large mixed list.

Equipment section

This is the largest category and covers most wearable gear. It is heavily broken down into clothing-specific subcategories so players can find stored items faster.

5. Practical Setup Workflow

Use this order so the system comes together cleanly.

Step 1

Place the chest in /expansion/objects using the object JSON.

Step 2

Create the matching storage definition in /expansion/personalstorage.

Step 3

Enable and tune the feature in the Expansion personal storage settings file.

Step 4

Make sure the ClassName, Position, and Orientation line up between the placed object and the storage config.

Step 5

Adjust categories only after the base storage works, so troubleshooting stays simple.

Step 6

Restart and test with a few allowed item types first, then test excluded or edge-case items.

6. Troubleshooting Checklist

These are the most likely points of failure based on the configuration structure you uploaded.

If the chest does not work in game

  • Check that the world object class is really ExpansionPersonalStorageChest.
  • Check that the storage config uses the same class and matching coordinates.
  • Check that the settings file has Enabled set to 1.
  • Check that the storage object actually exists in the mission objects load path.

If specific items will not store

  • See whether the item inherits from an excluded class.
  • Check whether the item is missing from your intended included class groups.
  • Verify whether you are expecting an exact item class or a base class match.
  • Review category structure if the item is technically stored but hard to locate in the UI.

7. Full Reference Section

The original information is preserved below in formatted, full-length blocks for copy/paste use.

Full object placement reference
/mpmissions/dayzOffline.chernarusplus/expansion/objects

{
    "Objects": [
        {
            "name": "ExpansionPersonalStorageChest",
            "pos": [
                1397.7984619140626,
                23.20303726196289,
                578.3357543945313
            ],
            "ypr": [
                70.20000457763672,
                0.0,
                -0.0
            ],
            "scale": 0.9999998807907105,
            "enableCEPersistency": 0,
            "customString": ""
        }
    ]
}
Full personal storage definition reference
/mpmissions/dayzOffline.chernarusplus/expansion/personalstorage

{
    "ConfigVersion": 2,
    "StorageID": 1,
    "ClassName": "ExpansionPersonalStorageChest",
    "DisplayName": "Personal Storage",
    "DisplayIcon": "Backpack",
    "Position": [
         1397.7984619140626,
         23.20303726196289,
         578.3357543945313
    ],
    "Orientation": [
        70.20000457763672,
        0.0,
        -0.0
    ],
    "QuestID": -1,
    "Faction": "",
    "IsGlobalStorage": 0
}
Full settings reference
/mpmissions/dayzOffline.chernarusplus/expansion/settings

{
    "m_Version": 1,
    "Enabled": 1,
    "UsePersonalStorageCase": 1,
    "MaxItemsPerStorage": 35,
    "ExcludedClassNames": [
        "SurvivorBase",
        "ExpansionMoneyBase"
    ],
    "MenuCategories": [
        {
            "DisplayName": "Ammo",
            "IconPath": "set:dayz_inventory image:bullets",
            "Included": [
                "Ammunition_Base",
                "Box_Base"
            ],
            "Excluded": [],
            "SubCategories": [
                {
                    "DisplayName": "Ammo-Boxes",
                    "IconPath": "set:dayz_inventory image:bullets",
                    "Included": [
                        "Box_Base"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Ammo-Bullets",
                    "IconPath": "set:dayz_inventory image:bullets",
                    "Included": [
                        "Ammunition_Base"
                    ],
                    "Excluded": []
                }
            ]
        },
        {
            "DisplayName": "Containers",
            "IconPath": "set:dayz_inventory image:barrel",
            "Included": [
                "Container_Base"
            ],
            "Excluded": [],
            "SubCategories": []
        },
        {
            "DisplayName": "Consumables",
            "IconPath": "set:dayz_inventory image:food",
            "Included": [
                "Edible_Base"
            ],
            "Excluded": [],
            "SubCategories": [
                {
                    "DisplayName": "Drinks",
                    "IconPath": "set:dayz_inventory image:canteen",
                    "Included": [
                        "SodaCan_ColorBase",
                        "WaterBottle",
                        "Canteen",
                        "Vodka"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Fish",
                    "IconPath": "set:dayz_inventory image:food",
                    "Included": [
                        "CarpFilletMeat",
                        "MackerelFilletMeat",
                        "Carp",
                        "Sardines",
                        "Mackerel"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Food",
                    "IconPath": "set:dayz_inventory image:food",
                    "Included": [
                        "Zagorky",
                        "ZagorkyChocolate",
                        "ZagorkyPeanuts",
                        "PowderedMilk",
                        "BoxCerealCrunchin",
                        "Rice",
                        "Marmalade",
                        "Honey",
                        "SaltySticks",
                        "Crackers",
                        "Chips",
                        "Pajka",
                        "Pate",
                        "BrisketSpread",
                        "SardinesCan",
                        "TunaCan",
                        "DogFoodCan",
                        "CatFoodCan",
                        "PorkCan",
                        "Lunchmeat",
                        "UnknownFoodCan",
                        "PeachesCan",
                        "SpaghettiCan",
                        "BakedBeansCan",
                        "TacticalBaconCan"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Meat",
                    "IconPath": "set:dayz_inventory image:food",
                    "Included": [
                        "BearSteakMeat",
                        "GoatSteakMeat",
                        "BoarSteakMeat",
                        "PigSteakMeat",
                        "DeerSteakMeat",
                        "WolfSteakMeat",
                        "CowSteakMeat",
                        "SheepSteakMeat",
                        "ChickenBreastMeat",
                        "RabbitLegMeat"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Meds",
                    "IconPath": "set:dayz_inventory image:medicalbandage",
                    "Included": [
                        "CharcoalTablets",
                        "DisinfectantAlcohol",
                        "PurificationTablets",
                        "VitaminBottle",
                        "DisinfectantSpray",
                        "TetracyclineAntibiotics",
                        "PainkillerTablets",
                        "IodineTincture"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Vegetables",
                    "IconPath": "set:dayz_inventory image:food",
                    "Included": [
                        "Apple",
                        "GreenBellPepper",
                        "Zucchini",
                        "Pumpkin",
                        "SlicedPumpkin",
                        "PotatoSeed",
                        "Potato",
                        "Tomato",
                        "SambucusBerry",
                        "CaninaBerry",
                        "Plum",
                        "Pear",
                        "MushroomBase"
                    ],
                    "Excluded": []
                }
            ]
        },
        {
            "DisplayName": "Equipment",
            "IconPath": "set:dayz_inventory image:body",
            "Included": [
                "ClothingBase",
                "Clothing_Base"
            ],
            "Excluded": [],
            "SubCategories": [
                {
                    "DisplayName": "Armbands",
                    "IconPath": "set:dayz_inventory image:armband",
                    "Included": [
                        "Armband_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Backpacks",
                    "IconPath": "set:dayz_inventory image:back",
                    "Included": [
                        "ChildBag_ColorBase",
                        "DryBag_ColorBase",
                        "TaloonBag_ColorBase",
                        "SmershBag",
                        "AssaultBag_ColorBase",
                        "HuntingBag",
                        "TortillaBag",
                        "CoyoteBag_ColorBase",
                        "MountainBag_ColorBase",
                        "AliceBag_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Belts",
                    "IconPath": "set:dayz_inventory image:hips",
                    "Included": [
                        "CivilianBelt",
                        "MilitaryBelt"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Blouses & Suits",
                    "IconPath": "set:dayz_inventory image:body",
                    "Included": [
                        "Blouse_ColorBase",
                        "ManSuit_ColorBase",
                        "WomanSuit_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Boots & Shoes",
                    "IconPath": "set:dayz_inventory image:feet",
                    "Included": [
                        "AthleticShoes_ColorBase",
                        "JoggingShoes_ColorBase",
                        "Sneakers_ColorBase",
                        "Ballerinas_ColorBase",
                        "DressShoes_ColorBase",
                        "HikingBootsLow_ColorBase",
                        "WorkingBoots_ColorBase",
                        "HikingBoots_ColorBase",
                        "CombatBoots_ColorBase",
                        "JungleBoots_ColorBase",
                        "Wellies_ColorBase",
                        "TTSKOBoots",
                        "MilitaryBoots_ColorBase",
                        "NBCBootsBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Caps",
                    "IconPath": "set:dayz_inventory image:headgear",
                    "Included": [
                        "BaseballCap_CMMG_Pink",
                        "BaseballCap_CMMG_Black",
                        "BaseballCap_ColorBase",
                        "PrisonerCap",
                        "PilotkaCap",
                        "PoliceCap",
                        "FlatCap_ColorBase",
                        "ZmijovkaCap_ColorBase",
                        "RadarCap_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Coats & Jackets",
                    "IconPath": "set:dayz_inventory image:body",
                    "Included": [
                        "LabCoat",
                        "TrackSuitJacket_ColorBase",
                        "DenimJacket",
                        "WoolCoat_ColorBase",
                        "RidersJacket_ColorBase",
                        "FirefighterJacket_ColorBase",
                        "JumpsuitJacket_ColorBase",
                        "BomberJacket_ColorBase",
                        "QuiltedJacket_ColorBase",
                        "PrisonUniformJacket",
                        "PoliceJacketOrel",
                        "PoliceJacket",
                        "ParamedicJacket_ColorBase",
                        "HikingJacket_ColorBase",
                        "Raincoat_ColorBase",
                        "TTsKOJacket_ColorBase",
                        "BDUJacket",
                        "HuntingJacket_ColorBase",
                        "M65Jacket_ColorBase",
                        "GorkaEJacket_ColorBase",
                        "USMCJacket_ColorBase",
                        "NBCJacketBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Eyewear",
                    "IconPath": "set:dayz_inventory image:eyewear",
                    "Included": [
                        "SportGlasses_ColorBase",
                        "ThinFramesGlasses",
                        "ThickFramesGlasses",
                        "DesignerGlasses",
                        "AviatorGlasses",
                        "TacticalGoggles",
                        "NVGHeadstrap",
                        "EyePatch_Improvised"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Ghillies",
                    "IconPath": "set:dayz_inventory image:missing",
                    "Included": [
                        "GhillieHood_ColorBase",
                        "GhillieBushrag_ColorBase",
                        "GhillieTop_ColorBase",
                        "GhillieSuit_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Gloves",
                    "IconPath": "set:dayz_inventory image:gloves",
                    "Included": [
                        "SurgicalGloves_ColorBase",
                        "WorkingGloves_ColorBase",
                        "TacticalGloves_ColorBase",
                        "OMNOGloves_ColorBase",
                        "NBCGloves_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Hats & Hoods",
                    "IconPath": "set:dayz_inventory image:headgear",
                    "Included": [
                        "MedicalScrubsHat_ColorBase",
                        "CowboyHat_ColorBase",
                        "MilitaryBeret_ColorBase",
                        "BeanieHat_ColorBase",
                        "Ushanka_ColorBase",
                        "BoonieHat_ColorBase",
                        "OfficerHat",
                        "NBCHood"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Helmets",
                    "IconPath": "set:dayz_inventory image:headgear",
                    "Included": [
                        "HelmetBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Masks",
                    "IconPath": "set:dayz_inventory image:mask",
                    "Included": [
                        "SurgicalMask",
                        "NioshFaceMask",
                        "HockeyMask",
                        "BalaclavaMask_ColorBase",
                        "Balaclava3Holes_ColorBase",
                        "WeldingMask",
                        "GasMask",
                        "GP5GasMask",
                        "AirborneMask"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Pants",
                    "IconPath": "set:dayz_inventory image:legs",
                    "Included": [
                        "MedicalScrubsPants_ColorBase",
                        "TrackSuitPants_ColorBase",
                        "PrisonUniformPants",
                        "Breeches_ColorBase",
                        "SlacksPants_ColorBase",
                        "CanvasPantsMidi_ColorBase",
                        "CanvasPants_ColorBase",
                        "JumpsuitPants_ColorBase",
                        "PolicePants",
                        "ParamedicPants_ColorBase",
                        "FirefightersPants_ColorBase",
                        "CargoPants_ColorBase",
                        "ShortJeans_ColorBase",
                        "Jeans_ColorBase",
                        "TTSKOPants",
                        "BDUPants",
                        "USMCPants_ColorBase",
                        "PolicePantsOrel",
                        "HunterPants_ColorBase",
                        "GorkaPants_ColorBase",
                        "NBCPantsBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Shirts",
                    "IconPath": "set:dayz_inventory image:body",
                    "Included": [
                        "TShirt_ColorBase",
                        "Shirt_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Skirts & Dresses",
                    "IconPath": "set:dayz_inventory image:body",
                    "Included": [
                        "Skirt_ColorBase",
                        "MiniDress_ColorBase",
                        "NurseDress_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Sweaters & Hoodies",
                    "IconPath": "set:dayz_inventory image:body",
                    "Included": [
                        "Sweater_ColorBase",
                        "Hoodie_ColorBase"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Vests",
                    "IconPath": "set:dayz_inventory image:vest",
                    "Included": [
                        "ReflexVest",
                        "PoliceVest",
                        "PressVest_ColorBase",
                        "UKAssVest_ColorBase",
                        "SmershVest",
                        "HighCapacityVest_ColorBase",
                        "PlateCarrierVest",
                        "HuntingVest"
                    ],
                    "Excluded": []
                }
            ]
        },
        {
            "DisplayName": "Explosives",
            "IconPath": "set:dayz_inventory image:explosive",
            "Included": [
                "ExplosivesBase",
                "RemoteDetonator",
                "RemoteDetonatorTrigger",
                "RemoteDetonatorTrigger"
            ],
            "Excluded": [],
            "SubCategories": []
        },
        {
            "DisplayName": "Vehicles",
            "IconPath": "set:dayz_inventory image:cat_vehicle_body",
            "Included": [
                "CarScript",
                "BoatScript"
            ],
            "Excluded": [],
            "SubCategories": []
        },
        {
            "DisplayName": "Weapons",
            "IconPath": "set:dayz_inventory image:pistol",
            "Included": [
                "Weapon_Base",
                "Weapon",
                "ButtstockBase",
                "OpticBase",
                "Magazine_Base"
            ],
            "Excluded": [
                "Ammunition_Base"
            ],
            "SubCategories": [
                {
                    "DisplayName": "Attachments",
                    "IconPath": "set:dayz_inventory image:weaponmuzzle",
                    "Included": [
                        "ButtstockBase",
                        "OpticBase",
                        "Magazine_Base"
                    ],
                    "Excluded": [
                        "Ammunition_Base"
                    ]
                },
                {
                    "DisplayName": "Assault Rifles",
                    "IconPath": "set:dayz_inventory image:pistol",
                    "Included": [
                        "FAL_Base",
                        "AKM_Base",
                        "AK74_Base",
                        "M4A1_Base",
                        "M16A2_Base",
                        "Famas_Base",
                        "Aug_Base"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Pistols",
                    "IconPath": "set:dayz_inventory image:pistol",
                    "Included": [
                        "Pistol_Base"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Rifles",
                    "IconPath": "set:dayz_inventory image:pistol",
                    "Included": [
                        "Izh18_Base",
                        "Ruger1022_Base",
                        "Repeater_Base",
                        "Mosin9130_Base",
                        "CZ527_Base",
                        "CZ550_Base",
                        "Winchester70_Base",
                        "SSG82_Base"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Shotguns",
                    "IconPath": "set:dayz_inventory image:pistol",
                    "Included": [
                        "Izh18Shotgun_Base",
                        "Izh43Shotgun_Base",
                        "Mp133Shotgun_Base",
                        "Remington12",
                        "Saiga_Base",
                        "SawedoffIzh18Shotgun"
                    ],
                    "Excluded": []
                },
                {
                    "DisplayName": "Sniper-Rifles",
                    "IconPath": "set:dayz_inventory image:pistol",
                    "Included": [
                        "VSS_Base",
                        "B95_base",
                        "SVD_Base",
                        "Scout_Base"
                    ],
                    "Excluded": []
                }
            ]
        }
    ]
}