🔍 BLN Loot Hunter

📺 Preview

Video Preview

🔽 Get it Now

Download on GitHub

A comprehensive looting system for RedM, allowing players to search containers, loot bodies, and skin animals with a chance-based reward system. Fully compatible with all major RedM frameworks.

✨ Features

• 🧰 Loot containers — Search chests, drawers, cabinets, and more
• 💀 Loot bodies — Search dead NPCs for valuable items
• 🦌 Skin animals — Harvest materials from hunted animals
• 🎲 Chance-based rewards — Configurable odds per item
• 💲 Money rewards — Cash in containers and on bodies
• 📱 Notifications — Visual feedback with item icons
• 🔄 Location cooldowns — Reduces exploit farming
• 🛡️ Server validation — Secure reward handling
• 🧩 Multi-framework — VORP, RedEM, RedEM2023, QBR, RSG, QR

💻 Framework compatibility

✅ VORP ✅ REDEMRP (old/2023) ✅ RSG ✅ QBR

📦 Dependencies

• bln_lib — Framework compatibility and utilities

⚙️ Installation

1. Download from GitHub and extract into your resources folder
2. Ensure bln_lib is installed and started first
3. Add ensure bln_loot_hunter to your server.cfg
4. Configure config.lua to match your items and economy
5. Restart the server

🛠️ Configuration

Core settings

Config = {}

Config.Debug = false  -- Enable for debugging information

Config.Cooldown = 600000  -- Global cooldown for containers and peds (10 minutes)

Config.inventoryURL = "nui://vorp_inventory/html/img/items/"  -- Path to inventory icons

Container configuration

Config.Containers = {
    [`p_chest02x`] = {
        label = "Chest",
        rewards = {
            money = {
                enabled = true,
                min = 5.0,
                max = 25.0,
                chance = 60
            },
            items = {
                enabled = true,
                list = {
                    { name = "goldbar",     min = 1,  max = 3,  chance = 60 },
                    { name = "goldwatch",   min = 1,  max = 2,  chance = 50 },
                    { name = "diamond",     min = 1,  max = 1,  chance = 60 },
                    { name = "pistol_ammo", min = 10, max = 20, chance = 70 }
                }
            }
        }
    },
}

Ped loot configuration

Config.Peds = {
    blacklist = {
        [`A_M_M_SDUpperClass_01`] = true,
        [`A_F_M_ARMTOWNFOLK_01`] = true
    },
    rewards = {
        money = {
            enabled = true,
            min = 0.25,
            max = 3.0,
            chance = 40
        },
        items = {
            enabled = true,
            list = {
                { name = "medicine_poor", min = 1, max = 1, chance = 20 },
                { name = "cigarettepack", min = 1, max = 2, chance = 35 },
                { name = "whiskey",       min = 1, max = 1, chance = 15 },
                { name = "bread",         min = 1, max = 1, chance = 25 },
                { name = "pistol_ammo",   min = 2, max = 5, chance = 10 }
            }
        }
    }
}

Animal skinning configuration

Config.Animals = {
    [`a_c_hawk_01`] = {
        label = "Hawk",
        rewards = {
            items = {
                enabled = true,
                list = {
                    { name = "hawkf",                        min = 3, max = 6 },
                    { name = "provision_trinket_hawk_talon", min = 1, max = 1 }
                }
            }
        }
    },
}

Notification settings

Config.Notifications = {
    Empty = {
        enabled = true,
        messages = {
            { title = "Empty",        message = "Nothing useful found",              type = "ERROR" },
            { title = "No Loot",      message = "This container is empty",           type = "ERROR" },
            { title = "Nothing Here", message = "You didn't find anything of value", type = "ERROR" }
        }
    },
    Cooldown = {
        enabled = true,
        messages = {
            { title = "Already Searched", message = "This has been searched recently",      type = "ERROR" },
            { title = "Nothing Left",     message = "There's nothing more to find here",    type = "ERROR" },
            { title = "Empty Container",  message = "Someone has already taken everything", type = "ERROR" }
        }
    }
}

💡 How it works

1. Containers — Opening a configured container triggers a loot roll; location cooldowns prevent repeat farming
2. Ped looting — Looting valid, non-blacklisted corpses rolls configured rewards; corpses get a cooldown
3. Animal skinning — Skinning uses animal-specific reward tables
4. Notifications — Players see what they found with appropriate icons

📚 Examples

New container type

Config.Containers[`p_chest_fancy_01x`] = {
    label = "Fancy Chest",
    rewards = {
        money = {
            enabled = true,
            min = 10.0,
            max = 50.0,
            chance = 75
        },
        items = {
            enabled = true,
            list = {
                { name = "goldbar",    min = 2, max = 4, chance = 40 },
                { name = "goldwatch",  min = 1, max = 3, chance = 60 },
                { name = "diamond",    min = 1, max = 2, chance = 25 },
                { name = "goldnugget", min = 5, max = 10, chance = 80 }
            }
        }
    }
}

New animal type

Config.Animals[`a_c_wolf`] = {
    label = "Wolf",
    rewards = {
        items = {
            enabled = true,
            list = {
                { name = "wolfmeat",  min = 2, max = 4, chance = 100 },
                { name = "wolfpelt",  min = 1, max = 1, chance = 100 },
                { name = "wolftooth", min = 1, max = 3, chance = 80 },
                { name = "wolfheart", min = 1, max = 1, chance = 30 }
            }
        }
    }
}

🌟 Performance

• Efficient event handling
• Location-based cooldowns to limit server work
• Single notification flow to reduce UI clutter
• Native RedM event integration

🤝 Support

Need help? Have questions? Join our Discord server for support and updates!

• 💬 Discord: Join Our Community
• 🎮 Live support and community help
• 🔄 Regular updates and improvements

---

Built with ❤️ by BLN Studio