Installation
Welcome to the Bablo Animation Recorder installation guide! This guide will walk you through the complete installation process for our asset. By following each step carefully, you'll ensure a smooth and hassle-free setup, provided that all instructions are followed thoroughly.
Prerequisites
The Animation Recorder is a paid addon that requires the Bablo Animation Menu (bablo-animations) to be installed and running. It will not function without it.
Before installing, make sure you have the following:
- bablo-animations — installed and working
- yarn — required dependency for the server-side JavaScript runtime
Download Asset
To find the asset, you must have made the purchase using your own cfx account. Otherwise, you can use the transfer system to move the asset to a different cfx account.
After purchasing from our official website (opens in a new tab), the asset will be delivered directly to your CFX Portal (opens in a new tab). From your panel, you can download the asset and proceed with the installation using the provided documentation.
Setup CFG
The start order is important. bablo-animations must be started before bablo-animationrecorder so all animations are loaded and available for the recorder.
We strongly recommend starting bablo-animationrecorder before you join the server. This ensures the custom ped model streams in properly and avoids loading issues.
-- Start your framework core first
ensure es_extended or qb-core or qbx_core
-- Start the animation menu first (required)
ensure bablo-animations
-- Then start the animation recorder addon
ensure bablo-animationrecorderConfiguration
The config.lua file allows you to customize the recorder behavior:
Config.Debug = true -- Enable extra logging
Config.Language = 'en' -- Language setting (en, sv)
Config.PedModel = 'skyltdocka' -- Ped model used for recording
-- Camera settings
Config.CameraOffset = vector3(0.1, 3.5, 0.3)
Config.CameraFov = 55.0
Config.SharedCameraFov = 65.0
-- Expression close-up camera
Config.ExpressionCameraOffset = vector3(0.0, 0.8, 0.6)
Config.ExpressionCameraFov = 30.0
-- Green screen color (RGBA)
Config.GreenScreenColor = { r = 0, g = 255, b = 0, a = 255 }API Key Configuration
The Config.ApiKey is used for the external animation upload API. This key is provided with your purchase. Update it in config.lua:
Config.ApiKey = 'YOUR_API_KEY_HERE'