🎞️ RedM Animation Viewer
A simple and standalone animation testing tool for **RedM**. This script lets you quickly preview any animation from resources like [Mooshe.tv](https://rdr2.mooshe.tv/animations/), just by copying the animation name and running a single command.
---
## ✅ Features
- No dependencies (fully standalone)
- Instant animation preview with a simple command
- Client-side console logs (F8) for tracking played animations
- Error handling if animation dictionary fails to load
- `/clearanim` command to stop the animation
---
## 🔧 Installation
1. Download or clone this repository into your `resources` folder:
```
resources/[standalone]/anim_viewer
```
2. Add this line to your `server.cfg`:
```
ensure heros_visualizer
```
---
## 🕹️ Usage
### ▶️ Play an animation
In the **client chat**, type:
```
/playanim animDict animName
```
**Example:**
```
/playanim mech_inventory@eating@multi_bite@sphere_d8-2_sandwich quick_left_hand_rifle
```
> ✅ You can copy-paste directly from [https://rdr2.mooshe.tv/animations/](https://rdr2.mooshe.tv/animations/)
### ⛔ Stop current animation
```
/clearanim
```
---
## 🖥️ Console Output (F8)
The following information is printed in the **client console (F8)**:
- On success:
```
[AnimationViewer] Anim played: "mech_inventory@eating@multi_bite@sphere_d8-2_sandwich quick_left_hand_rifle"
```
- On clear:
```
[AnimationViewer] Animation cleared.
```
- On error:
```
[AnimationViewer] ERROR: Failed to load animation dictionary.
```
---
## 📌 Notes
- Only works on **RedM**.
- This tool is meant for developers or server creators to preview animations during development.
- Does not interfere with gameplay logic or character behavior outside the test session.
---
## 🧑💻 Author
Created by [Heros]
Version: 1.0.0
License: MIT