Skip to main content

Character Selection

Character selection screen with 3D cameras, backgrounds, and poses

This section

Character Selection

Animated 3D character selection screen with customizable backgrounds, camera animations, and character poses.

Backgrounds

3 built-in background scenes with configurable world coordinates:

NameDescription
BeachBeach scene with ocean view
ForestForest environment
CityUrban city setting

Each background defines a world position where the character ped is spawned during selection.

Camera Animations

4 built-in camera animation styles:

IDNameDescription
1IdleStatic camera with slight sway
2Slide InCamera slides in from the side
3Slide In LeftCamera slides in from the left
4Slide In RightCamera slides in from the right

Character Poses

3 built-in idle poses with optional props:

NameDescription
NormalStandard standing idle
SmokeSmoking animation with cigarette prop
DanceDancing animation

Loading Screen

While the character data is being prepared, players see a styled loading screen instead of waiting under the map. Configurable via:

  • Config.LoadingTime — how long (ms) the loading screen is shown
  • Config.LoadingLogo — image URL shown inside the spinner (your server logo); leave empty for the default icon

Delete Confirmation

Deleting a character opens a confirmation window that requires typing the character's first name before the Delete button is enabled — accidental one-click deletions are not possible. The delete button can be hidden entirely with Config.DeleteButton = false.

Features

  • Character cards display profile photo, name, nationality, and birth date
  • Dark/light theme toggle with persistent preference
  • Camera zoom controls (zoom in, zoom out, reset)
  • Each player gets a unique routing bucket during selection for isolation
  • /logout command to return to character selection at any time
  • Default camera/background/pose for new characters via Config.DefaultSettings