# ZYRA Loading Screen

A clean, modern loading screen for FiveM. It's fully standalone and works with every framework, with nothing extra to install.

## ✨ Features

- 🎬 **Video background:** drop in your own MP4 and it loops

- 🎵 **Music player:** playlist, cover art, play/pause, next/previous, volume slider and autoplay

- ⌨️ **Keybinds panel:** show players your server keys before they spawn

- 📰 **News carousel:** auto-sliding news cards with images, on the left or right side

- 🌐 **Social links:** Discord, website, Instagram, YouTube, Twitter… click to copy the link

- 👋 **Welcome section:** your logo plus a custom welcome text

- 🔞 **Age rating badge:** optional content rating box

- 🖱️ **Mouse cursor** enabled on the loading screen

## 🔌 Works with every framework

Closes automatically when the player loads in:

- Standalone / spawnmanager

- ESX

- QBCore

- Qbox

- ox_core

- ND_Core

- vRP

A **safety timeout** means players never get stuck on the loading screen. You can also close it yourself from any resource with an **event or export**.

## ⚙️ Easy to configure

- Every text, link, keybind, song and news item is set in **one config file**

- Turn any section on or off with `enabled = true/false`

- Swap the video, music and images by replacing files in the `config/` folder

- Translate everything to your language without touching the code

## 🔒 Escrow

The code is protected. All **config files stay open and editable**.

## 📦 Installation

1. Drag `zyra_loading` into your `resources` folder

2. Add `ensure zyra_loading` to your `server.cfg`

3. Edit `config/config.js` and restart

The README included in the resource covers everything else.