# nova\_loading

NOVA Framework custom loading screen. Replaces the default FiveM loading screen with a custom HTML-based screen.

## Features

* **Custom Design** — HTML + CSS loading screen
* **Video/Audio Support** — Background video and music
* **Auto Shutdown** — Automatically closes when the session starts

## How It Works

The loading screen is defined as a `loadscreen` resource in the fxmanifest:

```lua
loadscreen 'html/index.html'
loadscreen_manual_shutdown 'yes'
loadscreen_cursor 'yes'
```

The client script waits for the game session to start, then calls `ShutdownLoadingScreenNui()` to close the loading screen and transition to gameplay.

## Customization

### HTML

Edit `html/index.html` to change the loading screen layout:

* Logo/branding
* Loading progress text
* Background effects

### Video

Replace the background video file in the `html/` directory with your own. Supported formats: MP4, WebM.

### Audio

Add background music to play during loading. Audio stops when the loading screen closes.

### CSS

Edit `html/style.css` to customize colors, fonts, animations, and layout.

## Dependencies

* None — This is a standalone resource

## Configuration

No `config.lua` is needed. All customization is done through the HTML/CSS files.

## Notes

* The loading screen uses `loadscreen_manual_shutdown 'yes'` so it stays visible until the client script explicitly closes it
* The cursor is enabled during loading (`loadscreen_cursor 'yes'`)
* The screen closes when `NetworkIsSessionStarted()` returns true and the player has spawned
* Keep video files optimized (compressed) to reduce load times