Disponiblev1.0.2ESX Legacy · Standalone

G-Phone, le smartphone complet

G-Phone est la ressource téléphone de G-Core, compatible ESX Legacy et standalone. Cette section couvre l'installation, la configuration, chaque application et l'API pour les développeurs.

Installer G-Phone Voir les applications

Par où commencer#

Compatibilité#

Installation

L'installation est automatique : tables SQL et objets sont créés au premier démarrage.

Prérequis#

Étapes#

1. Copiez la ressource. Placez le dossier dans resources/ et nommez-le exactement g-phone.
2. Ajoutez-la au server.cfg, après ses dépendances :
   cfgCopier

   ensure oxmysql
   ensure ox_lib          # optionnel
   ensure es_extended     # si ESX
   ensure ox_inventory    # si ox_inventory
   ensure g-phone

3. Démarrez le serveur. Les tables gphone_* sont créées, et les objets sont ajoutés dans la table items (ESX) ou dans ox_inventory/data/items.lua.
4. Redémarrez une fois pour que votre inventaire charge les nouveaux objets.

Installation manuelle des objets#

Pour gérer les objets vous-même, désactivez l'auto-installation :

Config.AutoInstallItems = false

Puis importez install/esx_items.sql (ESX) ou copiez le contenu de install/ox_inventory_items.lua dans les objets d'ox_inventory.

Notes de version

Version actuelle : 1.0.2. Les changements les plus récents sont en haut.

Premiers pas en jeu

Ce que voit un joueur la première fois qu'il sort son téléphone.

1. Obtenir un téléphone. Achetez ou recevez l'objet phone. Un admin peut en donner un avec gphone:give <id>.
2. Ouvrir le téléphone avec K ou /phone.
3. Configurer l'appareil. L'assistant de démarrage se lance au premier allumage. Avec Config.AutoSim = true, une SIM et un numéro au format 555XXXX sont attribués automatiquement.
4. Installer des apps. Les apps de base sont déjà sur l'écran d'accueil. Les autres (réseaux sociaux, jeux, Ryde…) s'installent depuis l'AppStore.
5. Activer le curseur avec Alt gauche pour cliquer dans le téléphone tout en vous déplaçant.

Configuration

Tout se règle dans config.lua, partagé entre le client et le serveur.

Général#

Objets#

Permissions et banque#

Médias, réseau et divers#

Hooks#

Config.IsPhoneBlocked est appelé côté client avant chaque ouverture. Retournez true pour bloquer.

Config.IsPhoneBlocked = function()
    local ped = PlayerPedId()
    if IsEntityDead(ped) or IsPedCuffed(ped) then return true end
    if LocalPlayer.state.isDead or LocalPlayer.state.handcuffed then return true end
    return false
end

Config.SetHudHidden(hidden) est appelé quand le téléphone passe en mode caméra. Par défaut il masque la minimap et déclenche l'événement g-phone:hudHidden pour votre HUD.

Touches

Chaque joueur peut changer ces touches dans Paramètres > Raccourcis clavier > FiveM.

Applications

37 applications sont intégrées. Celles marquées AppStore sont désinstallables et s'installent depuis l'AppStore.

Téléphone

Appels, contacts, favoris, numéros bloqués, messagerie vocale et appels vidéo.

Messages

SMS individuels et de groupe, photos et messages vocaux.

Mail

Boîte mail en @mail.gphone. Vos scripts envoient via l'export sendMail.

Notes

Notes personnelles enregistrées sur le téléphone.

Calendrier

Événements et rappels.

Dictaphone

Mémos vocaux.

Photos

Galerie des photos et vidéos, albums et partage AirShare.

Caméra

Photo, vidéo, selfie et flash.

Options

Fond d'écran, mode avion, éjection de la SIM et réglages du téléphone.

Météo

Météo de la ville.

Calculatrice

Calculatrice.

Horloge

Horloge et alarmes.

Maps

Carte de Los Santos.

AppStore

Installer et désinstaller les apps.

Buckme

Compte bancaire, IBAN et virements. Voir Banque et Wallet.

Maison

Vos logements et leurs portes. À brancher sur votre script.

Garage

Vos véhicules et leur vente.

Services

Appeler et écrire aux entreprises de Config.Companies.

MarketPlaceAppStore

Petites annonces d'achat et de vente.

Ryde meAppStore

VTC : le client fixe son prix, les chauffeurs enchérissent en direct.

MusiqueAppStore

Artistes, albums et morceaux. L'artiste gagne de l'argent par écoute.

NewsAppStore

Articles d'actualité de la ville.

BirdyAppStore

Réseau de messages courts : publications, likes, abonnements.

InstaPicAppStore

Réseau de photos et stories.

SnapmaticAppStore

Photos éphémères, stories et carte des amis.

TrendyAppStore

Rencontres par swipe, réservé aux 18 ans et plus.

DarkChatAppStore

Salons de discussion anonymes.

h4x.appAppStore

Piratage de véhicules et outils. Nécessite un téléphone phone_rooted.

BoostingAppStore

Contrats de véhicules. À brancher sur votre script.

2048AppStore

Fusionnez les tuiles jusqu'à 2048.

SerpentoAppStore

Snake.

PiouAppStore

Volez entre les obstacles.

BlokzAppStore

Placez les blocs, complétez les lignes.

BrikkoAppStore

Casse-briques.

DémineAppStore

Démineur.

EmpiloAppStore

Empilez les blocs le plus haut possible.

MorpionAppStore

Morpion.

Téléphone et carte SIM

Le fonctionnement dépend de votre inventaire : avec ox_inventory, les données suivent l'objet ; sinon, elles suivent le personnage.

Téléphone rooté#

L'objet phone_rooted fonctionne comme un téléphone normal et débloque en plus l'application h4x.app (Hacker).

Zones sans réseau#

Dans une zone de Config.NoPhoneZones, le téléphone ne capte plus. L'événement client gphone:phone:setNoPhoneZone est déclenché à l'entrée et à la sortie.

Config.NoPhoneZones = {
    { coords = vector3(0.0, 0.0, 0.0), radius = 50.0 },
}

Photos, vidéos et vocaux

Par défaut, les fichiers sont stockés sur votre serveur, sans service externe.

Mode local (par défaut)#

Avec provider = "local", les fichiers sont enregistrés dans g-phone/media/ et servis en HTTPS par le proxy cfx.re :

https://<votre-serveur>.users.cfx.re/g-phone/media/...

Sinon, renseignez publicUrl, par exemple derrière un reverse proxy vers le port HTTP de FiveM.

Mode custom#

Avec provider = "custom", le serveur envoie le fichier à votre API, qui doit renvoyer l'URL du fichier.

Config.Upload = {
    provider     = "local",  -- "local" ou "custom"
    publicUrl    = "",       -- vide = automatique via cfx.re
    maxSizeMB    = 8,        -- taille max d'un fichier
    maxPerMinute = 20,       -- envois max par joueur et par minute
    url          = "",       -- "custom" uniquement
    headers      = {},
}

Banque et Wallet

L'application bancaire Buckme s'appuie sur la banque d'ESX ou sur une banque interne.

Chaque compte reçoit un IBAN préfixé par Config.IbanPrefix (GP par défaut). Récupérez-le avec l'export getIban.

Entreprises (Services)

L'app Services liste vos entreprises : les joueurs peuvent les appeler et leur écrire, les employés répondent.

Config.Companies = {
    { job = "police",    label = "LSPD",   number = "911", description = "Police de Los Santos" },
    { job = "ambulance", label = "EMS",    number = "912", description = "Services médicaux d'urgence" },
    { job = "mechanic",  label = "Mécano", number = "913", description = "Dépannage et réparations" },
    { job = "taxi",      label = "Taxi",   number = "914", description = "Transport de personnes" },
}

Pour fermer une entreprise temporairement depuis un autre script :

exports["g-phone"]:setCompanyClosed("police", true)

Commandes

Permissions

Le rang d'un joueur détermine son accès aux outils de modération : 8 pour modérer, 10 pour administrer.

Attribuer un rang#

ESX : le groupe du joueur (xPlayer.getGroup()) est utilisé directement.

Standalone : ajoutez une ACE gphone.<groupe> dans server.cfg. Une ACE group.<groupe> fonctionne aussi.

add_ace group.admin gphone.admin allow
add_ace group.moderator gphone.mod allow

Architecture

Trois couches : l'interface React, les scripts Lua client et serveur, et un pont (bridge/) qui isole tout ce qui dépend du framework, de l'inventaire ou de la base.

Trajet d'une action#

Arborescence#

Ajouter un callback#

-- serveur
GPhone.RegisterServerCallback("monscript:getData", function(src, reply, arg)
    reply({ ok = true, value = arg })
end)

-- client
GPhone.TriggerServerCallback("monscript:getData", function(data)
    print(data.value)
end, "hello")

Exports

Appelez le téléphone depuis vos autres ressources.

Serveur#

getPhoneNumber#

Numéro du téléphone actif d'un joueur, ou nil.

local number = exports["g-phone"]:getPhoneNumber(source)

getSourceFromNumber#

Source du joueur qui possède ce numéro, ou nil.

local src = exports["g-phone"]:getSourceFromNumber("5551234")

sendNotification#

Notification sur un numéro, au nom d'une app ("Messages" par défaut).

exports["g-phone"]:sendNotification("5551234", "Messages", {
    title = "Titre",
    content = "Texte",
})

sendMail#

Envoie un mail à une adresse @mail.gphone.

exports["g-phone"]:sendMail("john@mail.gphone", {
    sender = "banque@mail.gphone",
    subject = "Sujet",
    message = "Texte",
})

getIban#

local iban = exports["g-phone"]:getIban(source)

setCompanyClosed#

exports["g-phone"]:setCompanyClosed("police", true)

usePhone / useSim#

Exports d'utilisation d'objet, appelés par ox_inventory quand un joueur utilise phone ou sim.

Client#

Ces exports affichent des éléments d'interface dans le téléphone ouvert.

exports["g-phone"]:phonePickGallery({ includeVideos = true }, function(media)
    print(media)
end)

Événements

Événements locaux que vos scripts peuvent écouter.

Serveur#

Client#

AddEventHandler("g-phone:hudHidden", function(hidden)
    -- masquez votre HUD ici
end)

Intégrations

Certaines apps attendent votre propre script. Leurs points d'entrée sont dans bridge/server/.

Logements (app Maison)#

Par défaut, aucune propriété. Implémentez ces fonctions dans bridge/server/world.lua :

Contrats (app Boosting)#

Non inclus. Remplacez les callbacks gphone:boosting:* dans bridge/server/world.lua :

Autre framework#

Toutes les fonctions dépendantes du framework sont dans la table Framework de bridge/server/framework.lua. Implémentez-les pour votre framework :

Modifier l'interface

L'interface est écrite en React + TypeScript dans web/ et compilée avec Vite dans web/dist/.

cd web
npm install
npm run build

Où trouver quoi#

Disponiblev1.0.0ESX Legacy · Standalone

G-Pad, la tablette repensée

G-Pad est la tablette de G-Core, compatible ESX Legacy et standalone. Écran 13 pouces en verre dépoli, fenêtres libres, écran partagé, dossiers, notifications et appareil photo. Ressource indépendante : elle n'a pas besoin de G-Phone.

Installer G-Pad Voir les applications

Par où commencer#

Compatibilité#

Installation

Les tables SQL sont créées et l'objet ESX est ajouté automatiquement au premier démarrage.

Prérequis#

Étapes#

1. Copiez la ressource. Placez le dossier dans resources/ et nommez-le exactement g-pad.
2. Ajoutez-la au server.cfg, après ses dépendances :
   cfgCopier

   ensure oxmysql
   ensure es_extended       # si ESX
   ensure ox_inventory      # si ox_inventory
   ensure screenshot-basic  # optionnel : appareil photo
   ensure g-pad

3. Démarrez le serveur. Les tables gpad_settings, gpad_notes, gpad_events et gpad_photos sont créées. Avec l'inventaire ESX, l'objet tablet est ajouté dans la table items et rechargé tout de suite.
4. Donnez-vous une tablette : /giveitem <id> tablet 1, puis utilisez-la depuis l'inventaire.

Objet avec ox_inventory#

Copiez le contenu de install/ox_inventory.lua dans ox_inventory/data/items.lua, et l'image install/tablet.png dans ox_inventory/web/images/.

['tablet'] = {
    label = 'G-Pad',
    weight = 500,
    stack = false,
    close = true,
    client = { export = 'g-pad.useTablet' },
},

Installation manuelle de l'objet (ESX)#

Pour gérer l'objet vous-même, désactivez l'auto-installation puis importez install/esx_items.sql :

Config.AutoInstallItems = false

Premiers pas en jeu

Ce que voit un joueur la première fois qu'il sort sa tablette.

1. Obtenir une tablette. Achetez ou recevez l'objet tablet.
2. Sortir la tablette en utilisant l'objet, avec F2 ou /tablet. Le personnage la prend en main avec une animation. Utiliser l'objet à nouveau la range.
3. Déverrouiller. Glissez vers le haut, ou cliquez. Un code à 4 chiffres se règle dans Réglages.
4. Personnaliser. Fond d'écran, apparence claire ou sombre, coloris de l'appareil, taille du texte et langue se règlent dans l'app Réglages, pour chaque joueur.
5. Ranger la tablette avec Échap ou le bouton Ranger du Centre de contrôle.

Configuration

Tout se règle dans config.lua, partagé entre le client et le serveur.

Général#

Objet#

Tablette#

Appareil photo et objet en main#

Config.Camera règle l'envoi des photos (voir Appareil photo) et Config.PropTextures les textures de l'objet tenu en main (voir Objet en main).

Applications

11 applications intégrées, et 5 widgets pour l'écran d'accueil : Calendrier, Météo, Notes, Horloge et Photos. Les apps marquées Système ne peuvent pas être supprimées.

RéglagesSystème

Wi-Fi, Bluetooth, mode Avion, apparence, luminosité, 12 fonds d'écran, coloris, code d'accès, Ne pas déranger, langue.

Notes

Notes enregistrées en base : recherche, épinglées, suppression.

Calendrier

Vues jour, semaine et mois. Événements avec lieu, couleur et notes.

Horloge

Horloges mondiales, alarmes, chronomètre avec tours et minuteur.

Météo

Calée sur la météo du jeu : prévisions par heure et sur 10 jours.

PhotosSystème

Photothèque par mois, favoris, ajout par lien https, fond d'écran.

Appareil photoSystème

Caméra du jeu à travers l'écran : zoom 0,5× à 5×, selfie, grille.

Plans

Carte GTA (satellite, jeu, atlas), position du joueur, itinéraire vers le GPS.

NavigateurSystème

Onglets, recherche Google, favoris du serveur et signets du joueur.

Calculette

Standard, et scientifique quand la fenêtre est large.

G-StoreSystème

À la une, recherche, fiches détaillées : installer et supprimer les apps.

Gestes et multitâche

La tablette se pilote à la souris comme un écran tactile : clic = toucher, maintenir = appui long, glisser = balayer.

Navigation#

Écran d'accueil#

Écran partagé et fenêtres#

Notifications

Les notifications restent sur l'écran verrouillé jusqu'à ce que le joueur les efface, même si elles arrivent tablette rangée.

Vos autres scripts peuvent envoyer des notifications : voir Exports.

Appareil photo

La caméra du jeu s'affiche à travers l'écran de la tablette. Visée à la souris, zoom de 0,5× à 5×, selfie et grille. Les photos arrivent dans l'app Photos.

Fonctionnement#

1. screenshot-basic capture l'image du jeu (sans l'interface).
2. La photo est envoyée à votre hébergeur d'images, configuré dans Config.Camera.upload.
3. Le lien renvoyé est enregistré dans Photos (table gpad_photos).

Configuration#

Config.Camera = {
    upload = {
        url = "https://api.fivemanage.com/api/image", -- vide = pas d'enregistrement
        field = "image",                              -- champ du fichier
        headers = { Authorization = "VOTRE_CLE_API" },
        responsePath = "url",                         -- lien dans la réponse JSON
    },
    encoding = "jpg",
    quality = 0.9,
    sensitivity = 0.12,                                 -- vitesse de visée
}

Objet en main

Pendant l'utilisation, le personnage tient la tablette avec une animation. Ses textures peuvent être remplacées par le logo G-Core au dos et l'écran de G-Pad en façade.

1. Trouvez les textures d'origine. Ouvrez prop_cs_tablet dans CodeWalker ou OpenIV, onglet Textures.
2. Testez-les en jeu : /gpadtexture <dictionnaire> <texture> <back|screen>.
3. Enregistrez-les dans la config :
   luaCopier

   Config.PropTextures.replace = {
       { dict = "prop_cs_tablet", name = "TEXTURE_DU_DOS", image = "back" },
       { dict = "prop_cs_tablet", name = "TEXTURE_DE_L_ECRAN", image = "screen" },
   }

Exports et événements

Ouvrez la tablette et envoyez des notifications depuis vos autres ressources.

Client#

exports["g-pad"]:notify("calendar", "Réunion LSPD", "Dans 15 minutes · Mission Row")

Serveur#

hasTablet#

true si le joueur a une tablette sur lui (toujours true si l'objet n'est pas obligatoire).

local ok = exports["g-pad"]:hasTablet(source)

Notification depuis le serveur#

TriggerClientEvent("g-pad:notify", source, "notes", "Titre", "Texte")

Ouvrir la tablette d'un joueur#

TriggerClientEvent("g-pad:open", source)

Modifier l'interface

L'interface est dans web/ (React, Vite et TypeScript). FiveM charge uniquement le build compilé dans web/dist/.

cd web
npm install
npm run dev     # aperçu dans le navigateur avec des données de démo : http://localhost:5173
npm run build   # recompile web/dist

En mode dev, des paramètres d'URL ouvrent un état précis : ?unlock&app=notes&windowed&theme=light&lang=en&notifs.

Où trouver quoi#

Disponiblev1.0.0ESX Legacy · Standalone

G-Watch Ultra, la montre connectée

G-Watch est la montre connectée de G-Core, inspirée des montres d'aventure : boîtier titane 49 mm, bouton Action orange, couronne crantée. Cadrans personnalisables, Smart Stack, activité, entraînements, boussole, profondimètre, SOS et sirène. Elle se jumelle au G-Phone, et à n'importe quel autre téléphone.

Installer G-Watch Utiliser un autre téléphone

Par où commencer#

Compatibilité#

Installation

Les tables SQL sont créées et l'objet ESX est ajouté automatiquement au premier démarrage.

Prérequis#

Étapes#

1. Copiez la ressource. Placez le dossier dans resources/ et nommez-le exactement g-watch.
2. Ajoutez-la au server.cfg, après ses dépendances et votre téléphone :
   cfgCopier

   ensure oxmysql
   ensure es_extended   # si ESX
   ensure ox_inventory  # si ox_inventory
   ensure g-phone       # ou votre téléphone (optionnel)
   ensure g-watch

3. Démarrez le serveur. Les tables gwatch_settings, gwatch_activity et gwatch_workouts sont créées. Avec l'inventaire ESX, l'objet gwatch est ajouté dans la table items et rechargé tout de suite.
4. Donnez-vous une montre : /giveitem <id> gwatch 1, puis regardez-la avec F3.

Objet avec ox_inventory#

Copiez le contenu de install/ox_inventory.lua dans ox_inventory/data/items.lua, et l'image install/gwatch.png dans ox_inventory/web/images/.

['gwatch'] = {
    label = 'G-Watch Ultra',
    weight = 100,
    stack = false,
    close = true,
    client = { export = 'g-watch.useWatch' },
},

Installation manuelle de l'objet (ESX)#

Pour gérer l'objet vous-même, désactivez l'auto-installation puis importez install/esx_items.sql :

Config.AutoInstallItems = false

Premiers pas en jeu

Ce que voit un joueur la première fois qu'il regarde sa montre.

1. Obtenir une montre. Achetez ou recevez l'objet gwatch.
2. Regarder la montre avec F3, /watch ou en utilisant l'objet. Le personnage lève le poignet et la montre s'affiche en bas à droite de l'écran.
3. Naviguer. Un clic sur la couronne passe du cadran aux apps. La molette sur la couronne fait défiler. Échap revient en arrière puis range la montre.
4. Personnaliser. Appui long sur le cadran, puis Modifier : couleur, fond d'écran, complications. Boîtier, bracelet, bouton Action et mode nuit se règlent dans l'app Réglages.
5. Montre fermée, les notifications, appels, alarmes et la plongée s'affichent quelques secondes dans un coin de l'écran, sans prendre la souris.

Configuration

Tout se règle dans config.lua, partagé entre le client et le serveur.

Général#

Objet et en jeu#

Sécurité et téléphone#

Applications

17 applications, en grille nid d'abeille ou en liste (Réglages).

Cadrans et fonds d'écran

14 cadrans. Appui long sur le cadran pour ouvrir la galerie, puis Modifier pour changer la couleur, le fond et chaque complication.

Complications#

Date, météo, fréquence cardiaque, activité, pas, altitude, boussole, lever et coucher du soleil, phase de la lune, alarme, chronomètre, minuteur, exercice, messages et profondeur. Toucher une complication ouvre son app.

Ajouter vos fonds d'écran#

Déposez vos images .jpg (format portrait, environ 615 × 753) dans web/public/wallpapers/, ajoutez leur nom dans WALLPAPERS (web/src/system/faces/Faces.tsx) puis recompilez. Les joueurs peuvent aussi coller un lien https dans l'éditeur du cadran.

Boutons et gestes

La montre se manipule comme une vraie : couronne, bouton latéral et bouton Action sont cliquables.

Centre de contrôle#

Silence, Ne pas déranger, lampe torche (éclaire réellement devant le joueur), verrou eau (tourner la couronne pour éjecter l'eau), mode nuit, sirène, luminosité et bouton Ranger.

SOS, chute et sirène

SOS d'urgence#

Bouton latéral maintenu, puis faire glisser « SOS d'urgence ». Les joueurs dont le job est dans Config.SOS.jobs (ESX) ou qui ont l'ACE gwatch.sos (standalone) reçoivent l'alerte et un point GPS clignotant.

# standalone : désigner les secours
add_ace group.ems gwatch.sos allow

Détection de chute#

Après une chute violente (Config.FallDetection.minHealthLoss), la montre sonne et propose « Je vais bien » ou SOS. Sans réponse au bout du compte à rebours, le SOS part tout seul.

Sirène#

Son très aigu à deux tons. Les joueurs proches l'entendent plus ou moins fort selon la distance (Config.Siren.range). Elle s'arrête au bout de Config.Siren.maxDuration secondes.

Téléphone jumelé

La montre affiche les notifications, les appels et les messages du téléphone du joueur. Le téléphone se choisit dans config.lua.

Config.Phone = {
    provider = "auto",          -- "auto", "g-phone", "custom" ou "none"
    gphoneResource = "g-phone", -- si vous avez renommé G-Phone
    ignoredApps = {},             -- apps dont les notifications ne vont pas sur la montre
}

Ce que fait la montre avec G-Phone#

• Notifications du téléphone sur la montre, et dans un coin de l'écran quand elle est fermée.
• Appel entrant avec le nom du contact, décrocher et raccrocher depuis la montre.
• App Messages : conversations, réponses rapides, emojis, clavier, nouveau message à un contact.
• App Téléphone : appels récents.

Utiliser un autre téléphone

G-Watch ne dépend d'aucun téléphone. Avec un autre script de téléphone, branchez la montre en trois étapes, selon ce que vous voulez afficher.

1. Choisir le mode#

Config.Phone = { provider = "custom", ignoredApps = {} }

En "auto", la montre passe aussi en "custom" quand G-Phone n'est pas installé. Mettez "custom" explicitement pour que le téléphone apparaisse comme « Jumelé » même sans l'étape 3.

2. Notifications et appels#

Dans le script de votre téléphone, à l'endroit où il affiche une notification ou un appel, ajoutez l'appel à la montre. Côté serveur, le premier argument est le joueur qui reçoit.

-- Serveur
exports["g-watch"]:phoneNotify(source, { app = "Messages", title = "Franklin", body = "T'es où ?" })
exports["g-watch"]:phoneIncomingCall(source, { callId = 12, number = "5551234", name = "Franklin" })
exports["g-watch"]:phoneCallStarted(source, 12)   -- appel décroché (entrant ou sortant)
exports["g-watch"]:phoneCallEnded(source, 12)     -- appel terminé, refusé ou manqué

-- Client : mêmes exports, sans source
exports["g-watch"]:phoneNotify({ app = "Messages", title = "Franklin", body = "T'es où ?" })

Les notifications dont app vaut Messages ou SMS prennent l'icône Messages, et Phone l'icône Téléphone.

Sans modifier votre téléphone#

Si votre téléphone déclenche ses propres événements, écoutez-les dans bridge/client/phone/custom.lua et transmettez-les à la montre :

RegisterNetEvent("mon-telephone:notification", function(data)
    GW.Phone.notification({ app = data.app, title = data.title, body = data.message })
end)
RegisterNetEvent("mon-telephone:appelEntrant", function(call)
    GW.Phone.incomingCall({ callId = call.id, number = call.number })
end)

Décrocher et raccrocher depuis la montre#

Remplissez answerCall et declineCall dans bridge/client/phone/custom.lua. Par défaut, la montre envoie des événements que votre téléphone peut écouter :

-- Client
AddEventHandler("g-watch:phone:answer", function(callId) --[[ décrocher ]] end)
AddEventHandler("g-watch:phone:decline", function(callId) --[[ raccrocher ]] end)

-- Serveur
AddEventHandler("g-watch:phone:answer", function(src, callId) end)
AddEventHandler("g-watch:phone:decline", function(src, callId) end)

3. Messages, appels récents et contacts#

Remplissez les fonctions de bridge/server/phone/custom.lua avec les requêtes SQL de votre téléphone. Chacune reçoit d'abord src, l'id serveur du joueur. Une fonction laissée vide est simplement absente de la montre : l'app affiche « Non disponible avec votre téléphone ».

Les heures (time) sont en millisecondes. Exemple pour un téléphone qui garde le numéro dans la table users d'ESX :

function Adapter.getNumber(src)
    local xPlayer = GWatch.Framework.player(src)
    if not xPlayer then return nil end
    return MySQL.scalar.await("SELECT phone_number FROM users WHERE identifier = ?", { xPlayer.identifier })
end

Exports et événements

Ouvrez la montre, envoyez des notifications et lisez l'activité depuis vos autres ressources. Exports du téléphone : voir Utiliser un autre téléphone.

Client#

exports["g-watch"]:notify({ app = "activity", title = "Bravo !", body = "Objectif Bouger atteint" })

Serveur#

Ouvrir la montre d'un joueur#

TriggerClientEvent("g-watch:open", source)

Modifier l'interface

L'interface est dans web/ (React, Vite et TypeScript). FiveM charge uniquement le build compilé dans web/dist/.

cd web
npm install
npm run dev     # aperçu dans le navigateur avec des données de démo
npm run build   # recompile web/dist

En mode dev, l'URL ouvre un état précis : #face=wayfinder&route=compass&accent=green&band=trail&caseColor=black. La console expose gwatch.call(), gwatch.fall() et gwatch.notify().

Où trouver quoi#

Bientôt disponiblev1.0.0OneSync · Standalone

G-AntiCheat, l'anti-cheat Sentinel

Bientôt disponibleG-AntiCheat n'est pas encore en vente. Cette documentation vous donne un aperçu de ce qui arrive.

Sentinel protège votre serveur FiveM contre les tricheurs et donne à votre staff les outils pour agir : détections côté client et côté serveur, validation OneSync, preuves par capture d'écran, bans difficiles à contourner, panel en jeu et panel web avec connexion Discord.

Installer G-AntiCheat Voir les détections

Ce qu'il fait#

Deux fichiers de configuration#

Tout se configure dans config.lua, sauf les secrets (webhook, token du bot, connexion Discord du panel web) qui vont dans config_server.lua. La plupart des réglages se modifient aussi en direct depuis le panel, en jeu ou depuis un navigateur.

Par où commencer#

Compatibilité#

Installation

Aucune base de données à préparer : les bans, preuves et réglages sont enregistrés dans les fichiers de la ressource.

Prérequis#

Étapes#

1. Copiez la ressource. Placez le dossier dans resources/ et nommez-le exactement g-anticheat.
2. Ajoutez-la au server.cfg, après screenshot-basic :
   cfgCopier

   ensure screenshot-basic
   ensure g-anticheat

3. Donnez les permissions au staff (détails dans Permissions) :
   cfgCopier

   add_ace group.admin      gcore.anticheat         allow
   add_ace group.superadmin gcore.anticheat.founder allow
   add_ace group.admin      gcore.anticheat.bypass  allow   # jamais analysé ni sanctionné

4. Redémarrez le serveur, puis ouvrez le panel en jeu avec /acpanel. Consultez l'audit de sécurité affiché dans la console.

Réglages généraux

Tout se règle dans config.lua (et config_server.lua pour les secrets). La plupart des réglages se modifient aussi en direct depuis le panel.

Options#

Mode de sécurité#

C.SecurityMode = 'normal'   -- normal | strict | competitive | maintenance | debug

Où se règle quoi#

Permissions

Deux niveaux d'accès : le staff utilise le panel au quotidien, les fondateurs gardent la main sur les actions sensibles.

Staff et fondateurs#

Dans server.cfg :

add_ace group.admin      gcore.anticheat         allow
add_ace group.superadmin gcore.anticheat.founder allow
add_ace group.admin      gcore.anticheat.bypass  allow   # jamais analysé ni sanctionné

Options#

Utiliser les grades de votre core#

Si votre serveur a un core qui gère les grades, renseignez C.CoreResource. L'anti-cheat utilisera alors ses exports, s'ils existent :

• HasPermission, CanBypass, GetPlayerPermissionGroups et HasPermissionGroup pour les droits et les grades ;
• ShowNotification pour les notifications.

Le grade fondateur du core donne aussi le niveau fondateur.

Protection du panel#

C.PanelGuard : chaque action du panel est vérifiée côté serveur.

Whitelist et développeurs

Protégez votre staff des faux positifs, et testez l'anti-cheat sur vous-même sans risque.

Options#

Rôles whitelistés#

Chaque rôle de C.WhitelistPermissions est reconnu de quatre façons. Il suffit qu'une seule corresponde :

Discord

Alertes et captures sur un salon Discord, avatars des joueurs dans le panel et whitelist par rôle Discord.

Configuration#

Dans config.lua :

C.Discord = {
    Enabled = true,
    BotName = 'G-Core Anti-Cheat',
}

Dans config_server.lua (secrets) :

C.Discord.Webhook  = ''   -- URL du webhook (alertes + captures)
C.Discord.BotToken = ''   -- facultatif : avatars Discord dans le panel, rôles whitelistés
C.Discord.GuildId  = ''   -- facultatif : ID de votre serveur Discord (rôles)

Champs#

Détections

52 détections, chacune avec un réglage enabled et une action. Tout se règle aussi dans le panel, onglet Détections : activation, action et seuils.

Sécurité intégrée#

Les détections dites heuristiques ne peuvent jamais bannir automatiquement, même réglées sur ban. Elles restent plafonnées au kick, parce qu'un lag ou un script légitime peut les déclencher :

noclip teleport speedHack vehicleSpeedHack godMode healthHack aimLock aimbotHeadshot silentAim superJump invisibility vehicleFly invincibleFlag freecam deadShooter screenshotBlocked entitySpam resourceStop

Serveur : fiables, impossibles à contourner#

Explosions#

Client : intégrité#

Client : comportement (heuristiques)#

Score de risque

Avec C.Risk, chaque détection ajoute des points au joueur. Quand un palier est franchi, la sanction correspondante peut s'appliquer. Le score redescend tout seul quand le joueur se comporte normalement.

La sanction finale est la plus sévère entre l'action de la détection et celle du palier atteint.

Options#

Bans, ban matériel et anti-évasion

À chaque ban, l'anti-cheat enregistre tous les identifiants du joueur (license, Discord, Steam, FiveM…), ses tokens matériels FiveM et l'empreinte de son appareil. Pour revenir, le joueur devrait tout changer en même temps.

Options#

Empreinte d'appareil#

Un identifiant est caché sur le PC du joueur. Si un banni revient sur le même PC avec un autre compte, il est éjecté dès son arrivée en jeu, et ses nouveaux identifiants sont ajoutés à son ban.

Mémoire des identités#

Les identités des joueurs sont gardées 90 jours dans identities.json. Un ban par identifiant depuis le panel, même sur un joueur hors ligne, bannit donc aussi ses tokens et son appareil.

Audit de sécurité du serveur

Au démarrage, l'anti-cheat vérifie les réglages de sécurité de FiveM dans votre server.cfg. Le résultat s'affiche dans la console et dans le panel (onglet Paramètres), avec la ligne à ajouter pour chaque réglage manquant.

Réglages vérifiés#

# server.cfg : configuration recommandée
set onesync on
set sv_entityLockdown strict
set sv_filterRequestControl 2
set sv_enableNetworkedPhoneExplosions false
set sv_enableNetworkedSounds false
sv_pureLevel 1
set sv_scriptHookAllowed 0

Heartbeat et validation serveur

Le heartbeat vérifie que l'anti-cheat tourne toujours chez le joueur ; la validation serveur lit l'état du joueur directement côté serveur.

Heartbeat#

C.Heartbeat : le serveur envoie un défi au client à intervalle régulier, et le client doit y répondre. S'il ne répond plus, la détection resourceStop se déclenche. Les délais de grâce sont larges pour ne jamais sanctionner un joueur dont le chargement est lent.

Validation serveur#

C.ServerValidation : ces vérifications lisent l'état du joueur côté serveur, toutes les interval ms.

Listes noires

Toutes les listes se modifient en direct dans le panel, onglet Listes.

Filtre /me et /do

C.ChatFilter modère le contenu des commandes RP /me et /do.

• La détection se fait par mot entier et ignore la casse, les accents et le « leet speak » : B1TE est détecté, mais pas habite.
• La sanction se règle avec la détection inappropriateChat.

Options#

Vos autres scripts de chat peuvent utiliser le même filtre avec l'export serveur CheckMessage : voir Exports.

Panel, commandes et exports

Le panel s'ouvre en jeu avec /acpanel, ou une touche à choisir dans Paramètres › Raccourcis clavier › FiveM. Il est aussi accessible depuis un navigateur : voir Panel web.

Onglets du panel#

Commandes#

Exports#

-- client
exports['g-anticheat']:OpenPanel()      -- ouvre le panel (false si accès refusé)
exports['g-anticheat']:ClosePanel()
exports['g-anticheat']:IsPanelOpen()
exports['g-anticheat']:IsFounder()

-- serveur
exports['g-anticheat']:GetConnectionBan(src)              -- carte de ban si le joueur qui se connecte est banni, sinon nil
exports['g-anticheat']:CheckMessage(src, text, channel)   -- passe un texte au filtre ; true = message à bloquer

Panel web

Le panel est aussi accessible depuis un navigateur, sans être en jeu. Même design, mêmes fonctions, connexion avec Discord. C'est votre serveur FiveM qui l'héberge : rien à installer ni à payer en plus.

Adresse#

https://<votre-serveur>.users.cfx.re/g-anticheat/

L'adresse exacte s'affiche dans la console au démarrage. Vous pouvez aussi y accéder depuis la page Panel du site G-Core.

Mise en place (5 minutes)#

1. Créez une application Discord. Sur discord.com/developers/applications, cliquez sur New Application (par exemple « G-AntiCheat Panel »).
2. Copiez les identifiants. Dans OAuth2, copiez le Client ID et le Client Secret, puis collez-les dans config_server.lua.
3. Ajoutez l'URL de redirection. Dans OAuth2 → Redirects, ajoutez l'URL affichée dans la console au démarrage :
   urlCopier

   https://<votre-serveur>.users.cfx.re/g-anticheat/auth/callback

4. Indiquez qui a le droit d'entrer (voir le tableau ci-dessous), puis redémarrez la ressource.

-- config_server.lua
C.WebPanel = {
    enabled        = true,
    ClientId       = '',     -- OAuth2 → Client ID
    ClientSecret   = '',     -- OAuth2 → Client Secret (SECRET)
    PublicUrl      = '',     -- vide = adresse cfx.re détectée automatiquement
    AllowedDiscord = { '123456789012345678' },   -- IDs Discord du staff
    AllowedRoles   = {},     -- ou des IDs de rôles Discord (nécessite BotToken + GuildId)
    FounderDiscord = { '123456789012345678' },   -- IDs Discord des fondateurs
    SessionHours   = 12,     -- durée d'une connexion
}

Qui peut entrer#

Sécurité#

• Chaque action passe par les mêmes contrôles que le panel en jeu : permissions, actions réservées aux fondateurs, limite de débit, journal admin (noté web:<pseudo>).
• La session est stockée dans un cookie protégé, et une connexion dure SessionHours heures.
• Les connexions refusées s'affichent dans la console.

Preuves : captures et live view

Chaque détection est accompagnée d'une capture d'écran, et le staff peut regarder l'écran d'un suspect à la demande. Aucun service externe n'est utilisé.

Captures automatiques#

C.ScreenRec : une capture d'écran du joueur est prise à chaque détection et conservée dans l'onglet Preuves du panel, même après un déban.

Live view#

C.LiveView : le staff peut voir l'écran d'un joueur à la demande, avec /acview <id> [nb] ou le bouton du panel. Les captures arrivent sur Discord et dans l'onglet Preuves.

Écran de bannissement

C.BanScreen règle ce que voit le joueur banni, au moment du ban et quand il essaie de se reconnecter. Tout est modifiable en direct dans le panel (onglet Écran de ban, avec aperçu).

Fichiers de données

Ces fichiers sont créés et mis à jour automatiquement, à la racine de la ressource.