ai-jobs
Des tournées de travail lancées depuis un dépôt (taxi, bus, routier, éboueur, journaliste, dépanneuse, recyclage, vignoble, plongée) et le stand de hot-dogs.
ai-jobs donne aux joueurs des métiers simples qu’ils peuvent lancer depuis un dépôt : parcourir une tournée en étant payé à chaque arrêt, remorquer des voitures en panne, ou récolter des objets à pied. À côté des tournées, il fait tourner un stand de hot-dogs : louez un chariot, poussez-le, cuisinez et vendez aux passants. Chaque tournée et chaque arrêt se règlent dans le panneau d’administration, vous pouvez donc ajouter de nouveaux métiers sans écrire de code.
Ce qu’il fait en jeu
- Commencer un service. Chaque tournée a un dépôt avec un blip sur la carte. Allez au dépôt et utilisez le point (Start working). Les tournées en véhicule placent un véhicule de travail au point d’apparition de la tournée et vous en donnent les clés. Utilisez à nouveau le dépôt (Stop working) pour terminer le service.
- Arrêts. Le serveur choisit votre prochain arrêt et l’affiche sur la carte. À l’arrêt, utilisez le point (Work here) : une barre de progression tourne pendant la durée par arrêt de la tournée, puis vous êtes payé (ou recevez des objets sur une tournée de récolte) et l’arrêt suivant apparaît.
- Types de tournées.
- Random stops (arrêts aléatoires) : l’arrêt suivant est n’importe quel autre arrêt de la tournée (taxi, routier, journaliste, éboueur).
- Stops in order (arrêts dans l’ordre) : les arrêts se suivent selon leur id et recommencent depuis le premier (bus).
- Gathering on foot (récolte à pied) : pas de véhicule ; chaque arrêt donne un nombre aléatoire d’un objet (recyclage, vignoble, plongée). Les arrêts sous l’eau jouent une animation de plongée.
- Towing (remorquage) : une voiture en panne verrouillée attend à l’arrêt. Chargez-la sur le plateau, puis le dépôt devient l’arrêt suivant. Vous êtes payé au dépôt, uniquement si la voiture remorquée est encore à moins de 15 m du plateau.
- Fin du service. Un service se termine quand les arrêts par service sont faits (0 signifie qu’il ne se termine jamais de lui-même), quand vous l’arrêtez au dépôt, quand vous quittez le serveur, ou quand la ressource s’arrête. Le véhicule de travail et une voiture remorquée sont alors supprimés. Rien n’est enregistré dans la base de données.
- Paie. Les tournées en véhicule et de remorquage versent la paie par arrêt de la tournée sur le compte de paie de la tournée (bank par défaut).
Stand de hot-dogs
- Au comptoir, louez un stand. La caution est prélevée sur le compte de caution. Le stand apparaît à son point d’apparition à côté du comptoir.
- Utilisez le stand pour ouvrir son menu : Push the stand, Prepare hot dogs, Start selling / Stop selling.
- En poussant, appuyez sur G pour lâcher. Vous lâchez aussi quand vous tombez, mourez, visez, vous battez ou montez dans un véhicule.
- Prepare hot dogs lance une série de tests d’habileté. Aucun raté donne un hot-dog parfait (A), un raté un hot-dog rare (B), plus de ratés un hot-dog commun (C). Chaque hot-dog augmente votre réputation de vendeur de hot-dogs. À partir du niveau 2, la moitié des fournées sont chanceuses et donnent plus d’un hot-dog.
- Start selling : les passants à proximité s’approchent du stand et font une offre (1 à 3 hot-dogs d’une même qualité, à un prix dans la fourchette de votre niveau). Acceptez-la auprès du client. Un client attend 30 s. S’éloigner de plus de 10 m du stand ou épuiser le stock arrête la vente.
- Rendez le stand au comptoir pour récupérer la caution. Se déconnecter avec un stand fait perdre la caution ; un arrêt de la ressource la rembourse.
La réputation est stockée sur le personnage (rep.hotdog, la même clé que QBCore), donc elle reste d’une session à l’autre. Votre niveau est le plus haut niveau dont vous avez atteint le From reputation ; le niveau détermine combien de hot-dogs de chaque qualité le stand contient et leurs prix.
Installation
Installé par la recipe d’AI Core. À la main : placez le dossier dans resources/[ai]/ et ajoutez ensure ai-jobs après ensure ai-core. Il nécessite ai-core et OneSync.
Les tournées de récolte donnent scrapmetal, grape et coral par défaut. Assurez-vous que ces objets existent dans la liste d’objets de votre inventaire, ou changez l’objet de la tournée dans le panneau. Les véhicules de travail par défaut sont des modèles GTA (taxi, bus, rumpo, trash2, flatbed), aucun véhicule supplémentaire n’est nécessaire.
Réglages du panneau
Panneau d’administration > Work routes. Il a trois onglets : Routes, Stops et Hot dog stand. Les valeurs par défaut viennent de data/routes.json, data/stops.json et data/hotdog.json.
Onglet Routes
Un enregistrement par tournée. Les tournées par défaut sont taxi, bus, trucker, garbage, recycle, vineyard, diving, tow et news.
Route
| Réglage | Ce qu’il change | Unité | Défaut pour une nouvelle tournée |
|---|---|---|---|
| Name | Le nom affiché sur l’invite du dépôt et sur le blip. 1-48 caractères. | vide | |
| Kind | Comment l’arrêt suivant est choisi : Random stops, Stops in order, Gathering on foot ou Towing broken-down cars (voir ci-dessus). | Random stops | |
| Jobs | Seuls les membres de ces métiers peuvent lancer la tournée. Laissez les métiers et les gangs vides pour tout le monde. Le dépôt et le blip d’une tournée restreinte ne s’affichent qu’aux joueurs qui peuvent l’utiliser. | vide (tout le monde) | |
| Gangs | Les membres de ces gangs peuvent aussi la lancer. | vide | |
| Only on duty | Les membres d’un métier doivent être en service dans ce métier. | désactivé | |
| Depot | L’endroit où les joueurs commencent et arrêtent de travailler. Placez-vous là et utilisez votre position. | 0, 0, 0 | |
| Stops per shift | Combien d’arrêts compte un service. 0 signifie que le service continue jusqu’à ce que le joueur l’arrête. 0-100. | 5 | |
| Time per stop | Durée du travail à un arrêt (la barre de progression). 0-120. | s | 5 |
| Depot blip | Sprite, couleur et taille du blip du dépôt sur la carte. | sprite 67, couleur 5, taille 0.65 |
Work vehicle
| Réglage | Ce qu’il change | Unité | Défaut |
|---|---|---|---|
| Vehicle model | Nom d’apparition du véhicule de travail (taxi, bus, mule, trash). Vide : pas de véhicule (tournées de récolte). | vide | |
| Vehicle spawn | L’endroit où le véhicule de travail apparaît et sa direction. | 0, 0, 0 | |
| Pay per stop | Versé sur le compte de paie après chaque arrêt. 0-100 000. | $ | 100 |
| Pay account | Le compte d’argent sur lequel va la paie. | bank | |
| Broken-down cars | Tournées de remorquage uniquement : noms d’apparition des voitures qui attendent aux arrêts ; une est choisie au hasard. Jusqu’à 40 noms. | 12 voitures GTA (sultanrs, zion, oracle...) |
Gathering
| Réglage | Ce qu’il change | Unité | Défaut |
|---|---|---|---|
| Item per stop | L’objet donné à chaque arrêt. | vide | |
| Fewest items per stop | Quantité minimale par arrêt. 1-100. | 1 | |
| Most items per stop | Quantité maximale par arrêt. Chaque arrêt donne une quantité aléatoire entre les deux. 1-100. | 3 |
NPC (facultatif, une personne qui se tient au dépôt)
| Réglage | Ce qu’il change | Défaut |
|---|---|---|
| Model | Le modèle de ped ; vide signifie pas de PNJ. Les joueurs le voient à moins de 50 m. | vide (le dépôt des éboueurs a s_m_y_garbage, le dépôt de plongée a_m_m_salton_01) |
| What it does | Une animation d’attente : reste immobile, attend avec impatience, tient un porte-documents, regarde un téléphone, boit un café, fume, monte la garde, attente de policier, traîne. | Stands still |
| Where it stands | L’emplacement du PNJ et sa direction. Sans cela, il se tient sur le point du dépôt. | le dépôt |
Les tournées par défaut :
| Tournée | Type | Véhicule | Paie par arrêt | Durée par arrêt | Arrêts par service |
|---|---|---|---|---|---|
Downtown Cab Co. (taxi) | Random stops | taxi | 120 $ | 4 s | 8 |
Dashound Bus (bus) | Stops in order | bus | 60 $ | 6 s | 0 (sans fin) |
Post OP Freight (trucker) | Random stops | rumpo | 250 $ | 8 s | 5 |
Los Santos Sanitation (garbage) | Random stops | trash2 | 90 $ | 6 s | 10 |
Recycling Center (recycle) | Récolte | aucun, donne scrapmetal | 5 s | 0 (sans fin) | |
Marlowe Vineyard (vineyard) | Récolte | aucun, donne grape | 4 s | 0 (sans fin) | |
Del Perro Diving (diving) | Récolte | aucun, donne coral | 8 s | 7 | |
Hayes Towing (tow) | Remorquage | flatbed | 250 $ | 8 s | 5 |
Weazel News (news) | Random stops | rumpo | 180 $ | 15 s | 5 |
Onglet Stops
Un enregistrement par arrêt. Une tournée sans arrêts ne peut pas être lancée. Supprimer une tournée conserve ses arrêts.
| Réglage | Ce qu’il change | Défaut |
|---|---|---|
| Route | L’id de la tournée à laquelle appartient cet arrêt (taxi, bus...). | taxi |
| Name | Le nom de l’arrêt. 1-48 caractères. | vide |
| Place | L’endroit où le travailleur s’arrête. Placez-vous à cet endroit et utilisez votre position. | 0, 0, 0 |
Onglet Hot dog stand
Stand
| Réglage | Ce qu’il change | Unité | Défaut |
|---|---|---|---|
| Open | Désactivé masque le comptoir. Les stands déjà loués continuent de fonctionner jusqu’à leur restitution. | activé | |
| Counter | L’endroit où les joueurs louent et rendent le stand. | 39.31, -1005.54, 29.48 (Legion Square) | |
| Stand spawn | L’endroit où apparaît un stand loué, orienté comme doit l’être le comptoir du stand. | 38.15, -1001.65, 29.44 | |
| Stand model | Le prop du stand. | prop_hotdogstand_01 | |
| Jobs / Gangs / Only on duty | Qui peut louer un stand (même règle que pour les tournées). Vide : tout le monde. | vide | |
| Map blip | Le blip du comptoir. | sprite 542, couleur 17, taille 0.6 |
Money
| Réglage | Ce qu’il change | Unité | Défaut |
|---|---|---|---|
| Deposit | Prélevée à la location du stand, rendue quand il est restitué au comptoir (perdue à la déconnexion). 0-1 000 000. | $ | 250 |
| Deposit account | Le compte sur lequel la caution est prélevée et rendue. | bank | |
| Sales paid into | Le compte sur lequel va l’argent d’un client. | cash |
Cooking and reputation
| Réglage | Ce qu’il change | Défaut |
|---|---|---|
| Skill checks | Tests d’habileté par hot-dog. 1-10. | 3 |
| Reputation per perfect | Réputation que donne un hot-dog parfait. 0-100. | 3 |
| Reputation per rare | Réputation que donne un hot-dog rare. 0-100. | 2 |
| Reputation per common | Réputation que donne un hot-dog commun. 0-100. | 1 |
| Highest reputation | La réputation cesse d’augmenter ici. 0-100 000. | 200 |
Levels et Prices (une seule liste, jusqu’à 10 niveaux ; le premier s’applique à partir de 0)
| Réglage | Ce qu’il change |
|---|---|
| From reputation | La réputation à laquelle commence ce niveau. |
| Hot dogs per quality | Combien de hot-dogs de chaque qualité le stand peut contenir à ce niveau. |
| Perfect from / to, Rare from / to, Common from / to | Fourchette de prix d’un hot-dog de cette qualité, en $. Chaque offre choisit un prix dans la fourchette. |
Niveaux par défaut :
| From reputation | Hot-dogs par qualité | Parfait | Rare | Commun |
|---|---|---|---|---|
| 0 | 15 | 8-12 $ | 6-9 $ | 4-6 $ |
| 50 | 30 | 9-13 $ | 7-10 $ | 5-7 $ |
| 100 | 45 | 10-14 $ | 8-11 $ | 6-9 $ |
| 200 | 60 | 11-15 $ | 9-12 $ | 7-9 $ |
Le stand a aussi une carte NPC (modèle, animation d’attente, position), comme les tournées.
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 |
|---|---|
| G | Lâcher le stand de hot-dogs que vous poussez (jobs_hotdog_release). |
Les dépôts, les arrêts, le comptoir et le stand sont des points d’interaction : une invite avec la touche d’interaction (E par défaut) ou une option de ciblage, selon le réglage Interaction style d’ai-core.
Ce qu’il remplace
Pas de fxProvide. Un seul moteur couvre ce que QBCore / Qbox livrent sous forme de scripts de métier séparés (taxi, bus, routier, éboueur, dépanneuse, journaliste et métiers de récolte), et le stand de hot-dogs est un portage de qb-hotdogjob. Il ne répond pas aux exports ni aux events de ces scripts.
Scripts compatibles
Les clés des véhicules de travail passent par la couche clés d’AI Core, les objets par la couche inventaire. Tout script de clés et tout inventaire pris en charge par AI Core fonctionne (voir Compatibilité).
Limites connues
- Un service est gardé uniquement en mémoire : quitter le serveur ou redémarrer la ressource le termine, et le véhicule de travail est supprimé.
- Le serveur refuse un arrêt quand le joueur en est à plus de 12 m, à plus de 15 m du véhicule de travail (tournées en véhicule), ou arrive plus vite que 60 m/s depuis le dernier arrêt (téléportations).
- Les hot-dogs ne sont pas des objets d’inventaire : le stock se trouve sur le stand, et les clients sont uniquement des PNJ. Les joueurs ne peuvent pas s’acheter entre eux.
- Canaux de logs :
work(paie des tournées) ethotdog(ventes).
Métiers et services
Tournées de travail, police, alertes, prison, mort et EMS, banque, menus de patron et mairie.
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.