RedM Animation Scene Editor Poggy AnimTool

A RedM animation scene editor for staff on VORP Core, RSG Core and QBCore RedM: chain animations from over 40,000 dictionaries on a timeline, attach props from over 20,000 models with keyframed position and rotation, preview it on your own character, and export a Lua scene your own scripts can play.

What staff get

• An editor inside the game, opened with /animtool. Only people you allow can open it.
• Everything plays on your own character while you work. Players only ever see the scenes you export and play from your own scripts.
• While the editor is open your game time is held at 10:00 so the lighting stays the same. Only you see this.

The animation library

• Search or browse 40,182 animation dictionaries.
• Click a clip to preview it on your character. Double-click it, press +, or drag it onto the timeline to use it.
• Star the clips you use most.

The timeline

• Clips play back to back. Drag to reorder, drag the edges to trim.
• Drag past a clip's own length to hold its last frame.
• Every prop has its own lane with in and out points. Keyframes show as diamonds.
• Loop, auto-key and snap switches, and zoom and fit.

Props and keyframes

• Attach a prop to one of 59 bones on your character, or to another prop, and set its scale.
• Pose it with sliders. With keyframes present, the sliders edit the keyframe under the playhead.
• Auto-key makes a keyframe wherever you pose, and K keys the current pose.
• Undo and redo, copy a pose and paste it as a keyframe, duplicate a clip or prop. Press ? for every shortcut.

Projects

• Save and open projects. They are stored on each staff member's own PC, not on the server.
• Export and import project JSON to share work with your team.
• Unsaved work is kept and offered back the next time you open the tool.

Export a scene and play it in your own scripts

• Export → Scene (Lua) gives you a scene table to paste into your resource.
• Ship the bundled runtime, scene_player.lua, with that resource. The export dialog hands it to you, and it is readable source.
• ScenePlayer.playOnce(PlayerPedId(), scene) plays it once and cleans up the props.
• ScenePlayer.new gives you play, pause, seek, stop, speed, loop and a finish callback. destroy() stops the animation and deletes its props.
• Clips that failed to load are marked skipped and left out of the export.

Commands

Give access in server.cfg, for example add_ace group.admin command.animtool allow. Admins who already have the ACE command have access. There are no other settings.

What you need to run it

• poggy_core 0.27.0 or newer (free).
• VORP Core, RSG Core or QBCore RedM. AnimTool calls no framework functions.
• No database tables and no config file.
• client/scene_player.lua is open so you can ship it in your own resources. The editor is protected by Cfx escrow.

The RedM animations guide explains dictionaries, clips, scenarios and props on bones.

Updates

poggy_core checks for new versions of AnimTool and installs them for you.