ai-police
Le travail de police pour les agents en service (menotter, escorter, installer dans un véhicule, fouiller, verbaliser, envoyer en prison et mettre en fourrière), plus des points de service et des alertes de tirs.
ai-police donne aux membres en service de vos métiers de police un menu de métier pour menotter, escorter, installer dans un véhicule et en faire sortir, fouiller, verbaliser, envoyer en prison et mettre en fourrière. Les agents prennent et quittent leur service à des points dans les commissariats, et les tirs de civils envoient une alerte police. Le serveur vérifie chaque action.
Ce qu’il fait en jeu
- Service. Les membres d’un métier de police voient un point Go on or off duty dans chaque commissariat. Seuls les agents en service ont le menu police.
- Menu police. Appuyez sur F6, ou choisissez Police dans le menu radial. Le menu agit sur le joueur le plus proche à moins de 3 m (le véhicule le plus proche à moins de 6 m pour la fourrière) :
- Cuff or uncuff (menotter ou démenotter) : la cible joue une animation de menottes et la plupart des commandes sont bloquées jusqu’à ce qu’elle soit démenottée.
- Escort (escorter) : une cible menottée est attachée à l’agent et marche avec lui. Choisissez-le à nouveau pour la lâcher.
- Put in vehicle (installer dans un véhicule) : une cible menottée s’assoit sur un siège arrière du véhicule le plus proche.
- Take out of vehicle (faire sortir du véhicule) : fait ressortir la cible.
- Search (fouiller) : ouvre l’inventaire de la cible. La cible doit être menottée ou à terre.
- Write a fine (verbaliser) : l’agent saisit un montant (jusqu’à l’amende maximale du panneau). La cible reçoit une facture du métier en service de l’agent et une notification. Une fiche d’amende va au MDT de la police quand il y en a un qui tourne.
- Send to prison (envoyer en prison) : l’agent saisit les minutes. La cible doit être menottée. Le script de prison l’incarcère, elle est démenottée, et une fiche d’arrestation va au MDT.
- Impound the vehicle (mettre le véhicule en fourrière) : le script de garage emmène un véhicule possédé à sa fourrière ; tout autre véhicule est supprimé.
- Alertes de tirs. Quand un joueur qui n’est pas policier tire avec une arme, une alerte Shots fired est envoyée aux agents en service. Au plus une alerte par zone de 150 m toutes les 30 s.
- Blips des commissariats. Chaque commissariat peut afficher un blip sur la carte.
Installation
Installé par la recipe d’AI Core. À la main : ensure ai-police après ensure ai-core. Il nécessite ai-core et OneSync.
- Prison : Send to prison nécessite un script de prison (ai-prison ou un autre pris en charge par AI Core). Sans cela, l’agent voit « No prison is running on this server. »
- Alertes : les alertes de tirs s’affichent via le script d’alerte police qu’utilise AI Core (ai-policealert par défaut).
- Vérifiez que votre métier de police existe dans ai-core (panneau d’administration, Jobs) et qu’il figure dans Police jobs ci-dessous.
Réglages du panneau
Panneau d’administration > Police. Les valeurs par défaut viennent de data/settings.json et data/stations.json.
Onglet Rules
| Réglage | Ce qu’il change | Unité | Défaut |
|---|---|---|---|
| Police jobs | Noms des métiers dont les membres en service agissent comme police. Jusqu’à 10. Si la liste est vide, police est utilisé. | police | |
| Highest fine | L’amende la plus élevée qu’un agent peut écrire. Les amendes sont des factures : la cible les paie plus tard et l’argent va sur le compte du métier. 0-10 000 000. | $ | 50 000 |
| Shot alerts | Les tirs de civils alertent les agents en service via le script d’alerte qu’utilise ai-core. Désactivez-le quand ce script envoie ses propres alertes de tirs. | activé |
Onglet Stations
Un enregistrement par commissariat. Valeurs par défaut : Mission Row Police Department, Sandy Shores Sheriff, Paleto Bay Sheriff.
| Réglage | Ce qu’il change | Défaut pour un nouveau commissariat |
|---|---|---|
| Name | Le nom du commissariat, affiché sur le blip. 1-48 caractères. | vide |
| Duty point | L’endroit où les agents prennent ou quittent leur service. Placez-vous là et utilisez votre position. | 0, 0, 0 |
| Map blip | Affiche le commissariat sur la carte. | activé |
| Blip look | Sprite, couleur et taille du blip (affiché quand Map blip est activé). | sprite 60, couleur 29, taille 0.7 |
Commandes
Aucune.
Raccourcis clavier
Chaque joueur peut les changer dans les réglages des touches de GTA (section FiveM) ; le propriétaire change les valeurs par défaut dans le panneau d’administration (Keybinds).
| Touche par défaut | Ce qu’elle fait |
|---|---|
| F6 | Ouvrir le menu police (police_menu). Fonctionne uniquement en service, pas en étant menotté ni à terre. |
Le même menu se trouve dans le menu radial sous Police (affiché en service et sans menottes), quel que soit le script de menu radial qui tourne. Les points de service utilisent l’Interaction style d’ai-core (invite avec E, ou une option de ciblage).
Ce qu’il remplace
Pas de fxProvide. Il fait le travail du script de métier de police d’un framework, mais ne répond pas aux exports ni aux events d’un autre script de police.
Scripts compatibles
Tout ce qui sort du travail de police passe par AI Core, donc il peut s’agir de n’importe quel script pris en charge (voir Compatibilité) :
- Les amendes passent par la couche facturation d’AI Core : l’application de facturation de tgiann-phone, okokBillingV3, wasabi_billing, codem-billing, esx_billing, sinon les factures propres à ai-core.
- Les fiches passent par la couche MDT : tgiann-mdt, lb-tablet, ps-mdt, wasabi_mdt (rien n’est écrit quand aucun MDT ne tourne).
- La prison passe par la couche prison : ai-prison, qb-prison, rcore_prison, xt-prison, tgiann-policejob.
- Les alertes passent par la couche dispatch (tout script d’alerte police pris en charge).
- La fouille ouvre l’inventaire via la couche inventaire ; la fourrière passe par la couche garages.
Limites connues
- Seuls les joueurs en ligne sont gérés ; il n’y a ni prison ni amende pour les personnages hors ligne.
- Send to prison accepte jusqu’à 10 000 minutes ; le script de prison peut raccourcir la peine (la Longest sentence d’ai-prison).
- Canaux de logs :
actions(chaque action du menu) etfines.
ai-jobs pour les développeurs
Ce qu’ai-jobs partage avec les autres scripts (il n’a aucun export) : la réputation de hot-dog, les plaques et les clés des véhicules de travail, les motifs de registre et ses events privés.
ai-police pour les développeurs
Le state bag de menottes d’ai-police, comment ses actions atteignent les autres scripts à travers AI Core, et ses events privés.