ai-core
Le framework. Joueurs et personnages, écran des personnages, argent, métiers et gangs, permissions, le panneau d’administration et le pont ESX, QBCore, Qbox et vRP.
ai-core est AI Core lui-même : le framework sur lequel reposent tous les autres scripts. Il sait qui joue, quel personnage a été choisi, combien d’argent il a, à quels métiers et gangs il appartient, et qui est administrateur. Il héberge le panneau d’administration de chaque script, et il permet aux scripts ESX, QBCore, Qbox et vRP de tourner sans modification.
Cette page est une vue d’ensemble. Le panneau d’administration lui-même est décrit sur la page Panneau d’administration.
Joueurs et personnages
- Comptes. Un joueur est identifié par son compte FiveM (l’identifiant
fivem:). Se connecter sans compte est refusé. Les id de licence et Discord sont stockés à côté pour les scripts qui les lisent. - Plusieurs personnages par compte (3 emplacements par défaut). Les joueurs peuvent supprimer des personnages, sauf si vous le désactivez.
- Écran des personnages. Les personnages du joueur se tiennent dans une vraie scène de la ville, chacun dans ses propres vêtements ; la caméra glisse vers celui qui est choisi. Le nom, le sous-titre et le slogan de votre serveur y apparaissent.
- Créer un personnage demande le prénom et le nom, la date de naissance (âge minimum de 18 ans par défaut), le sexe et la nationalité. Un nouveau personnage passe ensuite par le créateur de vêtements (ai-appearance ou un autre script de vêtements).
- Où apparaître. Un nouveau personnage apparaît au point First spawn. En option, après le choix d’un personnage, une liste affiche la dernière position et les lieux que vous avez réglés.
- Enregistrement. L’argent et les appartenances sont enregistrés immédiatement. La position, le gilet et les autres petits changements sont enregistrés toutes les 5 minutes (panneau), à la déconnexion, à l’arrêt de la ressource et à l’arrêt de txAdmin.
- PvP. Un seul interrupteur décide si les joueurs peuvent se blesser entre eux (activé par défaut) ; les administrateurs le basculent en jeu avec
/togglepvp.
Argent
- Comptes Cash (500 au départ), Bank (5000), Dirty money et Crypto par défaut. Vous ajoutez, renommez ou retirez des comptes dans le panneau (Money accounts), chacun avec un montant de départ et la possibilité ou non de passer sous zéro.
- Les métiers et les gangs ont aussi leurs propres comptes (argent de société).
- Chaque changement est écrit avec une ligne de registre : qui, combien, le motif.
Métiers et gangs
- Plusieurs métiers par personnage (3 par défaut, ou un seul quand Several jobs per character est désactivé), et plusieurs gangs (2 par défaut) avec un gang actif.
- Service. Un personnage est en service pour un métier au plus. Le salaire ne vient que du métier en service. Les joueurs commencent hors service après leur connexion, sauf si vous activez Keep duty after rejoining.
- Paie. Toutes les 15 minutes (panneau), les joueurs en service reçoivent le salaire de leur grade sur leur compte bancaire, payé par le serveur ou, si vous le choisissez, par le compte propre du métier.
- Heures de pointe. En dehors des heures d’affluence (18:00 à 01:00 par défaut), les salaires baissent de moitié. Les heures, la réduction et l’interrupteur se trouvent dans le panneau ; un métier peut avoir ses propres heures.
- Les métiers et les gangs eux-mêmes (grades, salaires, grades de patron) sont des enregistrements dans les onglets Jobs et Gangs du panneau.
Permissions
- Les administrateurs sont les joueurs qui ont l’ACE
ai.admin. Lepermission.cfgde la recipe la donne àgroup.admin; ajoutez un joueur avecadd_principal identifier.fivem:<id> group.admin. Sur un nouveau serveur, la carte de bienvenue affiche la ligne exacte. - Les commandes créées avec la lib d’AI Core vérifient les permissions sur le serveur : tout le monde, les administrateurs, ou certaines ACE et certains groupes. L’onglet Commands du panneau liste chaque commande avec qui peut l’utiliser.
- Permissions de métier et de gang. ai-core reflète les appartenances en principals ACE :
ai.job.<name>etai.job.<name>.<grade>(chaque grade jusqu’à celui du joueur), de même pour les gangs. Ainsiadd_ace ai.job.police command.mdt allowdonne une commande à chaque agent.
Panneau d’administration
ai-core héberge le panneau en jeu (F10 ou /aiadmin) pour lui-même et pour chaque script ai-*. Ses propres sections :
| Section | Ce que vous réglez |
|---|---|
| General | Nom du serveur, sous-titre, slogan et arrière-plan ; emplacements de personnages, suppression, âge minimum ; l’intervalle d’enregistrement ; quels scripts d’inventaire, de clés, d’alerte police, de vêtements, de carburant, de serrures, de garage, de notifications, de factures, de banque, de MDT et médical AI Core utilise (Automatic choisit le premier qui tourne) ; interaction par invite ou par ciblage ; PvP ; vérification des mises à jour ; refus des joueurs tant qu’un script inutile tourne ; le guide de configuration. |
| Spawn points | Le premier point d’apparition et les lieux parmi lesquels les joueurs peuvent choisir. |
| Character screen | La scène derrière l’écran des personnages : caméra, heure et météo, les emplacements où se tiennent les personnages. |
| Job and gang rules | Combien de métiers et de gangs, service après reconnexion, la paie, les heures de pointe. |
| Jobs, Gangs | Chaque métier et chaque gang avec ses grades, ses salaires et ses grades de patron. |
| Money accounts | Les types d’argent et ce avec quoi commence un nouveau personnage. |
| Keybinds | Les touches de chaque script : la touche par défaut pour tout le monde et si le HUD l’affiche comme aide. |
| Commands | Chaque commande du serveur avec ses arguments et qui peut l’utiliser. |
| Other panels | Les écrans de réglages d’autres scripts, ouverts depuis le tableau de bord. |
| vRP scripts | Qui reçoit les permissions, groupes et objets que demandent les scripts vRP. |
| Logs | Console, Discord, Fivemanage et FiveM Stats, niveaux, webhooks. |
Il vérifie aussi les mises à jour de chaque script ayant un dépôt GitHub (une fois toutes les 6 heures par script) et recommande sur le tableau de bord des scripts gratuits qui valent la peine d’être installés.
Le pont (ESX, QBCore, Qbox, vRP)
ai-core fait un provide de es_extended, qb-core, qbx_core et vrp, et répond à leurs exports, objets core et events. Les scripts écrits pour ces frameworks voient AI Core comme leur framework : ESX.GetPlayerFromId, QBCore.Functions.GetPlayer, exports.qbx_core:GetPlayer, les appels vRP 1, 2 et 3 fonctionnent tous sur les joueurs, l’argent et les métiers d’AI Core.
Il dessine aussi les ressources d’interface des frameworks avec les menus et les cartes propres à AI Core : esx_context, esx_textui, esx_notify, esx_progressbar, esx_menu_default, esx_menu_dialog, esx_menu_list, qb-menu, qb-input et progressbar. Retirez ces ressources : ai-core répond à leurs noms. Voir Compatibilité.
Couches : un seul endroit pour chaque type de script
Les objets, les clés de véhicule, les alertes police, les vêtements, les morts et réanimations, la prison, le carburant, les serrures, les garages, l’heure et la météo, les factures, la banque, les téléphones, le menu radial, le HUD et les notifications passent tous par ai-core. Un script demande à ai-core (« donne cet objet »), et ai-core appelle le script que vous utilisez pour cette tâche. C’est pourquoi vous pouvez remplacer presque n’importe quel script ai-* par un script tiers, et pourquoi ai-core vous prévient dans la console quand deux scripts pour la même tâche tournent en même temps.
Installation
La recipe txAdmin d’AI Core l’installe. À la main : placez le dossier dans resources/[ai]/ et ajoutez ensure ai-core à server.cfg après ensure ai-mysql et avant tous les autres scripts ai-*. Il nécessite OneSync et la base de données :
add_convar_permission ai-core read mysql_connection_stringSes tables (ai_core_users, ai_core_characters, ai_core_accounts, ai_core_transactions, ai_core_character_jobs, ai_core_character_gangs, ai_core_bills, ai_core_vrp_data) sont créées au premier démarrage. N’installez pas es_extended, qb-core ou qbx_core à côté. Gardez set resources_useSystemChat false.
Commandes
| Commande | Arguments | Qui | Ce qu’elle fait |
|---|---|---|---|
/aiadmin | aucun | administrateurs | Ouvre le panneau d’administration. |
/togglepvp | aucun | administrateurs | Active ou désactive les dégâts entre joueurs (enregistre le réglage du panneau). |
aicore_switch | [id] | administrateurs | Renvoie un joueur (par défaut : vous) à l’écran des personnages. |
aicore_job | <job> <grade> [id] | administrateurs | Donne un métier à un grade. |
aicore_duty | <job | off> [id] | administrateurs | Met un joueur en service dans un métier, ou hors service. |
aicore_money | <account> <amount> [id] | administrateurs | Ajoute à un compte (un montant négatif retire). |
aicore_gang | <gang> <grade> [id] | administrateurs | Donne un gang à un grade. |
aicore_db | [slow] | administrateurs | Statistiques de base de données de chaque ressource dans la console du serveur ; slow liste les requêtes lentes récentes. |
aicore_alert | [high] | administrateurs | Envoie une alerte police de test à votre position via le script d’alerte actif. |
Les commandes aicore_* sont des outils de test : elles répondent dans la console du serveur. Les commandes d’administration QB / ESX habituelles (setjob, givemoney...) viennent avec ai-admin.
Raccourcis clavier
| Touche par défaut | Ce qu’elle fait | Nom dans les réglages de GTA |
|---|---|---|
| F10 | Ouvre le panneau d’administration (administrateurs uniquement) | Open the admin panel |
Limites connues
- Les joueurs doivent avoir un compte FiveM lié (l’identifiant
fivem:) ; les joueurs sans compte ne peuvent pas se connecter. - Un script dont le remplaçant tourne en même temps (tgiann-inventory à côté d’ai-inventory) empêche tout le monde d’entrer tant que les deux tournent, si Refuse players while both run est activé (par défaut). La console indique le dossier à supprimer.