Installation

Prérequis

• Un serveur FiveM (FXServer) fonctionnel
• Accès au dossier resources/ de votre serveur
• (Optionnel) Un bot Discord si vous voulez les patchnotes automatiques — voir Patchnotes Discord

Étapes

1. Placer la resource

Copiez le dossier du script dans resources/ de votre serveur, par exemple :

resources/[loading]/loading_screen_script/

WARNING

Le nom du dossier ne doit pas contenir d'espaces ni de caractères spéciaux.

2. Démarrer la resource

Ajoutez la ligne suivante à votre server.cfg :

ensure loading_screen_script

Remplacez loading_screen_script par le nom exact de votre dossier.

3. Activer les requêtes HTTP (pour Discord)

Si vous utilisez les patchnotes Discord, le serveur a besoin de faire des requêtes sortantes. C'est activé par défaut sur FXServer, mais assurez-vous que rien ne le bloque (pare-feu, proxy). Voir Patchnotes Discord.

4. Configurer le contenu

Ouvrez config/config.js et personnalisez :

• le logo du serveur
• la couleur du thème
• les musiques
• les sections (règles, galerie, équipe, news)
• les liens réseaux sociaux

Voir Configuration générale.

5. Ajouter vos médias

Déposez vos fichiers dans les dossiers prévus :

Type	Dossier	Formats
Logo serveur	config/server_logo/	.png .jpg .jpeg
Musiques	config/song/	.mp3
Images galerie	config/gallery_image/	.jpg .jpeg .png
Photos équipe	config/team_logos/	.png .jpg .jpeg
Vidéo de fond	config/background_video/	.mp4
Vidéos news	config/news_video/	.mp4

IMPORTANT

Tant que vous utilisez les dossiers et formats listés ci-dessus, vous n'avez rien d'autre à faire — ils sont déjà pris en charge. Ce n'est que pour un format inhabituel (ex. .webp) qu'il faudrait l'ajouter au bloc files {} du fxmanifest.lua.

6. Redémarrer

Redémarrez votre serveur (ou restart loading_screen_script) et connectez-vous pour voir le résultat.

Vérifier que tout fonctionne

• Le loading screen s'affiche à la connexion.
• La musique démarre (cliquez si l'autoplay est bloqué par le navigateur).
• Les sections apparaissent dans la barre de navigation à gauche.
• Si Discord est configuré, la section UPDATE affiche les patchnotes.

TIP

En cas de souci, activez le mode debug (debug: true dans config.js et Debug = true dans discord.lua) puis consultez la console : F8 en jeu pour le NUI, la console FXServer pour le serveur.