Installation

1️⃣ Add Script To Your Resources Folder

  1. Place the saka-loadingscreen folder inside your resources directory:

resources/[your_folder]/saka-loadingscreen
  1. Add this line to your server.cfg (preferably at the top):

ensure saka-loadingscreen
  1. Restart your server.


2️⃣ Requirements

  • FiveM artifact: 5848+ recommended

  • No dependencies

  • Music files must be in .ogg format

  • Video support requires .webm format


3️⃣ Folder Structure

saka-loadingscreen/
├── fxmanifest.lua
├── config/
│   ├── config.lua       # General behavior (server name, music, etc.)
│   └── theme.lua        # Visual styling & animations
├── client/
│   └── main.lua         # Event-based logic (minimal)
├── locales/
│   └── en.lua           # Language support
├── nui/
│   └── dist/            # UI build output (HTML/CSS/JS/assets)

✅ Testing The Script

After installation:

  • Connect to your server.

  • You should see the custom loading UI.

  • Background images or video should appear.

  • Music should play automatically if enabled.

If the loading screen doesn’t appear:

  • Check F8 Console for NUI errors.

  • Ensure the script is properly started (ensure saka-loadingscreen).

Last updated