Personnalisation

Note

💬 Besoin d’aide ? Le support, les mises à jour et les changelogs sont sur le Discord de Mic Scripts. Ouvrez un ticket avec votre ID de transaction Tebex et l’erreur console.

Les paramètres se trouvent dans config.lua. Les deux fichiers du bridge sont ouverts afin que vous puissiez adapter la partie framework. La tablette elle-même est en pur HTML dans html/.

---

Quel fichier décide de quoi

Fichier	Ce qu’il contrôle	Ouvert ?
config.lua	Langue, framework, photos, commande du créateur, grille en direct, qui peut utiliser la tablette et props des caméras	Oui
bridge/client_bridge.lua	Détection du framework, métier du joueur, notifications et message d’aide textuel	Oui
bridge/server_bridge.lua	Détection du framework, identifiants, métiers, items utilisables, ajout et retrait d’items, notifications serveur	Oui
items/	Définitions des items pour ox, qb et ESX, et icônes dans items/images/	Oui
html/	La tablette : index.html, app.js, app.css, la carte (map.js, map.css) et ses tuiles dans html/tiles/	Sans escrow
locales/*.lua	Tous les textes, en jeu et sur la tablette	Sous escrow dans cette version
client/, server/	Le script	Sous escrow

---

Général — config.lua

Option	Ce qu’elle fait	Valeur par défaut
Config.Locale	Langue utilisée	'en'
Config.Framework	esx, qbcore ou auto pour la détection automatique. Sur QBox, auto le détecte comme qbcore via sa compatibilité QBCore ; pour le forcer, utilisez qbcore	'auto'
Config.EvidenceEnabled	Active ou désactive les photos. Désactivé, Espace dans une caméra et la capture de la grille ne font rien	true
Config.CreatorCommand	Commande ouvrant le créateur administrateur	'camcreator'
Config.CreatorAce	Permission ACE requise pour le créateur	'mic_cctvcreator.open'
Config.LiveGridFPS	Nombre de rafraîchissements par seconde de la grille. De 1 à 15 ; plus élevé est plus fluide mais plus lourd	5
Config.BlackScreenBehindUI	Affiche un fond noir derrière la tablette pour masquer les sauts entre caméras pendant le rafraîchissement de la grille	true
Config.AllowedJobs	Métiers autorisés à ouvrir la tablette. Vide autorise tout le monde. Voir ci-dessous	{}
Config.SpawnDistance	Distance d’apparition du prop d’une caméra	60.0
Config.BreakableCamera	Détermine si les caméras peuvent être détruites	true
Config.RepairDistance	Portée du laser de réparation	20.0
Config.RepairTime	Durée d’une réparation, en millisecondes	5000

---

Qui voit quelle caméra

C’est la partie à définir avant que quiconque ne pose une caméra.

Config.AllowedJobs vide (par défaut)

• Quiconque possède une cctv_tablet peut l’ouvrir.
• Une caméra placée par un joueur est privée : lui seul la voit.
• Le propriétaire peut ensuite la partager avec son métier — elle devient une caméra de métier pour tous les membres de ce métier — ou lui attribuer un nom d’accès et un mot de passe. Quiconque saisit ces identifiants sur sa tablette y ajoute la caméra.

Config.AllowedJobs configuré, par exemple police et sheriff

• Seuls ces métiers peuvent ouvrir la tablette ; toute autre personne est informée qu’elle n’est pas autorisée.
• Une caméra placée par un joueur devient une caméra de métier pour le métier qu’il exerce à ce moment-là.

Caméras issues du créateur administrateur

Toujours des caméras de métier, visibles par tous les métiers cochés dans le créateur. Une caméra créée sans aucun métier coché ne sera visible par personne.

Preuves et journaux

• Une photo prise depuis une caméra privée reste privée pour la personne qui l’a prise. Une photo prise depuis une caméra de métier appartient au métier. Les deux peuvent être partagées avec votre métier depuis la galerie.
• Les journaux d’intrusion s’affichent pour chaque caméra à laquelle vous avez accès — les 30 plus récents. Réparer une caméra efface son journal.

Retirer une caméra

Le propriétaire peut retirer sa caméra depuis la tablette et récupère l’item.

---

Détruire et réparer

Avec Config.BreakableCamera activé, une caméra se retrouve hors service lorsqu’une balle atterrit à moins d’un mètre environ, ou lorsqu’elle est touchée par une attaque de mêlée, une explosion ou un véhicule. Le créateur permet de désigner des caméras spécifiques comme indestructibles.

Le kit de réparation, cctv_repair, allume un laser. Pointez-le vers une caméra cassée à portée de Config.RepairDistance, appuyez sur E, puis patientez Config.RepairTime. Le kit n’est pas consommé. Retour arrière ou Échap permet de le ranger.

---

Contrôles

Placer une caméra (depuis un item)

Touche	Action
Regarder autour	Déplace l’aperçu sur la surface visée
Molette de la souris	Fait pivoter
E	Place la caméra ; un nom vous est demandé
Clic droit / Échap	Annule

Regarder à travers une caméra

Touche	Action
W / S	Incliner vers le haut et le bas
A / D	Tourner. Les caméras murales et sur poteau s’arrêtent à 45° ; les modèles 360° tournent complètement
Molette de la souris	Zoomer
Entrée	Basculer entre vision normale, nocturne et thermique
Espace	Prendre une photo pour la galerie de preuves
Retour arrière / Échap	Revenir à la tablette

Le créateur administrateur (/camcreator)

Choisissez un modèle (mur, mur 360, poteau, poteau 360), un nom de base, les métiers autorisés et si la caméra peut être détruite, puis passez en mode placement :

Touche	Action
← / →	Changer de modèle
Molette de la souris	Faire pivoter
E	Placer ; un nom vous est demandé
Clic droit / Échap	Revenir au menu du créateur

---

Commandes et permissions

Commande	Qui	Ce qu’elle fait
/camcreator	Joueurs ayant la permission Config.CreatorAce	Ouvre le créateur administrateur. Modifiez le nom via Config.CreatorCommand

Accordez la permission dans server.cfg avec une ligne add_ace pour le groupe de votre choix, par exemple en attribuant mic_cctvcreator.open à group.admin. Si vous modifiez Config.CreatorAce, accordez le nouveau nom à la place.

---

Exports

Côté client, pour les autres ressources qui ont besoin d’interagir avec les caméras :

Export	Arguments	Valeur retournée
GetCameraStatus	id de la caméra	'online', 'broken', ou 'offline' si l’id est inconnu
GetCameraIdFromEntity	handle de l’entité	L’id de caméra du prop généré, ou rien
IsPlacing	—	true tant que le joueur est en train de placer une caméra
HideNearbyCamera	coords	Masque le prop de caméra le plus proche à moins de 2 m et le renvoie
UnhideCamera	prop	Réaffiche un prop masqué avec HideNearbyCamera

---

Langues

Onze langues sont incluses : en, es, fr, de, it, pt, ar, ja, pl, ru, tr. Définissez le code dans Config.Locale. La tablette et les textes en jeu utilisent le même fichier.

Dans cette version, les fichiers de locales/ font partie du code protégé et ne peuvent pas être modifiés directement. Si vous avez besoin d’une autre langue ou d’une formulation différente, demandez sur le Discord.

---

Le bridge

Fichier	Ce qu’il gère
bridge/client_bridge.lua	Détection du framework, Bridge.GetPlayerJob, Bridge.Notify, et Bridge.ShowTextUI / Bridge.HideTextUI pour le message de réparation
bridge/server_bridge.lua	Détection du framework, Bridge.GetPlayerIdentifier, Bridge.GetPlayerJob, Bridge.RegisterUsableItem, Bridge.AddItem, Bridge.AddItemWithMetadata, Bridge.RemoveItem, Bridge.Notify

Autre ressource de notifications : modifiez Bridge.Notify dans les deux fichiers.

Autre interface de texte (ox_lib, okok…) : Bridge.ShowTextUI et Bridge.HideTextUI dans le fichier client. Sur QBCore, ils utilisent le DrawText natif de QBCore ; sinon, le texte d’aide du jeu.

Inventaire : quand ox_inventory est actif, les items sont ajoutés et retirés par son intermédiaire sur les deux frameworks. Sinon, les fonctions propres au framework sont utilisées.

Autre framework : configurez Config.Framework et complétez le bloc de détection ainsi que les fonctions d’identifiant, de métier et d’items dans les deux fichiers. Sans framework, le script utilise par défaut l’identifiant license: et considère tout le monde comme unemployed, mais les items — y compris la tablette — ne sont enregistrés que sur ESX et QBCore (y compris QBox via sa compatibilité QBCore).