tw.witness

Cote : Server + Client

Systeme d'alerte temoin qui diffuse des notifications et des blips temporaires sur la carte aux joueurs ayant des metiers specifiques (ex : forces de l'ordre).

Fonctions

tw.witness.report(jobs, title, message, coords, blipDuration?)

Cote serveur uniquement. Envoie une alerte temoin a tous les joueurs en ligne dont le metier correspond a l'un de la liste.

Parametre	Type	Defaut	Description
jobs	table	—	Tableau de noms de metiers a notifier (ex : {"police", "sheriff"})
title	string	—	Titre de l'alerte
message	string	—	Description de l'alerte
coords	vector3	—	Coordonnees monde pour le blip
blipDuration	integer?	600000 (10 min)	Duree en ms avant la suppression du blip

Comportement client

Le cote client est gere automatiquement. Lorsqu'un signalement est recu :

1. Une notification est affichee au joueur.
2. Un blip temporaire est cree aux coordonnees donnees.
3. Le blip est automatiquement supprime apres blipDuration millisecondes.

Vous n'avez pas besoin d'ecrire de code cote client pour tw.witness.

Exemples

Signaler un crime depuis server.lua

-- Alerter tous les policiers et sherifs a propos d'un braquage
tw.witness.report(
    {"police", "sheriff"},
    "Robbery Reported",
    "A witness saw someone robbing the Valentine store",
    vec3(-301.62, 783.04, 117.75)
)

Duree de blip personnalisee (2 minutes)

tw.witness.report(
    {"police"},
    "Suspicious Activity",
    "A citizen reported suspicious activity near the saloon",
    vec3(2696.72, -1450.12, 45.26),
    120000
)

Notes

• Seuls les joueurs dont le metier actuel correspond a l'une des entrees jobs recevront l'alerte.
• Le blip est automatiquement nettoye apres l'expiration de la duree — aucune suppression manuelle necessaire.
• La duree de blip par defaut est de 10 minutes (600 000 ms).