BLN Studio Docs - RedM Scripts

🎒 BLN Belt Attachments ​

bln belt attachments
bln belt attachments demo 1bln belt attachments demo 2

📺 Preview ​

Video Preview

🔽 Get it Now ​

Download on GitHub

Realistically display your weapons and items on your character's belt when equipped from inventory but not in use. Works with lanterns, lassos, machetes, and more.

✨ Features ​

  • 🔄 Automatic show/hide — Items appear on the belt when equipped but not actively used
  • 👥 Network sync — All players see each other's belt attachments
  • ✨ Smooth transitions — Clean equip and unequip behavior
  • 👤 Male & female — Separate bone and offset support
  • 🧰 Preconfigured items — Seven attachment types ready to use
  • ➕ Extensible — Add categories and items in config.lua

Supported items (default) ​

  • WEAPON_MELEE_LANTERN — Regular lantern
  • WEAPON_MELEE_DAVY_LANTERN — Davy lantern
  • WEAPON_KIT_METAL_DETECTOR — Metal detector
  • WEAPON_LASSO — Regular lasso
  • WEAPON_LASSO_REINFORCED — Reinforced lasso
  • WEAPON_MELEE_MACHETE — Machete
  • WEAPON_BOW — Quiver

You can support and add more items as you need.

⚙️ Installation ​

  1. Download from GitHub and place bln_belt_attachments in your resources folder
  2. Add ensure bln_belt_attachments to your server.cfg
  3. Restart the server

🎮 Usage ​

The script runs automatically once installed. When you have supported items in your inventory:

  • Items appear on your belt when equipped but not in active use
  • Attachments hide while the item is in use, then show again when holstered
  • Other players see your belt attachments in sync

🛠️ Configuration ​

Adding a new category ​

Open config.lua and add a category to Config.categories:

lua
Config.categories = {
    -- Existing categories here...

    knives = {
        {
            hashName = 'WEAPON_MELEE_KNIFE',
            model = `w_melee_knife02`,
            bone = {
                male = 'SKEL_R_Thigh',
                female = 'skel_r_thigh',
            },
            offset = {
                male = {
                    x = 0.0,
                    y = 0.0,
                    z = -0.11,
                    pitch = -83.0,
                    roll = 0.0,
                    yaw = 80.0,
                },
                female = false,
            },
        }
    }
}

Adding an item to an existing category ​

lua
Config.categories = {
    lanterns = {
        {
            hashName = 'WEAPON_MELEE_LANTERN_HALLOWEEN',
            model = `s_interact_lantern_halloween`,
            bone = {
                male = 'PH_Lantern',
                female = 'PH_Lantern',
            },
            offset = {
                male = {
                    x = -0.05,
                    y = 0.0,
                    z = 0.0,
                    pitch = 0.0,
                    roll = 0.0,
                    yaw = 0.0,
                },
                female = false,
            },
        }
    }
}

Configuration properties ​

PropertyDescription
hashNameWeapon hash string, or array of hashes for multiple variants
alwaysAttachedOptional — if true, stays attached while the item is in use
modelModel hash for the prop on the belt
bonemale / female bone names (female = false uses male settings)
offsetPosition (x, y, z) and rotation (pitch, roll, yaw) per gender

Useful bone names: RDR3 bone names reference

Tips for testing ​

  1. Start offset values at 0.0 and adjust gradually
  2. Test male and female characters
  3. Check movement animations
  4. Use small position steps (0.01–0.05) and ~5–10° rotation steps

Troubleshooting ​

If an attachment does not appear:

  1. Verify hashName matches your inventory weapon name exactly
  2. Confirm the model exists and loads
  3. Check bone names
  4. Adjust offsets
  5. Ensure the item is registered in your inventory system

💡 Notes ​

This script is purely cosmetic and does not affect gameplay mechanics. It enhances immersion by showing items on the belt when they are not in use.

For synced attachments across all players, prefer this resource over the older bln_belt_lasso script.

🤝 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