Personnalisation
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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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)
Section intitulée « Config.AllowedJobs vide (par défaut) »- Quiconque possède une
cctv_tabletpeut 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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.
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 |
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
Section intitulée « 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).