# PlayerAnimations

A RagePluginHook plugin for GTA V that lets you play various animations on your character with hotkeys.

## Features

- 11 animation slots bound to configurable hotkeys
- Kneeling, cop standing, taking a picture, leaning on hood, pointing, knocking, radio chatter, and phone call
- Phone call animation spawns and attaches a phone prop to your hand
- Radio animation plays push/release sound effects
- Press the same key again to stop, or use the stop key to cancel any animation
- Animations auto-cancel when entering a vehicle

## Animations

| Default Key | Animation |
|---|---|
| NumPad 3 | Kneeling |
| NumPad 8 | Cop Standing |
| NumPad 9 | Taking a Picture |
| NumPad 6 | Leaning on Hood |
| NumPad 5 | Medium Car Idle |
| NumPad 4 | Low Car Idle |
| LShift + , | Point Left |
| LShift + . | Point Right |
| NumPad * | Knock Knock |
| NumPad / | Radio Chatter |
| NumPad 1 | Phone Call |
| NumPad 7 | Stop Animation |

## Requirements

- Grand Theft Auto V
- RagePluginHook (RPH)

## Installation

1. Copy `PlayerAnimations.dll` and `PlayerAnimations.ini` into your GTA V `plugins` folder (e.g. `Grand Theft Auto V\plugins\`).
2. Launch GTA V through RagePluginHook.

## Configuration

Edit `PlayerAnimations.ini` in your `plugins` folder to change any hotkey.

## Usage

Press a hotkey to start the animation. Press the same key again to stop it, or press **NumPad 7** to force-stop any active animation.

## Author

Gamecock Tomahawk
