Configuration

Version Française

[!info] Cette page documente uniquement les paramètres présents dans les fichiers de configuration de MX MDT. Aucun paramètre externe ou inventé n'est inclus.

[!warning] Ne publiez jamais vos tokens Discord, clés API FiveManage ou webhooks Discord dans une documentation publique. Utilisez toujours des placeholders dans les exemples.

---

Fichiers de configuration analysés

---

Configuration globale

Config.Locale

luaCopier
Config.Locale = "fr"
MDTConfig.Locale = MDTConfig.Locale or Config.Locale

---

MDTConfig.Resources

luaCopier
MDTConfig.Resources = {
    Inventory  = "origen_inventory",
    Target     = "ox_target",
    Gizmo      = "object_gizmo",
    Screenshot = "screenshot-basic",
    Phone      = "qs-smartphone",
}

[!tip] Modifier MDTConfig.Resources permet de changer une ressource à un seul endroit, puis de la réutiliser automatiquement dans plusieurs modules.

---

Commandes et touches

MDTConfig.Client.Commands

luaCopier
MDTConfig.Client.Commands = {
    OpenMDT = "mdt",
    Panic = "mdtpanic",
    BackupMenu = "mdtbackup",
    PlaceSpikestrip = "mdtplacestrip",
    MegaphoneVehicle = "+megaphone_veh",
    AnprLockFront = "mdtanprlockfront",
    AnprLockRear = "mdtanprlockrear",
    AnprMove = "mdtanprmove",
    AnprSpeed = "mdtanprspeed",
}

---

MDTConfig.Client.Keys

luaCopier
MDTConfig.Client.Keys = {
    OpenMDT = "F2",
    Panic = "F10",
    BackupMenu = "F5",
    PlaceSpikestrip = "H",
    MegaphoneVehicle = "G",
    AnprLockFront = "LBRACKET",
    AnprLockRear = "RBRACKET",
    AnprMove = "",
}

[!warning] BackupMenu est présent dans la configuration, mais aucune utilisation active n'a été trouvée dans le script actuel.

---

Item requis pour ouvrir le MDT

MDTConfig.Client.RequiredItem

luaCopier
MDTConfig.Client.RequiredItem = {
    Enabled = true,
    Item = "mdt_tablet",
    Provider = MDTConfig.Resources.Inventory,

    CheckFn = function(itemName)
        return true
    end
}

[!danger] Si un provider inconnu est utilisé, le contrôle d'item peut ne pas bloquer l'ouverture du MDT. Utilisez un provider supporté ou une fonction CheckFn personnalisée.

---

Tablette MDT

MDTConfig.Client.Tablet

luaCopier
MDTConfig.Client.Tablet = {
    Enabled = true,
    Dict = "amb@world_human_seat_wall_tablet@female@base",
    Anim = "base",
    Model = `prop_cs_tablet`,
    Bone = 28422,
    Offset = vector3(-0.05, 0.0, 0.03),
    Rotation = vector3(20.0, -90.0, 0.0),
}

---

Notifications

MDTConfig.Client.Notifications

luaCopier
MDTConfig.Client.Notifications = {
    Provider = "esx_notify",
    ResourceName = "notify",
    CustomEvent = "",

    Exports = {
        Notify = function(data)
            -- data.title
            -- data.description
            -- data.type
            -- data.duration
        end
    }
}

MDTConfig.Server.Notifications

luaCopier
MDTConfig.Server.Notifications = {
    Provider = "esx_notify",
    ResourceName = "",
    CustomEvent = "",

    Exports = {
        Notify = function(source, data)
            TriggerClientEvent("mdt:notify", source, data)
        end
    }
}

---

Téléphone

MDTConfig.Client.ExternalResources.Phone

luaCopier
MDTConfig.Client.ExternalResources.Phone = {
    Enabled = true,
    Provider = MDTConfig.Resources.Phone,
    ResourceName = MDTConfig.Resources.Phone,
}

MDTConfig.Server.ExternalResources.Phone

luaCopier
MDTConfig.Server.ExternalResources.Phone = {
    Enabled = true,
    Provider = MDTConfig.Resources.Phone,
    ResourceName = MDTConfig.Resources.Phone,
}

---

Voice et mégaphone

MDTConfig.Client.ExternalResources.Voice

luaCopier
MDTConfig.Client.ExternalResources.Voice = {
    Enabled = true,
    ResourceName = "pma-voice",
}

MDTConfig.Megaphone

luaCopier
MDTConfig.Megaphone = {
    Vehicle = {
        Enabled = true,
        ToggleKey = "G",
    },

    Handheld = {
        Enabled = true,
        WeaponHash = `WEAPON_MEGAPHONE`,

        InventoryItem = {
            Enabled = true,
            Resource = MDTConfig.Resources.Inventory,
            ItemName = "megaphone",
        }
    },

    Volume = 1.0,

    Effects = {
        FreqLow = 200.0,
        FreqHi = 9000.0,
    }
}

[!warning] MDTConfig.Megaphone.Volume est défini dans la configuration, mais aucune utilisation active n'a été trouvée dans le code actuel.

---

Target

MDTConfig.Client.ExternalResources.Target

luaCopier
MDTConfig.Client.ExternalResources.Target = {
    Enabled = true,
    Provider = MDTConfig.Resources.Target,

    CustomAddModel = nil,
    CustomRemoveModel = nil,
}

---

Dispatch

MDTConfig.Dispatch.Client.BlipStyles

luaCopier
MDTConfig.Dispatch.Client.BlipStyles = {
    {
        key = "code99",
        matchCode = "99",
        sprite = 161,
        colour = 1,
        scale = 1.05,
        flash = true,
        radius = 90.0,
        radiusAlpha = 120,
        label = "Code 99"
    }
}

MDTConfig.Dispatch.Client.BlipDefaultStyle

luaCopier
MDTConfig.Dispatch.Client.BlipDefaultStyle = {
    sprite = 161,
    colour = 3,
    highPriorityColour = 1,
    priorityThreshold = 3,
    scale = 0.85,
    flash = false,
    highPriorityFlash = true,
    flashIntervalMs = 500,
    radius = 55.0,
    radiusAlpha = 90,
    label = "Dispatch - Intervention",
}

MDTConfig.Dispatch.Client.AgentBlips

luaCopier
MDTConfig.Dispatch.Client.AgentBlips = {
    ScaleInVehicle = 0.95,
    ScaleOnFoot = 0.78,
    Display = 2,
    Category = 7,
    SpriteInVehicle = 56,
    SpriteOnFoot = 1,
    Colours = {
        waiting = 17,
        danger = 1,
        pause = 5,
        patrol = 3,
        default = 0,
    }
}

MDTConfig.Dispatch.Client.Timers

luaCopier
MDTConfig.Dispatch.Client.Timers = {
    GunshotLocalCooldownMs = 1500,
    GunshotLoopShootingMs = 150,
    GunshotLoopArmedMs = 100,
    GunshotLoopIdleMs = 500,
    PositionUpdateIntervalMs = 3000,
    PositionUpdateLoopMs = 500,
    PanicCooldownMs = 8000,
}

MDTConfig.Dispatch.Server.GunshotCooldownMs

---

Caméras

MDTConfig.AllowedVehicleModels

luaCopier
MDTConfig.AllowedVehicleModels = {
    [`police`] = true,
    [`police2`] = true,
    [`police3`] = true,
}

MDTConfig.Cameras

luaCopier
MDTConfig.Cameras = {
    RefreshIntervalMs = 1500,
    AllowedVehicleModels = MDTConfig.AllowedVehicleModels,
    KeyLockFrontLabel = "T",
    KeyLockRearLabel = "Y",

    StaticCameras = {
        {
            id = "mission_row_entrance",
            label = "Mission Row - Entrée",
            department_id = nil,
            coords = vector3(441.2, -981.9, 30.7),
            rot = vector3(-15.0, 0.0, 90.0),
            fov = 70.0,
        }
    }
}

[!info] department_id = nil rend une caméra accessible à tous les départements autorisés. Un ID numérique permet de la limiter à un département précis.

[!warning] Bodycam.AttachRot et Bodycam.VehicleRot sont présents dans la configuration, mais les rotations sont actuellement hardcodées dans le code caméra.

---

ANPR

MDTConfig.ANPR

luaCopier
MDTConfig.ANPR = {
    DetectionDistance = 28.0,
    DotProductThreshold = 0.55,
    SpeedMultiplier = 2.237,
}

[!warning] Les valeurs ANPR sont définies dans la configuration, mais ne sont pas encore appliquées dynamiquement par le code actuel.

---

Herses

MDTConfig.Spikestrips

luaCopier
MDTConfig.Spikestrips = {
    Enabled = true,
    MaxStrips = 3,
    AutoDeleteMinutes = 30,
    RemoveOnDisconnect = false,
    PlaceKey = "H",
    BurstNPC = true,
}

---

Authentification

MDTConfig.Auth

luaCopier
MDTConfig.Auth = {
    Provider = "discord",
    AllowDiscordLogin = true,
    RequireDiscordIdentifier = false,
    DefaultAvatar = "https://cdn.discordapp.com/embed/avatars/0.png",
}

[!warning] RequireDiscordIdentifier = false ne désactive pas réellement la dépendance Discord dans le flux de connexion actuel.

---

Discord

MDTConfig.Discord

luaCopier
MDTConfig.Discord = {
    Enabled = true,
    BotToken = GetConvar("mdt_discord_bot_token", "YOUR_DISCORD_BOT_TOKEN"),
    GuildIds = { "YOUR_GUILD_ID" },
    RoleSyncEnabled = true,
    FullResyncEnabled = true,
    FullResyncIntervalMs = 15 * 60 * 1000,
}

MDTConfig.StaffRoleId = GetConvar("mdt_staff_role_id", "YOUR_STAFF_ROLE_ID")

Convars recommandées

cfgCopier
set mdt_discord_bot_token "YOUR_DISCORD_BOT_TOKEN"
set mdt_discord_guild_ids "123456789012345678,987654321098765432"
set mdt_staff_role_id "123456789012345678"

[!danger] La configuration actuelle contient des valeurs sensibles. En production, déplacez toujours les tokens, clés API et IDs privés dans des convars serveur.

---

Base de données

MDTConfig.Server.ExternalResources.Database

luaCopier
MDTConfig.Server.ExternalResources.Database = {
    ResourceName = "oxmysql",
}

---

Inventaire serveur

MDTConfig.InventoryExports

luaCopier
MDTConfig.InventoryExports = {
    HasItem = function(src, item, amount)
        return exports[MDTConfig.Resources.Inventory]:HasItem(src, item, amount or 1)
    end
}

---

Upload de fichiers

MDTConfig.Upload

luaCopier
MDTConfig.Upload = {
    Provider = "fivemanage",

    FiveManage = {
        ApiKey = GetConvar("mdt_fivemanage_api_key", "YOUR_FIVEMANAGE_API_KEY"),
        DefaultPath = "mdt/photos",
        UseDepartmentSubfolder = true,
        MaxFileSizeMB = 10,
        AllowedMimeTypes = {
            ["image/png"] = true,
            ["image/jpeg"] = true,
            ["image/jpg"] = true,
            ["image/webp"] = true,
        }
    }
}

cfgCopier
set mdt_fivemanage_api_key "YOUR_FIVEMANAGE_API_KEY"

[!warning] Le commentaire de configuration mentionne lb-upload, mais le code actuel vérifie lbupload. Utilisez fivemanage par défaut ou adaptez le provider dans le code si nécessaire.

---

Logs Discord

MDTConfig.Logs

luaCopier
MDTConfig.Logs = {
    Enabled = true,

    Webhooks = {
        general = "YOUR_DISCORD_WEBHOOK",
        arrests = "YOUR_DISCORD_WEBHOOK",
        cameras = "YOUR_DISCORD_WEBHOOK",
    },

    Colors = {
        general = 0x5865F2,
        arrests = 0x8B0000,
        cameras = 0x1E90FF,
    }
}

Catégories de logs disponibles

[!warning] Les clés fines et doj sont présentes plusieurs fois dans la configuration actuelle. En Lua, la dernière valeur écrase les précédentes.

[!warning] La valeur du webhook gangs contient un espace au début dans la configuration actuelle. Cela peut rendre l'URL invalide.

---

Véhicules

MDTConfig.Vehicles

luaCopier
MDTConfig.Vehicles = {
    Source = "esx",

    ESX = {
        Table = "owned_vehicles",
        PlateColumn = "plate",
        OwnerColumn = "owner",
        ModelJson = "$.model",
    },

    QBCore = {
        Table = "player_vehicles",
        PlateColumn = "plate",
        OwnerColumn = "citizenid",
        ModelJson = "$.model",
    },

    Standalone = {}
}

---

Citoyens

MDTConfig.Citizens

luaCopier
MDTConfig.Citizens = {
    Source = "esx",

    ESX = {
        Table = "users",
        IdentifierCol = "identifier",
        FirstNameCol = "firstname",
        LastNameCol = "lastname",
        BirthDateCol = "dateofbirth",
        GenderCol = "sex",
        GenderIsNumeric = false,
        GenderMap = {
            ["m"] = "Homme",
            ["f"] = "Femme",
        },
        PhoneCol = "phone_number",
        FilterNotNull = "firstname",
        OrderBy = "lastname ASC, firstname ASC",
    }
}

[!warning] MDTConfig.Citizens.Licenses est défini dans la configuration actuelle, mais le module licences lit MDTConfig.Server.Licenses. Les réglages SQL des licences placés sous Citizens.Licenses ne sont donc pas appliqués actuellement.

---

Types de licences

MDTConfig.LicenseTypes

luaCopier
MDTConfig.LicenseTypes = {
    { type = "drive", label = "Permis de conduire", max_points = 12 },
    { type = "drive_bike", label = "Permis moto", max_points = 12 },
    { type = "drive_truck", label = "Permis poids lourd", max_points = 12 },
    { type = "dmv", label = "Code de la route", max_points = 0 },
    { type = "weapon", label = "Permis port d'arme", max_points = 0 },
    { type = "hunting", label = "Permis de chasse", max_points = 0 },
}

---

Props MDT

MDTConfig.Props

luaCopier
MDTConfig.Props = {
    Enabled = true,
    PlaceMode = "item",
    PlaceCommand = "mdtprop",

    Models = {
        {
            model = "ba_prop_battle_club_computer_01",
            label = "Ordinateur",
            item = "ordinateur",
            type = "computer",
        },
        {
            model = "prop_printer_01",
            label = "Imprimante",
            item = "imprimante",
            type = "printer",
        },
    },

    Target = {
        Label = _L("lua.props.target.open_mdt"),
        Icon = "fa-solid fa-computer",
        Distance = 2.0,
    }
}

[!warning] PlaceMode et PlaceCommand sont présents mais aucune utilisation active n'a été trouvée dans le code actuel.

---

Imprimante

MDTConfig.Printer

luaCopier
MDTConfig.Printer = {
    Enabled = true,

    Items = {
        Paper = "paper",
        InkBlack = "ink_black",
        InkColor = "ink_color",
        PrintedDoc = "printed_doc",
    },

    InkUse = {
        BlackWhite = 5,
        Color = 10,
        BlackForColor = 3,
    },

    InkRefill = 100,
    LowInkWarning = 20,
    ScreenshotProvider = "fivemanage",
    ScreenshotResource = MDTConfig.Resources.Screenshot,
}

---

Facturation

MDTConfig.Billing

luaCopier
MDTConfig.Billing = {
    Enabled = true,
    Provider = "okokBilling",

    OkokBilling = {
        Table = "okokbilling",
        InitialStatus = "unpaid",
        Fees = 0,
        PaymentDeadlineDays = 7,
        SyncIntervalSeconds = 60,
    },

    CreateInvoice = function(ctx)
        return nil
    end
}

---

Permissions

Structure générale

luaCopier
MDTConfig.Permissions = {
    CategoryAliases = {},
    Groups = {},
    Definitions = {}
}

CategoryAliases

luaCopier
CategoryAliases = {
    police = { "POLICE", "FEDERAL" },
    medical = { "HEALTH", "SANTE", "MEDICAL", "EMS" },
    doj = { "DOJ" },
}

Groupes de permissions

Champs d'une permission

luaCopier
{
    key = "case_citizens",
    label = _L("permissions.case_citizens"),
    group = "cases",
    categories = { "POLICE", "FEDERAL" },
}

Référence des permissions disponibles

---

Antennes de triangulation

MDT_CELL_TOWERS

luaCopier
MDT_CELL_TOWERS = {
    { x = 100.0, y = 200.0, z = 30.0 },
    { x = 500.0, y = -1200.0, z = 80.0 },
}

[!info] Les coordonnées utilisent l'espace monde GTA. Les trois antennes les plus proches sont utilisées pour générer une estimation de localisation.

---

Exports publics

MDTConfig.ExportReference

luaCopier
MDTConfig.ExportReference = {
    ResourceName = "mx_mdt",
    Client = {},
    Server = {},
    ExternalAssets = {},
}

[!info] Ce fichier est une référence documentaire. L'implémentation réelle des exports se trouve dans les fichiers client, serveur et assets concernés.

---

Paramètres définis mais non appliqués actuellement

---

Exemple de configuration minimale recommandée

luaCopier
Config.Locale = "fr"

MDTConfig.Resources = {
    Inventory  = "ox_inventory",
    Target     = "ox_target",
    Gizmo      = "object_gizmo",
    Screenshot = "screenshot-basic",
    Phone      = "lb-phone",
}

MDTConfig.Client.RequiredItem = {
    Enabled = true,
    Item = "mdt_tablet",
    Provider = MDTConfig.Resources.Inventory,
}

MDTConfig.Vehicles = {
    Source = "esx",
}

MDTConfig.Citizens = {
    Source = "esx",
}

MDTConfig.Upload.Provider = "fivemanage"

cfgCopier
set mdt_discord_bot_token "YOUR_DISCORD_BOT_TOKEN"
set mdt_discord_guild_ids "YOUR_GUILD_ID"
set mdt_staff_role_id "YOUR_STAFF_ROLE_ID"
set mdt_fivemanage_api_key "YOUR_FIVEMANAGE_API_KEY"

[!success] Cette configuration conserve les valeurs sûres du script tout en déplaçant les informations sensibles dans les convars serveur.