Flake One-Hand Weapons

Overview

Applies a jerrycan-style movement clipset to make your character hold weapons in one hand. Works with any weapon (or a custom list) and supports both toggle and always-on modes.

Features

• Toggle or Always-On — Choose between a keybind toggle or permanent one-hand stance.
• All Weapons or Whitelist — Apply to every weapon or only specific ones.
• Custom Weapons Supported — Add any custom weapon hash to the list.
• ox_lib Notifications — Optional styled notifications instead of GTA feed.
• Admin Commands — Force enable/disable/list player states from console.
• Rebindable Key — Players can change the toggle key in GTA settings.

Requirements

Installation

Place the flake_onehandweapon folder into your server's resources directory and add to server.cfg:

File Structure

flake_onehandweapon/
├── config.lua       -- Settings (escrow-ignored)
├── client/
│   └── main.lua         -- Animation logic
├── server/
│   └── main.lua         -- Admin commands
└── fxmanifest.lua   -- Resource manifest

Configuration

All settings live in config.lua and are escrow-ignored.

Main Settings

Supported Weapons

When Config.WeaponCheckMode = "list", only these weapons receive the animation. Add custom weapons by their spawn name.

Config.SupportedWeapons = {
    "WEAPON_ASSAULTRIFLE",
    "WEAPON_COMBATPISTOL",
    "WEAPON_CARBINERIFLE",
    "WEAPON_APPISTOL"
}

ox_lib Notification Options

Config.OxLibNotify = {
    position = 'top-right',
    duration = 4000,
    icon     = 'gun'
}

Commands

These commands require ace permissions and are intended for server console or admin use.

Troubleshooting