Basic Configs

Key Configurations

Config Key	Description	Example
Config.lootRefreshTime	Default cooldown time (in minutes) before a lootable entity becomes lootable again.	Config.lootRefreshTime = 5
Config.UseProgressBar	Enables/disables the use of progress bars during the looting process.	Config.UseProgressBar = true
Config.DistanceCheckProtection	Radius (in meters) for object scanning to prevent excessive performance usage.	Config.DistanceCheckProtection = 15.0
Config.InventoryImagePath	Path for inventory images to display in the loot UI.	Config.InventoryImagePath = "nui://core_inventory/html/img/"

---

ProgressBars Configuration

Config.ProgressBars defines animations and durations for different loot types.

Key	Description	Example
["zombie_default"]	Animation for looting entities (e.g., zombies).	Config.ProgressBars["zombie_default"] = {duration = 1000, label = "Searching Corpse"}
["prop_loot"]	Animation for looting props (e.g., boxes or cars).	Config.ProgressBars["prop_loot"] = {duration = 1500, label = "Looking for loot"}

---

Loot Zones

Config.disableLootZones: Defines areas where looting is disabled. Example:

Config.disableLootZones = {
    {coords = vector3(215.578, -1135.859, 29.29675), radius = 400.0},
}

Config.lootIncreaseZones: Areas where players have increased chances for better loot. Example:

Config.lootIncreaseZones = {
    {coords = vector3(215.578, -1135.859, 29.29675), radious = 400.0, loopIncrease = 2}
}

Leverage loopIncrease for Strategic Zones:

• Create high-reward areas using loopIncrease and encourage players to explore risky zones.

---

DistanceCheckProtection

This parameter ensures that players must be within a certain distance from a lootable object to interact with it. It prevents players from exploiting or looting objects from unrealistic distances.

Purpose:

• Adds realism by requiring proximity for interaction.

• Serves as a safeguard against exploits.

Example Configuration:

Config.DistanceCheckProtection = 15.0

Explanation:

• Value: The maximum distance (in game units) at which a player can interact with a lootable object.

Use Case:

• If a player is further than 15 units from a lootable object, the script will not allow them to interact.

• If the player comes within the specified range, the object becomes lootable.

---

InventoryImagePath

This parameter defines the path to the directory where item images are stored. These images are displayed in the loot inventory UI to represent the items visually.

Purpose:

• Enhances the user interface by showing item images during looting.

• Ensures compatibility with different inventory systems that store images in varying locations.

Example Configuration:

Config.InventoryImagePath = "nui://core_inventory/html/img/"

Explanation:

• Path: The URL or directory path to the folder containing item images.

• The nui:// prefix indicates that this is a NUI (Native User Interface) resource.

Use Case:

• If a player loots a drink_water item, the script will look for an image named drink_water.png in the specified directory.

• This allows the inventory UI to display the correct icon for each item.

Customizing the Path:

• If you use a different inventory system or store images in another location, you can update this path to match your setup.