Docs Cinematic Intro

Cinematic Intro

Traveling camera shots across Los Santos with a GTA Online-style blips info menu. Press ENTER to spawn.

Free Standalone
Download on Tebex

Features

Cinematic black bars with location name and spawn hint
Slow traveling camera shots across configurable spots
Forced sunny weather at 12:00 during cinematic, restored on spawn
NPC and vehicle density configurable
Looping intro music (MP3 via NUI)
GTA Online-style side menu with PNG blip icons and info cards
Info cards: real photo, cursive title, stats table, lore description
Toggle button to hide/show the blips menu
Mouse interaction enabled during cinematic
ENTER spawns the player and exits the cinematic
RageUI click sound on menu item click
Full locale system: English and French built-in, easily extensible

Installation

1
Drop the skycam folder into your server's resources/ directory
2
Add ensure skycam to your server.cfg
3
Restart your server
The cinematic launches automatically on the playerSpawned event. The player presses ENTER to exit and spawn.

Music

Place your intro music at html/intro-sound.mp3. It loops when the cinematic starts and stops automatically on spawn.

The file must be named intro-sound.mp3, placed in the html/ folder, and must be an .mp3.

Configuration

All settings are in config.lua:

config.lua
Config.TravelingDuration = 18000
Config.SpotDuration      = 20000
Config.PedDensity        = 1.0
Config.VehicleDensity    = 1.0
Config.MusicVolume       = 0.4

Locale / Language

Change the language with one line:

config.lua
Config.Locale = "en"   -- "en" or "fr"

To add a new language, duplicate a locale block in Config.Locales and translate the strings.

Camera Spots

config.lua
{ name = "Spot Name",
  camStart = { coords = vector3(x, y, z), rot = vector3(pitch, roll, yaw) },
  camEnd   = { coords = vector3(x, y, z), rot = vector3(pitch, roll, yaw) },
  fov = 60.0 },
You can use look = vector3(tx, ty, tz) instead of rot to point the camera at a world coordinate.

Blips Menu

config.lua
Config.BlipsMenu = {
    enabled          = true,
    menuWidth        = 262,
    cardWidth        = 295,
    showToggleButton = true,
    menuOpenOnStart  = true,
}

Blips Locations

config.lua
{ id      = "unique_id",
  name    = "Display Name",
  district= "Area, LS",
  blip    = "b-bank",
  bg      = "#001a10",
  icon    = "myicon.png",
  type    = "Business type",
  owner   = "Owner name",
  status  = "open",
  hours   = "09:00 - 18:00",
  desc    = "Lore description.",
  extras  = "Service 1 - Service 2",
  photo   = "filename.jpg" },

Blip Icons (PNG)

Icons are PNG files in html/, declared in fxmanifest.lua. Browse at wiki.rage.mp/wiki/Blips.

FileLocation
unicorn.pngVanilla Unicorn
bahamas.pngBahama Mamas West
tequilala.pngTequi-la-la
yellowjack.pngYellow Jack Inn
thehenhouse.pngThe Hen House
fleecabank.pngFleeca Bank
pacificbank.pngPacific Standard Bank
ammu-nation.pngAmmu-Nation
lossantoscustom.pngLos Santos Customs
lspdmisionrow.pngLSPD Mission Row
fortzancudo.pngFort Zancudo
fib.pngFIB Headquarters
pillboxhill.pngPillbox Hill Medical
ponsonbys.pngPonsonbys
suburban.pngSub Urban
binco.pngBinco
lossantosgolfclub.pngLos Santos Golf Club
humanelabs.pngHumane Labs and Research
tattoparlor.pngTattoo Parlor
herrkurtzbarber.pngHerr Kutz Barber

Adding a New Location

1
Place the photo .jpg in html/
2
Place the blip icon .png in html/
3
Declare both in fxmanifest.lua under files {}
4
Add an entry to Config.BlipsLocations in config.lua

File Structure

Structure
skycam/
 fxmanifest.lua
 config.lua
 client.lua
 html/
     index.html
     intro-sound.mp3
     [location photos .jpg]
     [blip icons .png]

Requirements

  • FiveM server (OneSync or legacy)
  • No dependencies
MIT License free to use, modify and redistribute.