🔥 BLN Campfire

📺 Preview

Video Preview

💰 Buy Now

Get it now

Add immersive campfires to your RedM server! Place campfires, sit around them with friends, and create cozy gathering spots in the wilderness.

✨ Features

• 🎮 Multiple ways to place campfires (command or usable items)

• 🌟 Multiple campfire types and styles

• 👥 Fully synchronized across all players

• 💫 Smooth placement preview system

• 🪑 Sit around campfires with proper animations with your friends

• 🔄 Persistent through player reconnects

• ⚡ Optimized performance

• 🛡️ Smart placement restrictions (towns, water, roads)

• 🔧 Framework support out of the box:

  • VORP Core
  • RedEM / RedEM 2023
  • QBR Core
  • RSG Core
  • QR Core
  • Easily extendable for other frameworks

  Dependencies

• bln_notify

⚙️ Installation

1. Download the latest release
2. Extract the files to your server's resource folder
3. Add ensure bln_campfire to your server.cfg
4. Configure the settings in config.lua to your liking
5. Restart your server

🛠️ Configuration

Config = {

    promptDistance = 2.0,      -- Maximum distance to show prompts when near a campfire

    command = 'setupcampfire', -- Command to setup campfire (e.g. /setupcampfire [campfireType])

    keybindins = {
        ["place"]   = { label = "Place", key = 0xC7B5340A },    -- Enter key
        ["cancel"]  = { label = "Cancel", key = 0x156F7119 },   -- Backspace key
        ["remove"]  = { label = "Remove", key = 0xC7B5340A },   -- Enter key
        ["sit"]     = { label = "Sit", key = 0x760A9C6F },      -- G key
        ["standup"] = { label = "Stand Up", key = 0xB2F377E8 }, -- F key
    },

    placementSettings = {
        allowMounted = false,      -- Allow/disallow placing while mounted
        preventInTowns = true,     -- Prevent placing inside town limits
        preventNearWater = true,   -- Prevent placing near water bodies
        roadDistance = 5.0,        -- Minimum distance from roads (in meters)
        maxCampfiresPerPlayer = 1, -- Maximum number of campfires per player (0 for unlimited)
        waterCheckDistance = 15.0, -- Distance to check for water bodies
    },

    campfireTypes = {
        ["campfire1"] = {
            model = "p_campfire01x",
            itemName = "campfire1", -- usable item name
        },
        ["campfire2"] = {
            model = "p_campfire02x",
            itemName = "campfire2",
        },
        ["campfire3"] = {
            model = "p_campfire03x",
            itemName = "campfire3",
        },
        ["campfire4"] = {
            model = "p_campfire04x",
            itemName = "campfire4",
        },
        ["campfire5"] = {
            model = "p_campfire05x",
            itemName = "campfire5",
        },
        -- Add more campfire types here as needed
    },

    -- Translations
    T = {
        -- Titles
        campfireTitle = "Campfire",
        placementErrorTitle = "Cannot Place Campfire",
        warningTitle = "Warning",

        -- General messages
        notAllowedToPlaceCampfireDesc = "You are not allowed to place a campfire here.",

        -- Specific placement error messages
        mountedError = "You cannot place a campfire while mounted. Please dismount first.",
        townError = "Campfires cannot be placed within town limits. Try finding a spot in the wilderness.",
        waterError = "This location is too close to water. Find drier ground.",
        roadError = "This spot is too close to the road. Move further away for safety.",
        maxCampfiresError = "You've reached your maximum number of campfires. Remove an existing one first.",

        -- Interaction messages
        campfirePlaced = "Campfire successfully placed",
        campfireRemoved = "Campfire removed",
        invalidType = "Invalid campfire type selected",
    }
}

🎮 Usage

Two ways to place campfires:

1. Using the command:

   • /setupcampfire [type] - Places a campfire of the specified type

2. Using inventory items:

   • Configure item names in config.lua
   • Items are automatically registered with your framework
   • Use the item from your inventory to place the campfire

🔧 Framework Support

• Built-in support for major RedM frameworks
• Easy to extend for custom frameworks
• Modify framework.lua to add support for additional frameworks
• Examples provided for item registration and framework detection

💻 Developer Notes

• Framework detection and support in framework.lua
• Can be modified to support additional frameworks
• Item registration examples for each supported framework
• Clean code structure for easy modifications

🤝 Support

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

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