v3.0.0

Documentation Vscript Cinéma

Le système de diffusion vidéo YouTube le plus avancé pour FiveM. Supporte ESX, QBCore et Standalone.

Info: Ce script utilise ox_lib pour une interface moderne et réactive.

🎥 Diffusion Synchronisée

Lecture vidéo fluide et synchronisée pour tous les joueurs ciblés.

🎯 Ciblage Précis

Diffusez à tout le serveur, un rayon spécifique, ou des joueurs individuels.

🛡️ Admin-Proof

Contrôle total pour les admins. Les joueurs ne peuvent pas fermer l'écran sans permission.

🔌 API Complète

Exports client et serveur pour intégrer la vidéo dans vos propres scripts.

Installation

Suivez ces étapes pour installer vscript_cinv3 sur votre serveur.

1. Prérequis

  • Une version récente de FiveM
  • ox_lib (Obligatoire)

2. Installation des fichiers

Déplacez le dossier vscript_cinv3 dans votre dossier resources.

3. Server.cfg

Ajoutez les lignes suivantes à votre fichier de configuration :

Copier
ensure ox_lib
ensure vscript_cinv3
Note: Assurez-vous de démarrer ox_lib AVANT vscript_cinv3.

Commandes & Utilisation

Le script est conçu pour être utilisé principalement via l'interface menu.

Menu Principal

  • Commande : /cinema
  • Raccourci : F7 (Par défaut)

Seuls les administrateurs configurés peuvent accéder à ce menu.

Exports Serveur

Utilisez ces exports dans vos scripts serveur pour automatiser la diffusion.

PlayVideo

Lance une vidéo pour une liste de cibles.

Copier
-- Syntaxe
exports['vscript_cinv3']:PlayVideo(url, targetType, value, volume, source)

-- Exemple : Lancer pour tout le serveur
exports['vscript_cinv3']:PlayVideo('https://youtube.com/watch?v=dQw4w9WgXcQ', 'all', nil, 80)

-- Exemple : Lancer pour un joueur spécifique (ID 1)
exports['vscript_cinv3']:PlayVideo('url...', 'ids', '1', 100)

Exports Client

Exports disponibles côté client.

PlayVideo

Lance la vidéo directement pour le client local.

Copier
exports['vscript_cinv3']:PlayVideo(url, targetType, extraValue, volume)

ExtractYouTubeID

Utilitaire pour extraire l'ID vidéo d'une URL brute.

Copier
local id = exports['vscript_cinv3']:ExtractYouTubeID('https://youtu.be/example')
print(id) -- "example"