# Dealers

## Editing the pre-configured dealers

This file can be located in *peuren\_burglary\shared\sh\_main.lua.*

```lua
Config.Dealers = {
    ["basic"] = {
        GlobalCooldown = { min = 20, sec = 5 },--Dealers cooldown
        PersonalCooldown = { min = 25, sec = 10 },--Your personal cooldown with the dealer

        Dealer = {
            name = 'Basic dealer',--Dealers name
            model = 'a_m_m_eastsa_02',--Dealers ped model, model names can be found @ https://docs.fivem.net/docs/game-references/ped-models/
            pos = vec3(1515.5446, -2137.5049, 75.7),--Dealers positions
            heading = 172.1174,--Dealers heading
            animation = {--This controls dealer animation, if you don't want this, make it to: animation = false
                --Supported anim data format:
                    -- anim = ''
                    -- dict = ''
                    -- scenario = ''
                --Examples:
                    -- anim = 'missexile3'
                    -- dict = 'ex03_dingy_search_case_base_michael'
                scenario = 'WORLD_HUMAN_SMOKING'
            }
        },

        AvailableHouses = {
            ['trailer'] = 0,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['small'] = 10,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['medium'] = 20--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
        },

        RequiredRep = {
            ["warehouse"] = 0,--How much reputation level you need have with this dealer so basic dealer becomes available  
            ["exclusive"] = 0,--How much reputation level you need have with this dealer so basic dealer becomes available             
        }
    },
     --The same configuration is followed for all the dealers   
}
```

## Adding new dealers

This file can be located in *peuren\_burglary\shared\sh\_main.lua.*

You can create additional dealers by following this template and adding them inside the Config.Dealers

**New Dealer Template**

```lua
["newdealername"] = {
        GlobalCooldown = { min = 20, sec = 5 },--Dealers cooldown
        PersonalCooldown = { min = 25, sec = 10 },--Your personal cooldown with the dealer

        Dealer = {
            name = 'New Dealers Name',--Dealers name
            model = 'a_m_m_eastsa_02',--Dealers ped model, model names can be found @ https://docs.fivem.net/docs/game-references/ped-models/
            pos = vec3(1515.5446, -2137.5049, 75.7),--Dealers positions
            heading = 172.1174,--Dealers heading
            animation = {--This controls dealer animation, if you don't want this, make it to: animation = false
                --Supported anim data format:
                    -- anim = ''
                    -- dict = ''
                    -- scenario = ''
                --Examples:
                    -- anim = 'missexile3'
                    -- dict = 'ex03_dingy_search_case_base_michael'
                scenario = 'WORLD_HUMAN_SMOKING'
            }
        },

        AvailableHouses = {
            ['trailer'] = 0,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['small'] = 10,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['medium'] = 20--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
        },

        RequiredRep = {
            ["warehouse"] = 0,--How much reputation level you need have with this dealer so the new dealer becomes available  
            ["exclusive"] = 0,--How much reputation level you need have with this dealer so the new dealer becomes available             
        }
    },
```

**Adding it to the other dealers**

To add your new dealer to the resource just put it in the Config.Dealers like the example below.

```lua
Config.Dealers = {
    ["newdealername"] = {
        GlobalCooldown = { min = 20, sec = 5 },--Dealers cooldown
        PersonalCooldown = { min = 25, sec = 10 },--Your personal cooldown with the dealer

        Dealer = {
            name = 'New Dealers Name',--Dealers name
            model = 'a_m_m_eastsa_02',--Dealers ped model, model names can be found @ https://docs.fivem.net/docs/game-references/ped-models/
            pos = vec3(1515.5446, -2137.5049, 75.7),--Dealers positions
            heading = 172.1174,--Dealers heading
            animation = {--This controls dealer animation, if you don't want this, make it to: animation = false
                --Supported anim data format:
                    -- anim = ''
                    -- dict = ''
                    -- scenario = ''
                --Examples:
                    -- anim = 'missexile3'
                    -- dict = 'ex03_dingy_search_case_base_michael'
                scenario = 'WORLD_HUMAN_SMOKING'
            }
        },

        AvailableHouses = {
            ['trailer'] = 0,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['small'] = 10,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['medium'] = 20--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
        },

        RequiredRep = {
            ["warehouse"] = 0,--How much reputation level you need have with this dealer so the new dealer becomes available  
            ["exclusive"] = 0,--How much reputation level you need have with this dealer so the new dealer becomes available             
        }
    },
    ["basic"] = {
        GlobalCooldown = { min = 20, sec = 5 },--Dealers cooldown
        PersonalCooldown = { min = 25, sec = 10 },--Your personal cooldown with the dealer

        Dealer = {
            name = 'Basic dealer',--Dealers name
            model = 'a_m_m_eastsa_02',--Dealers ped model, model names can be found @ https://docs.fivem.net/docs/game-references/ped-models/
            pos = vec3(1515.5446, -2137.5049, 75.7),--Dealers positions
            heading = 172.1174,--Dealers heading
            animation = {--This controls dealer animation, if you don't want this, make it to: animation = false
                --Supported anim data format:
                    -- anim = ''
                    -- dict = ''
                    -- scenario = ''
                --Examples:
                    -- anim = 'missexile3'
                    -- dict = 'ex03_dingy_search_case_base_michael'
                scenario = 'WORLD_HUMAN_SMOKING'
            }
        },

        AvailableHouses = {
            ['trailer'] = 0,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['small'] = 10,--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
            ['medium'] = 20--Minimum reputation level required to get this type of houses, ['shel type name'] = min rep required
        },

        RequiredRep = {
            ["warehouse"] = 0,--How much reputation level you need have with this dealer so basic dealer becomes available  
            ["exclusive"] = 0,--How much reputation level you need have with this dealer so basic dealer becomes available             
        }
    },
     -- Other Dealers after this   
}
```

## Dealer Reputation

This file can be located in *peuren\_burglary\shared\sh\_main.lua.*

```lua
Config.Reputation = {
    DecreaseCooldown = { --Set to false if disabled
        minRep = 15, --The amount of rep required for the dealer for the personal cooldown to be lowered
        cooldownMultiplier = 1 --How much to lower to personal cooldown in percentage (Calculated by (Dealer Rep - Min Rep) * multiplier)
    },
    GainPerAction = { min = 50, max = 100 }, --XP you get after succesfully hacking (completing the minigame) -Use false to disable
    DecreaseOnFail = { min = 10, max = 30 }, --Remove XP after failing the hack (failing the minigame) -Use false to disable.
    LoseOverTime = { minHours = 48, amount = 1 } --How much hours required to pass before you start losing XP. Amount = the amount of XP lost each hour. --  -Use false to disable
}
```

## Dealer Tasks

This file can be located in *peuren\_burglary\shared\sh\_tasks.lua.*

```lua
--Basic dealer reputation tasks
    ['basic'] = {
        ['get_meth'] = {--['your task name id'] = {}
            Type = 'item',--Task type, supported types are minigame and item
            Item = 'methbag',--Item that is needed
            Amount = 10,--Item amount that is needed
            Rewards = {
                money = { 
                    chance = 50, 
                    account = 'cash', 
                    amount = { min = 100, max = 3000 } 
                },

                items = { 
                    --{ name = item spawn name, min = min amount, max = max amount, chance = the chance from 0-100 of getting this item },
                    { name = 'house_lockpick', min = 1, max = 3, chance = 100},
                },

                reputation = {--When a task is completed how much rep levels should be given to a player, min and max
                    min = 1,
                    max = 3,
                }
            },

            Penalty = {--If a task is not finished or canceled, how much rep levels should a player loose, min and max
                min = 1,
                max = 2,
            }
        },
        
        ['lockpick_five'] = { --['your task name id'] = {}
            Type = 'minigame',--Task type, supported types are minigame and item
            Minigame = 'lockpicking',--Minigame type, supported minigame name types are lockpicking and hacking
            Count = 3,--How many successfull minigames should a player do to complete this task
            Rewards = {
                money = { 
                    chance = 50, 
                    account = 'cash', 
                    amount = { min = 50, max = 2000 } 
                },

                items = { 
                    --{ name = item spawn name, min = min amount, max = max amount, chance = the chance from 0-100 of getting this item },
                    { name = 'house_lockpick', min = 1, max = 3, chance = 100},
                },

                reputation = {--When a task is completed how much rep levels should be given to a player, min and max
                    min = 1,
                    max = 3,
                }
            },
            Penalty = {--If a task is not finished or canceled, how much rep levels should a player loose, min and max
                min = 1,
                max = 2,
            }
        },

        ['hacking_five'] = { 
            Type = 'minigame',--Task type, supported types are minigame and item
            Minigame = 'hacking',--Minigame type, supported minigame name types are lockpicking and hacking
            Count = 3,--How many successfull minigames should a player do to complete this task
            Rewards = {
                money = { 
                    chance = 50, 
                    account = 'cash', 
                    amount = { min = 50, max = 2000 } 
                },

                items = { 
                    --{ name = item spawn name, min = min amount, max = max amount, chance = the chance from 0-100 of getting this item },
                    { name = 'house_lockpick', min = 1, max = 2, chance = 100},
                },

                reputation = {--When a task is completed how much rep levels should be given to a player, min and max
                    min = 1,
                    max = 3,
                }
            },
            Penalty = {--If a task is not finished or canceled, how much rep levels should a player loose, min and max
                min = 1,
                max = 2,
            }
        },
    },


```

You can edit the pre-configured tasks or add new tasks by following the examples


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://peuren.gitbook.io/peuren/peuren_burglary/configuration/dealers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
