CS Holster Sling

A comprehensive FiveM resource that automatically manages weapon holsters and slings for a more immersive roleplay experience.

Features

Automatic Holster Management

• Auto-Detection: Automatically detects when handguns are drawn or holstered
• Visual Switching: Seamlessly switches between holstered and unholstered holster models
• Gender Support: Works for both male and female characters
• Draw Animations: Smooth custom animations when drawing/holstering weapons (if enabled)
• Sound Effects: Optional holster/unholster sound effects

Sling System

• Long Gun Support: Automatically attaches rifles and shotguns to your back or front when put away
• Position Control: Use /sling back or /sling front to change sling position (default: back)
• Persistent Settings: Your sling position preference is saved between sessions
• Smooth Animations: Includes animations when placing and taking weapons from the sling

Holster Emote

• Quick Access: Press your configured key (default: G) to play a holster emote
• Customizable Keybind: Change the keybind in FiveM Settings > Key Bindings
• Smart Detection: Only works when you have a valid holster equipped

Installation

1. Place the cs_holstersling folder in your resources/[scripts]/ directory
2. Add ensure cs_holstersling to your server.cfg
3. IMPORTANT: Configure the holster drawables in config.lua to match your server's EUP setup (see Configuration section below)

Configuration

⚠️ CRITICAL: Holster Configuration Required

You MUST configure the holster drawables in config.lua to match your server's EUP (Extended User Ped) setup. The script comes with example configurations, but these will NOT work unless they match your actual EUP holster drawable IDs.

What You Need to Configure

1. Holster Drawables: Edit Config.HolstersMale and Config.HolstersFemale in config.lua

   • Each entry needs:
     • with: The drawable ID when the weapon is holstered (visible in holster)
     • without: The drawable ID when the weapon is drawn (empty holster)
   • Example: If your EUP holster drawable 5 shows a gun and drawable 6 shows an empty holster, configure accordingly

2. Weapon Lists:

   • Config.HolsterWeapons: List of handgun weapon names that use the holster system
   • Config.SlingWeapons: List of long gun weapon names that use the sling system

3. Optional Settings:

   • Config.EnableHolsterAnimations: Enable/disable draw/holster animations
   • Config.EnableHolsterSounds: Enable/disable sound effects
   • Config.HolsterEmoteKey: Change the default key for holster emote (default: G)
   • Config.AnimationCooldown: Adjust animation timing (default: 1000ms)

How to Find Your Holster Drawable IDs

1. Equip a holster in-game
2. Use a resource like qb-clothing or check your EUP menu to see the drawable ID
3. Note the drawable ID when the weapon is visible in the holster
4. Draw the weapon and note the drawable ID when the holster is empty
5. Add these to your configuration

Usage

Basic Usage

Once configured, the script works automatically:

• Draw a handgun → Holster automatically switches to unholstered version
• Holster a handgun → Holster automatically switches back to holstered version
• Put away a long gun → Weapon automatically attaches to your back/front

Commands

• /sling back - Set sling position to back (default)
• /sling front - Set sling position to front

Keybinds

• Holster Emote (default: G) - Press to play holster emote (only works with valid holster equipped)
  • Change in: FiveM Settings > Key Bindings > "CS Holster Sling - Holster Emote"

Requirements

• rpemotes-reborn (for holster emote feature) (optional, can use default 'hoster' emote)
• EUP (Extended User Ped) with holster components configured

Support

If you experience issues:

1. Ensure your holster drawables are correctly configured in config.lua
2. Check that your EUP holster drawable IDs match your configuration
3. Enable debug mode (Config.Debug = true) to see detailed console messages
4. Verify that rpemotes-reborn is running (for emote feature)

Notes

• The script only works with configured holsters - if you don't have a holster equipped, animations and sounds won't play
• Sling position preference is saved per player and persists between sessions
• All features can be enabled/disabled via the configuration file

Support

• https://discord.gg/XHrPvWVHRW