> For the complete documentation index, see [llms.txt](https://code-after-sex.gitbook.io/script-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://code-after-sex.gitbook.io/script-documentation/cas-animation-menu/cas-animation-menu.md).

# CAS Animation Menu

An animation menu for **RedM** (`cas-animationmenu`) with an optional radial-menu integration for quick favourites.

## Highlights

* Browse and play animations from a clean menu
* Optional radial-menu integration (e.g. `cas-radialmenu`)
* Lightweight and plug-and-play

## At a glance

|               |                                                           |
| ------------- | --------------------------------------------------------- |
| Platform      | RedM                                                      |
| Dependency    | [cas\_fwlibs](https://github.com/codeaftersex/cas_fwlibs) |
| Resource name | `cas-animationmenu`                                       |
| Optional      | A radial menu (e.g. `cas-radialmenu`)                     |

## Installation

1. Install [cas\_fwlibs](https://github.com/codeaftersex/cas_fwlibs).
2. Download from Keymaster, extract, and move the folder into `resources`.
3. Add to `server.cfg`:

```cfg
ensure cas-animationmenu
```

4. Restart your server.

## Radial menu integration (optional)

Add this to the **bottom** of your radial menu's `config.lua` so the animation menu can find a free index:

```lua
exports("getAvailableIndex", function()
    return #Config.MenuItems
end)
```

Then configure the integration block:

```lua
if Config.USERADIALMENU then
    RADIALMENU = {}
    RADIALMENU.CategoryData = { id = "favanims", title = "Quick Animations", icon = "face-smile", items = {} }
    RADIALMENU.AnimIcon = "person-dress"
    RADIALMENU.YourRadialScript = "cas-radialmenu"
    RADIALMENU.CategoryId = "favanims"
    RADIALMENU.CloseAfterUsingBtn = true
    RADIALMENU.addOption = function(data, index) exports["cas-radialmenu"]:AddOption(data, index) end
    RADIALMENU.removeOption = function(id) exports[RADIALMENU.YourRadialScript]:RemoveOption(id) end
end
```

Make sure your radial menu **starts before** the animation menu in `server.cfg`, apply the same logic in `radialmenuConfig.lua`, and restart. If you use a different radial menu, replace `cas-radialmenu` with its resource name.

## Support

Join the [CAS Discord](https://discord.gg/X8bTK9Stwk) or use the support channel on your product page.