--------------------------------------------------
--------------------------------------------------

  Weapon Drop v2.6

  by diamond-optic
  04.23.16

  www.AvaMods.com
  [email protected]

--------------------------------------------------

  Summary:

    I couldn't understand why there's a key to drop
    weapons in GTA Online but not in single player,
    especially since there was weapons that I did
    not want to carry anymore. Thankfully it is
    pretty easy to do with a script.

--------------------------------------------------

  Information:

    Press F9 (same key as GTA Online) to drop the
    weapon that you currently have equiped. You
    can change the key in the 'Configuration'
    section near the top of the WeaponDrop.lua file.

    I believe I got most of the weapons. Let me
    know of any that I missed. Also let me know
    about any problems you find that are not in
    the 'known issues' section.

    Pickup distance has been descreased, allowing
    weapons to be dropped closer to the player.
 
    Options: Glowing pickups or non-glowing pickups

    
--------------------------------------------------

  Installation:
 
    Place the WeaponDrop.lua file inside the
    \scripts\addins\ directory in your base GTAV
    install location.

    For the pickups.meta files, pick which version
    you want from the OpenIV folder and then just
    follow the folder setup in the download to
    put them in the right place (it's hard to get
    specific here since all the files have the
    same name), just different locations. If you
    can't figure it out, maybe modding gta v is
    not for you...
    
--------------------------------------------------
    
  Requirements:

    Script Hook V
    LUA Plugin For Script Hook V
    OpenIV
    
--------------------------------------------------

  Change Log:
 
    Version 2.6 (04.23.16)
      - Added support for the 2 new weapons from the April 2016 patch
      - Temporary (hopefully) fix for crashing on loading.

    Version 2.5 (12.20.15)
      - Added support for the 2 new weapons from the Executives and Other Criminals DLC

    Version 2.4 (10.24.15)
      - Added support for the 2 new weapons from the Lowriders DLC
      - Added support for the flashlight from the Halloween DLC
      - Code Improvements

    Version 2.3 (07.24.15)
      - Added support for 2 new weapons from Ill-Gotten Gains Part 2
      - Code Improvements

    Version 2.2 (06.12.15)
      - Added support for the Combat PDW from Ill-Gotten Gains update

    Version 2.1 (06.06.15)
      - Slightly increased non weapon pickup distances
      - Minor code improvement

    Version 2.0 (05.22.15)
      - Added dropping for baseball
      - Adds pickups for BZ Gas, Fire Extinguisher, Flare, Snowball, and Baseball
      - Decreases pick up range and moved weapon drops closer to player
      - Created optional pickup files without glow (Thanks Drkz [Enhanced Wallets])
      - Minor code improvements

    Version 1.1 (05.16.15)
      - Added animation when dropping
      - Dropped guns now retain clip ammo
      - Thrown weapons now drop one at a time
      - Fixed ammo issue with thrown weapons
      - Added dropping while in vehicles

    Version 1.0 (05.13.15)
      - Initial Release

--------------------------------------------------

  Conflicts:

    Mods that replace any of the pickups.meta
    files. But you can probably merge conflicting
    mods together quite easily, especially if you
    use a program such as 'Beyond Compare'.

    I *might* offer compatibility patches in the
    future for popular mods, or just mods that I
    end up using myself. No promises though.

--------------------------------------------------

  Known Issues:

    There seems to be a limit of 105(?) pickup
    entries. After the April 2016 patch that added
    two new weapons, I found that the game would
    crash on loading unless I removed one entry
    from any pickup.meta file. It doesnt seem to
    matter which entry is removed or from which
    file. So This leads me to believe that there
    is a max number of entries set somewhere. As
    a work around until another solution is found,
    I have removed the baseball pickup data that
    this mod had added. So the baseball might be
    slightly bugged when trying to drop it.

    Weapon Components are not saved, even though
    they will show on the dropped weapons
    (example: silencers)
    
    Picking up a weapon gives you a clip worth of
    ammo in addition to what is in the clip already

    The animation isnt perfect, especially since I
    could only find dropping animations for the left
    hand or both hands, oddly no right hand

    Weapons dont always appear to be dropped outside
    vehicle windows, sometimes they go through the
    floor instead

--------------------------------------------------

  Configuration:
    
    Edit this value in the 'Configuration' section near the top of the WeaponDrop.lua file to change the key used:
    
      local Drop_Key = Keys.F9  -- Press this key to drop your weapon (default: Keys.F9)

--------------------------------------------------
--------------------------------------------------




--------------------------------------------------
--------------------------------------------------
 * please do not upload my mods to other sites! *
--------------------------------------------------
--------------------------------------------------