> For the complete documentation index, see [llms.txt](https://docs.vames-store.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vames-store.com/assets/vms_needs/configuration-files/config.items.lua.md).

# config.items.lua

{% code fullWidth="true" %}

```lua
Config = Config or {}

Config.Items = {
    -- █▀ ▄▀▄ ▄▀▄ █▀▄
    -- █▀ ▀▄▀ ▀▄▀ █▄▀
    ['sandwich'] = { ... },
    ['burger'] = { ... },
    ['hotdog'] = {
        type = 'food',

        size = 100,
        
        models = {
            [0] = 'prop_cs_hotdog_02',
            [50] = 'prop_cs_hotdog_01',
        },

        attaches = {
            hand = {
                bone = 18905,
                offset = vector3(0.131000, 0.017000, 0.024000),
                rotation = vector3(149.100067, -32.099941, -4.800000),
            },
        },
        
        animation = {
            ['bite'] = {
                dictionary = "mp_player_inteat@burger",
                name = "mp_player_int_eat_burger_fp",
                duration = 1200,
                flag = 51
            },
        },
        
        consume = {
            ['bite'] = {
                minimum = 12,
                maximum = 20
            },
            ['add'] = {
                hunger = {40, 90},
                thirst = 0,
                drunk = 0
            },
            ['remove'] = {
                stress = 0,
                weed_indica = {0, 2},
                weed_sativa = {0, 2},
            },
        }
    },
    ['apple'] = { ... },

    
    -- █▀▄ █▀▄ █ █▄ █ █▄▀
    -- █▄▀ █▀▄ █ █ ▀█ █ █
    ['water'] = { ... },
    ['sprunk_can'] = {
        type = 'drink',
        smellProfile = 'sweet',

        size = 330,

        disableRun = true,
        disableJump = true,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = true,

        models = {
            default = 'prop_ld_can_01b'
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.139000, 0.018000, -0.027000),
                rotation = vector3(-101.920815, -117.601173, -6.399996),
            },
        },
        
        animation = {
            ['idle'] = {
                dictionary = "amb@code_human_wander_drinking@male@base",
                name = "static",
                duration = -1,
                flag = 51
            },
            ['bite'] = {
                dictionary = "amb@code_human_wander_drinking_fat@male@idle_a",
                name = "idle_c",
                duration = 2000,
                flag = 51
            },
        },

        consume = {
            ['bite'] = {
                minimum = 35,
                maximum = 70
            },
            ['add'] = {
                thirst = {14, 32}
            },
            ['remove'] = {
                stress = 0
            },
        }
    },
    ['ecola_can'] = { ... },
    ['junk_can'] = { ... },


    -- ▄▀▄ █   ▄▀▀ ▄▀▄ █▄█ ▄▀▄ █  
    -- █▀█ █▄▄ ▀▄▄ ▀▄▀ █ █ ▀▄▀ █▄▄
    ['patriot_beer'] = {
        type = 'drink',
        smellProfile = 'alcohol',

        size = 500,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,
        
        models = {
            default = 'prop_beer_patriot'
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.109000, -0.130000, -0.054000),
                rotation = vector3(-88.800514, -223.843597, 12.799995),
            },
        },

        animation = {
            ['idle'] = {
                dictionary = "amb@code_human_wander_drinking@male@base",
                name = "static",
                duration = -1,
                flag = 51
            },
            ['bite'] = {
                dictionary = "amb@code_human_wander_drinking_fat@male@idle_a",
                name = "idle_c",
                duration = 2000,
                flag = 51
            },
        },
        
        consume = {
            ['bite'] = {
                minimum = 10,
                maximum = 20
            },
            ['add'] = {
                thirst = {0.8, 2.0},
                drunk = {0.8, 1.7}
            },
            ['remove'] = {
                stress = 0
            },
        }
    },
    ['logger_beer'] = { ... },
    ['piswasser_beer'] = { ... },
    ['themount_whiskey'] = { ... },
    ['bleuterd_champagne'] = { ... },
    ['bleuterd_champagne2'] = { ... },
    ['vodka'] = { ... },


    -- ▄▀  █   ▄▀▄ ▄▀▀ ▄▀▀
    -- ▀▄█ █▄▄ █▀█ ▄██ ▄██
    ['glass'] = {
        type = 'glass',

        size = 300,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,
        
        allowedDrinks = {
            ['water'] = true,
            ['ecola_can'] = true,
            ['sprunk_can'] = true,
            ['junk_can'] = true,
            ['patriot_beer'] = true,
            ['logger_beer'] = true,
            ['piswasser_beer'] = true,
            ['themount_whiskey'] = true,
            ['bleuterd_champagne'] = true,
            ['bleuterd_champagne2'] = true,
            ['codeine'] = true,
        },

        models = {
            [0] = 'prop_wheat_grass_empty',
            [5] = 'vms_glass_half_b',  -- If there is no model available for a given liquid, this one is used.
            [50] = 'vms_glass_full_b',  -- If there is no model available for a given liquid, this one is used.

            liquids = {
                water = {
                    [5] = 'vms_glass_half_b', -- 5% - 49%
                    [50] = 'vms_glass_full_b' -- 50% - 100%
                },
                ecola_can = {
                    [5] = 'vms_glass_half_e',
                    [50] = 'vms_glass_full_e'
                },
                sprunk_can = {
                    [5] = 'vms_glass_half_d',
                    [50] = 'vms_glass_full_d'
                },
                junk_can = {
                    [5] = 'vms_glass_half_f',
                    [50] = 'vms_glass_full_f'
                },
                -- coffee = {
                --     [5] = 'vms_glass_half_h',
                --     [50] = 'vms_glass_full_h'
                -- },
                patriot_beer = {
                    [5] = 'vms_glass_half_c',
                    [50] = 'vms_glass_full_c'
                },
                logger_beer = {
                    [5] = 'vms_glass_half_c',
                    [50] = 'vms_glass_full_c'
                },
                piswasser_beer = {
                    [5] = 'vms_glass_half_c',
                    [50] = 'vms_glass_full_c'
                },
                themount_whiskey = {
                    [5] = 'vms_glass_half_g',
                    [50] = 'vms_glass_full_g'
                },
                codeine = {
                    [5] = 'vms_glass_half_a',
                    [50] = 'vms_glass_full_a'
                },
            }
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.124000, -0.131000, -0.027000),
                rotation = vector3(-82.240364, -217.123444, 7.360001),
            },
        },

        animation = {
            ['idle'] = {
                dictionary = "amb@code_human_wander_drinking@male@base",
                name = "static",
                duration = -1,
                flag = 51
            },
            ['bite'] = {
                dictionary = "amb@code_human_wander_drinking_fat@male@idle_a",
                name = "idle_c",
                duration = 2000,
                flag = 51
            },
            ['smell'] = {
                dictionary = "amb@code_human_wander_drinking@male@idle_a",
                name = "idle_b",
                duration = 3000,
                flag = 51
            },
        },

        consume = {
            ['bite'] = {
                minimum = 25,
                maximum = 50
            },
        }
    },
    ['whisky_glass'] = { ... },
    ['shot_glass'] = { ... },
    ['champ_flute'] = { ... },


    -- ▄▀▀ █▄ ▄█ ▄▀▄ █▄▀ ██▀
    -- ▄██ █ ▀ █ ▀▄▀ █ █ █▄▄
    ['redwood_pack'] = {
        type = 'cigarette_pack',
        behavior = 'cigarette_pack',

        size = 20,

        giveItem = 'cigarette',

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,

        models = {
            default = 'prop_fag_packet_01',
            cigarette = 'prop_cs_ciggy_01'
        },

        attaches = {
            hand = {
                bone = 18905,
                offset = vector3(0.104000, 0.041000, 0.018000),
                rotation = vector3(60.300232, -199.348022, -186.298553),
            },
            rightHand = {
                bone = 57005,
                offset = vector3(0.112000, 0.049000, -0.048000),
                rotation = vector3(-23.699961, -306.443665, -203.097870),
            },
        },

        animation = {
            ['take_out'] = {
                dictionary = "vms@needs@cig_pack",
                name = "take_out",
                duration = nil, -- ./shared/behaviors/CigarettePackBehavior.lua
                flag = 49,
            },
        },
    },
    ['cigarette'] = {
        type = 'cig',
        behavior = 'smoking',

        size = 100,

        requiredItems = {
            {name = 'lighter', quantity = 1, remove = false},
        },

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,

        models = {
            cigarette = {
                unlit = 'prop_cs_ciggy_01',
                lit = {
                    [0] = 'vms_cigarette_1',
                    [30] = 'vms_cigarette_2',
                    [60] = 'vms_cigarette_3',
                    [80] = 'prop_cs_ciggy_01b'
                },
            },
            lighter = 'p_cs_lighter_01'
        },

        particles = {
            ['fire'] = {
                dictionary = 'scr_fm_mp_missioncreator',
                name = 'scr_sh_lighter_flame',
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 1500
            },
            ['start_smoke'] = {
                dictionary = 'core',
                name = 'ent_anim_cig_exhale_nse_car',
                boneIndex = 31086,
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 1500
            },
            ['smoke'] = {
                dictionary = 'core',
                name = 'ent_anim_cig_smoke',
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.0,
                time = 4400
            },
            ['exhale'] = {
                dictionary = 'cut_finale1',
                name = 'cs_cig_exhale_mouth_finale',
                boneIndex = 31086,
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 2000
            },
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.125000, 0.022000, -0.057000),
                rotation = vector3(-8.250003, -4.050001, 106.350700),
            },

            leftHand = {
                bone = 18905,
                offset = vector3(0.110000, -0.008000, 0.026000),
                rotation = vector3(294.795197, 112.130989, 379.156525),
            },
        },

        animation = {
            ['idle'] = {
                dictionary = "vms@needs@smoking",
                name = "idle",
                duration = -1,
                flag = 49
            },

            ['bite'] = {
                dictionary = "vms@needs@smoking",
                name = "hit",
                duration = 4800,
                flag = 49,
            },

            ['light'] = {
                dictionary = "vms@needs@smoking",
                name = "light",
                duration = nil, -- ./shared/behaviors/SmokingBehavior.lua
                flag = 49,
            },
        },
        
        consume = {
            ['bite'] = {
                minimum = 8,
                maximum = 14
            },
            ['remove'] = {
                thirst = {1.6, 3.5},
                stress = {1.6, 3.5},
            },
        }
    },


    --  █▀▄ █▀▄ █ █ ▄▀  ▄▀▀
    --  █▄▀ █▀▄ ▀▄█ ▀▄█ ▄██
    ['codeine'] = {
        type = 'drink',
        smellProfile = 'medicinal',

        size = 100,

        disableRun = true,
        disableJump = true,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = true,
        
        models = {
            default = 'vms_codeine'
        },
        
        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.131000, -0.060000, -0.028000),
                rotation = vector3(-92.700562, 7.500003, -1.950002),
            },
        },

        animation = {
            ['idle'] = {
                dictionary = "amb@code_human_wander_drinking@male@base",
                name = "static",
                duration = -1,
                flag = 51
            },
            ['bite'] = {
                dictionary = "amb@code_human_wander_drinking_fat@male@idle_a",
                name = "idle_c",
                duration = 2000,
                flag = 51
            },
        },

        consume = {
            ['bite'] = {
                minimum = 15,
                maximum = 40
            },
            ['add'] = {
                codeine = {10, 18},
            },
            ['remove'] = {
                stress = 0
            },
        }
    },
    ['joint_sd'] = {
        type = 'drug',
        behavior = 'joint',

        size = 100,

        requiredItems = {
            {name = 'lighter', quantity = 1, remove = false},
        },

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = false,
        disableInVehicle = false,

        models = {
            joint = {
                unlit = 'p_cs_joint_02',
                lit = {
                    [0] = 'vms_joint_1',
                    [30] = 'vms_joint_2',
                    [60] = 'vms_joint_3',
                    [80] = 'p_cs_joint_01'
                },
            },
            lighter = 'p_cs_lighter_01'
        },

        particles = {
            ['fire'] = {
                dictionary = 'scr_fm_mp_missioncreator',
                name = 'scr_sh_lighter_flame',
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 1500
            },
            ['start_smoke'] = {
                dictionary = 'core',
                name = 'ent_anim_cig_exhale_nse_car',
                boneIndex = 31086,
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 1500
            },
            ['smoke'] = {
                dictionary = 'core',
                name = 'ent_anim_cig_smoke',
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.0,
                time = 4400
            },
            ['exhale'] = {
                dictionary = 'cut_finale1',
                name = 'cs_cig_exhale_mouth_finale',
                boneIndex = 31086,
                rotation = vector3(0.0, 0.0, 0.0),
                scale = 1.5,
                time = 2000
            },
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.125000, 0.022000, -0.057000),
                rotation = vector3(-8.250003, -4.050001, 106.350700),
            },

            leftHand = {
                bone = 18905,
                offset = vector3(0.110000, -0.008000, 0.026000),
                rotation = vector3(294.795197, 112.130989, 379.156525),
            },

            mouth = {
                bone = 31086,
                offset = vector3(-0.009000, 0.123000, -0.018000),
                rotation = vector3(-175.498993, 72.300354, -106.200684),
            },

            ear = {
                bone = 31086,
                offset = vector3(0.040000, -0.025000, -0.076000),
                rotation = vector3(-177.448914, 8.850001, -136.200577),
            }
        },

        animation = {
            ['idle'] = {
                dictionary = "vms@needs@smoking",
                name = "idle",
                duration = -1,
                flag = 49
            },

            ['bite'] = {
                dictionary = "vms@needs@smoking",
                name = "hit",
                duration = 4800,
                flag = 49,
            },

            ['light'] = {
                dictionary = "vms@needs@smoking",
                name = "light",
                duration = nil, -- ./shared/behaviors/SmokingBehavior.lua
                flag = 49,
            },
        },
        
        consume = {
            ['bite'] = {
                minimum = 6,
                maximum = 10
            },
            ['add'] = {
                weed_sativa = {1.9, 3.2}
            },
            ['remove'] = {
                thirst = {1.6, 3.5},
                stress = {1.6, 3.5},
            },
        }
    },
    ['joint_nl'] = { ... },
    ['cocaine'] = {
        type = 'drug',
        behavior = 'cocaine',
        smellProfile = 'chemical',

        size = 1,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = false,
        disableInVehicle = false,
        
        models = {
            bag = 'vms_cocaine_bag',
            spatula = 'bkr_prop_coke_spatula_02',
            powder = 'vms_cocaine_pile',
            line = 'vms_cocaine_line',
            card = 'prop_cs_business_card',
            banknote = 'tr_prop_tr_note_rolled_01a',
        },

        attaches = {
            hand = {
                bone = 18905,
                offset = vector3(0.114000, 0.054000, 0.057000),
                rotation = vector3(-100.200638, -68.700317, 10.500000),
            },
            card = {
                bone = 57005,
                offset = vector3(0.138000, 0.030000, -0.075000),
                rotation = vector3(0.000000, 0.000000, -93.300568),
            },
            banknote = {
                bone = 57005,
                offset = vector3(0.121000, 0.032000, -0.060000),
                rotation = vector3(31.039976, 0.000000, -40.959965),
            },
            spatula = {
                bone = 57005,
                offset = vector3(0.100000, 0.011000, -0.096000),
                rotation = vector3(-302.646210, -21.259981, -35.197865),
            },
        },
        
        animation = {
            ['idle'] = {
                dictionary = "vms@needs@drugs",
                name = "idle_bag",
                duration = -1,
                flag = 51
            },
            ['place'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "spill_high",
                    mid = "spill_mid",
                    low = "spill_low",
                },
                duration = 3300,
                flag = 1,
            },
            ['bite'] = {
                dictionary = "vms@needs@drugs",
                name = "snort_spatula",
                duration = 5900,
                flag = 51
            },
            ['prepare_line'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "prepare_line_high",
                    mid = "prepare_line_mid",
                    low = "prepare_line_low",
                },
                duration = 6300,
                flag = 1
            },
            ['snort_line'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "snort_line_high",
                    mid = "snort_line_mid",
                    low = "snort_line_low",
                },
                duration = 5650,
                flag = 1
            },
            ['sweep_away'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "prepare_line_high",
                    mid = "prepare_line_mid",
                    low = "prepare_line_low",
                },
                duration = 1000,
                flag = 51
            },
        },

        consume = {
            ['bite'] = {
                minimum = 1,
                maximum = 1
            },
            ['add'] = {
                cocaine = 45,
            },
            ['remove'] = {
                hunger = {1, 10},
                alcohol = {2, 8},
            },
        }
    },
    ['amphetamine'] = {
        type = 'drug',
        behavior = 'snortable',
        smellProfile = 'chemical',

        size = 1,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = false,
        disableInVehicle = false,
        
        models = {
            bag = 'vms_amphetamine_bag',
            powder = 'vms_amphetamine_pile',
            line = 'vms_amphetamine_line',
            card = 'prop_cs_business_card',
            banknote = 'tr_prop_tr_note_rolled_01a',
        },

        attaches = {
            hand = {
                bone = 18905,
                offset = vector3(0.114000, 0.054000, 0.057000),
                rotation = vector3(-100.200638, -68.700317, 10.500000),
            },
            card = {
                bone = 57005,
                offset = vector3(0.138000, 0.030000, -0.075000),
                rotation = vector3(0.000000, 0.000000, -93.300568),
            },
            banknote = {
                bone = 57005,
                offset = vector3(0.121000, 0.032000, -0.060000),
                rotation = vector3(31.039976, 0.000000, -40.959965),
            },
        },
        
        animation = {
            ['idle'] = {
                dictionary = "vms@needs@drugs",
                name = "idle_bag",
                duration = -1,
                flag = 51
            },
            ['place'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "spill_high",
                    mid = "spill_mid",
                    low = "spill_low",
                },
                duration = 3300,
                flag = 1,
            },
            ['bite'] = {
                dictionary = "vms@needs@drugs",
                name = "snort_hand",
                duration = 5500,
                flag = 49
            },
            ['prepare_line'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "prepare_line_high",
                    mid = "prepare_line_mid",
                    low = "prepare_line_low",
                },
                duration = 6300,
                flag = 1
            },
            ['snort_line'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "snort_line_high",
                    mid = "snort_line_mid",
                    low = "snort_line_low",
                },
                duration = 5650,
                flag = 1
            },
            ['sweep_away'] = {
                dictionary = "vms@needs@drugs",
                variants = {
                    high = "prepare_line_high",
                    mid = "prepare_line_mid",
                    low = "prepare_line_low",
                },
                duration = 1000,
                flag = 51
            },
        },

        consume = {
            ['bite'] = {
                minimum = 1,
                maximum = 1
            },
            ['add'] = {
                amphetamine = 40,
            },
            ['remove'] = {
                hunger = {5, 10},
                alcohol = {2, 8},
            },
        }
    },
    ['meth'] = { ... },
    ['lsd'] = { ... },
    ['heroin_syringe'] = { ... },


    --  ▀█▀ ██▀ ▄▀▀ ▀█▀ █ █▄ █ ▄▀ 
    --   █  █▄▄ ▄██  █  █ █ ▀█ ▀▄█
    ['breathalyzer'] = {
        type = 'breathalyzer',
        behavior = 'breathalyzer',

        size = 1,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,

        models = {
            default = 'vms_breathalyzer',
            positive = 'vms_breathalyzer_red',
            negative = 'vms_breathalyzer_green'
        },
        
        attaches = {
            hand = {
                bone = 18905,
                offset = vector3(0.098000, 0.068000, 0.030000),
                rotation = vector3(-10.649997, -78.150414, -4.350001),
            },
        },

        animation = {
            ['idle'] = {
                dictionary = "vms@needs@breathalyzer",
                name = "idle",
                duration = -1,
                flag = 49
            },
        },
    },
    ['drugtest_thc'] = {
        type = 'drugtest',
        behavior = 'drugtest',

        size = 1,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,

        testCategory = 'THC', -- Config.DrugTests.Categories.THC

        models = {
            closed = 'vms_drugtest',
            opened = 'vms_drugtest_open',
        },

        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.147000, 0.057000, -0.025000),
                rotation = vector3(30.299948, 50.700134, 16.799982),
            },
        },
    },
    ['drugtest_lsd'] = { ... },
    ['drugtest_multi'] = {
        type = 'drugtest',
        behavior = 'drugtest_multi',

        size = 1,

        disableRun = false,
        disableJump = false,
        disableMelee = true,
        disableAsDriver = true,
        disableInVehicle = false,

        models = {
            default = 'vms_drugtest_multi',
        },
        
        attaches = {
            hand = {
                bone = 57005,
                offset = vector3(0.150000, 0.077000, -0.005000),
                rotation = vector3(-88.350517, -41.850044, -40.800034),
            },
        },
    },
}
```

{% endcode %}