ai-jobs
Rutas de trabajo que se empiezan en un depósito (taxi, autobús, camionero, basura, noticias, grúa, reciclaje, viñedo, buceo) y el puesto de perritos calientes.
ai-jobs da a los jugadores trabajos sencillos que pueden empezar en un depósito: conducir una ruta y cobrar por parada, remolcar coches averiados o recolectar objetos a pie. Junto a las rutas gestiona un puesto de perritos calientes: alquila un carrito, empújalo, cocina y vende a los transeúntes. Cada ruta y cada parada se configuran en el panel de administración, así que puedes añadir trabajos nuevos sin escribir código.
Qué hace en el juego
- Empezar un turno. Cada ruta tiene un depósito con un blip en el mapa. Ve al depósito y usa el punto (Start working). Las rutas de conducción ponen un vehículo de trabajo en el punto de aparición de la ruta y te dan sus llaves. Usa el depósito otra vez (Stop working) para terminar el turno.
- Paradas. El servidor elige tu siguiente parada y la muestra en el mapa. En la parada, usa el punto (Work here): avanza una barra de progreso durante el tiempo por parada de la ruta, después cobras (u obtienes objetos en una ruta de recolección) y aparece la siguiente parada.
- Tipos de ruta.
- Random stops (paradas al azar): la siguiente parada es cualquier otra parada de la ruta (taxi, camionero, noticias, basura).
- Stops in order (paradas en orden): las paradas se suceden por su id y vuelven a empezar desde la primera (autobús).
- Gathering on foot (recolección a pie): sin vehículo; cada parada da un número al azar de un objeto (reciclaje, viñedo, buceo). Las paradas bajo el agua reproducen una animación de buceo.
- Towing (grúa): un coche averiado y cerrado espera en la parada. Cárgalo en la plataforma y el depósito pasa a ser la siguiente parada. Cobras en el depósito, solo si el coche remolcado sigue a menos de 15 m de la plataforma.
- Fin del turno. Un turno termina cuando se completan las paradas por turno (0 significa que nunca termina solo), cuando lo paras en el depósito, cuando sales del servidor o cuando se detiene el recurso. El vehículo de trabajo y un coche remolcado se borran entonces. No se guarda nada en la base de datos.
- Pago. Las rutas de conducción y de grúa pagan el pago por parada de la ruta en la cuenta de pago de la ruta (banco por defecto).
Puesto de perritos calientes
- En el mostrador, alquila un puesto. La fianza se cobra de la cuenta de fianza. El puesto aparece en su punto de aparición junto al mostrador.
- Usa el puesto para abrir su menú: Push the stand, Prepare hot dogs, Start selling / Stop selling.
- Mientras empujas, pulsa G para soltarlo. También lo sueltas cuando te caes, mueres, apuntas, peleas o te subes a un vehículo.
- Prepare hot dogs lanza una serie de pruebas de habilidad. Sin fallos sale un perrito perfecto (A), con un fallo uno raro (B), con más fallos uno común (C). Cada perrito sube tu reputación de perritos calientes. Desde el nivel 2, la mitad de las tandas tienen suerte y dan más de un perrito.
- Start selling: los transeúntes cercanos se acercan al puesto y hacen una oferta (de 1 a 3 perritos de una calidad, a un precio dentro del rango de tu nivel). Acéptala en el cliente. Un cliente espera 30 s. Alejarse más de 10 m del puesto o quedarse sin existencias para la venta.
- Devuelve el puesto en el mostrador para recuperar la fianza. Cerrar sesión con un puesto hace perder la fianza; detener el recurso la devuelve.
La reputación se guarda en el personaje (rep.hotdog, la misma clave que usa QBCore), así que se mantiene entre sesiones. Tu nivel es el nivel más alto cuyo From reputation hayas alcanzado; el nivel fija cuántos perritos de cada calidad admite el puesto y sus precios.
Instalación
Lo instala la receta de AI Core. A mano: pon la carpeta en resources/[ai]/ y añade ensure ai-jobs después de ensure ai-core. Necesita ai-core y OneSync.
Las rutas de recolección dan scrapmetal, grape y coral por defecto. Asegúrate de que estos objetos existen en la lista de objetos de tu inventario, o cambia el objeto de la ruta en el panel. Los vehículos de trabajo por defecto son modelos de GTA (taxi, bus, rumpo, trash2, flatbed), no hacen falta vehículos extra.
Ajustes del panel
Panel de administración > Work routes. Tiene tres pestañas: Routes, Stops y Hot dog stand. Los valores por defecto vienen de data/routes.json, data/stops.json y data/hotdog.json.
Pestaña Routes
Un registro por ruta. Las rutas por defecto son taxi, bus, trucker, garbage, recycle, vineyard, diving, tow y news.
Route (ruta)
| Ajuste | Qué cambia | Unidad | Por defecto para una ruta nueva |
|---|---|---|---|
| Name | El nombre mostrado en el aviso y el blip del depósito. 1-48 caracteres. | vacío | |
| Kind | Cómo se elige la siguiente parada: Random stops, Stops in order, Gathering on foot o Towing broken-down cars (mira arriba). | Random stops | |
| Jobs | Solo los miembros de estos trabajos pueden empezar la ruta. Deja trabajos y bandas vacíos para todos. El depósito y el blip de una ruta bloqueada solo se muestran a los jugadores que pueden usarla. | vacío (todos) | |
| Gangs | Los miembros de estas bandas también pueden empezarla. | vacío | |
| Only on duty | Los miembros del trabajo deben estar de servicio en ese trabajo. | desactivado | |
| Depot | Donde los jugadores empiezan y dejan de trabajar. Ponte allí y usa tu posición. | 0, 0, 0 | |
| Stops per shift | Cuántas paradas tiene un turno. 0 significa que el turno sigue hasta que el jugador lo para. 0-100. | 5 | |
| Time per stop | Cuánto tarda el trabajo en una parada (la barra de progreso). 0-120. | s | 5 |
| Depot blip | Sprite, color y tamaño del blip del depósito en el mapa. | sprite 67, color 5, tamaño 0.65 |
Work vehicle (vehículo de trabajo)
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Vehicle model | Nombre de spawn del vehículo de trabajo (taxi, bus, mule, trash). Vacío: sin vehículo (rutas de recolección). | vacío | |
| Vehicle spawn | Donde aparece el vehículo de trabajo y hacia dónde mira. | 0, 0, 0 | |
| Pay per stop | Se paga en la cuenta de pago tras cada parada. 0-100,000. | $ | 100 |
| Pay account | La cuenta de dinero a la que va el pago. | bank | |
| Broken-down cars | Solo rutas de grúa: nombres de spawn de los coches que esperan en las paradas; se elige uno al azar. Hasta 40 nombres. | 12 coches de GTA (sultanrs, zion, oracle...) |
Gathering (recolección)
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Item per stop | El objeto que se da en cada parada. | vacío | |
| Fewest items per stop | Cantidad mínima por parada. 1-100. | 1 | |
| Most items per stop | Cantidad máxima por parada. Cada parada da una cantidad al azar entre las dos. 1-100. | 3 |
NPC (opcional, una persona en el depósito)
| Ajuste | Qué cambia | Por defecto |
|---|---|---|
| Model | El modelo de ped; vacío significa sin NPC. Los jugadores lo ven a menos de 50 m. | vacío (el depósito de basura tiene s_m_y_garbage, el de buceo a_m_m_salton_01) |
| What it does | Una animación en reposo: quieto, espera impaciente, sujeta una carpeta, mira el teléfono, bebe café, fuma, hace guardia, reposo de policía, pasa el rato. | Stands still |
| Where it stands | El punto del NPC y hacia dónde mira. Sin él, está en el punto del depósito. | el depósito |
Las rutas por defecto:
| Ruta | Tipo | Vehículo | Pago por parada | Tiempo por parada | Paradas por turno |
|---|---|---|---|---|---|
Downtown Cab Co. (taxi) | Random stops | taxi | $120 | 4 s | 8 |
Dashound Bus (bus) | Stops in order | bus | $60 | 6 s | 0 (sin 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) | Gathering | ninguno, da scrapmetal | 5 s | 0 (sin fin) | |
Marlowe Vineyard (vineyard) | Gathering | ninguno, da grape | 4 s | 0 (sin fin) | |
Del Perro Diving (diving) | Gathering | ninguno, da coral | 8 s | 7 | |
Hayes Towing (tow) | Towing | flatbed | $250 | 8 s | 5 |
Weazel News (news) | Random stops | rumpo | $180 | 15 s | 5 |
Pestaña Stops
Un registro por parada. Una ruta sin paradas no se puede empezar. Borrar una ruta conserva sus paradas.
| Ajuste | Qué cambia | Por defecto |
|---|---|---|
| Route | El id de la ruta a la que pertenece esta parada (taxi, bus...). | taxi |
| Name | El nombre de la parada. 1-48 caracteres. | vacío |
| Place | Donde para el trabajador. Ponte en el lugar y usa tu posición. | 0, 0, 0 |
Pestaña Hot dog stand
Stand (puesto)
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Open | Desactivado oculta el mostrador. Los puestos ya alquilados siguen funcionando hasta que se devuelven. | activado | |
| Counter | Donde los jugadores alquilan y devuelven el puesto. | 39.31, -1005.54, 29.48 (Legion Square) | |
| Stand spawn | Donde aparece un puesto alquilado, mirando hacia donde debe mirar el mostrador del puesto. | 38.15, -1001.65, 29.44 | |
| Stand model | El prop del puesto. | prop_hotdogstand_01 | |
| Jobs / Gangs / Only on duty | Quién puede alquilar un puesto (la misma regla que en las rutas). Vacío: todos. | vacío | |
| Map blip | El blip del mostrador. | sprite 542, color 17, tamaño 0.6 |
Money (dinero)
| Ajuste | Qué cambia | Unidad | Por defecto |
|---|---|---|---|
| Deposit | Se cobra al alquilar el puesto y se devuelve al entregarlo en el mostrador (se pierde al cerrar sesión). 0-1,000,000. | $ | 250 |
| Deposit account | La cuenta de la que se cobra la fianza y a la que se devuelve. | bank | |
| Sales paid into | La cuenta a la que va el dinero de un cliente. | cash |
Cooking and reputation (cocina y reputación)
| Ajuste | Qué cambia | Por defecto |
|---|---|---|
| Skill checks | Pruebas de habilidad por perrito. 1-10. | 3 |
| Reputation per perfect | Reputación que da un perrito perfecto. 0-100. | 3 |
| Reputation per rare | Reputación que da un perrito raro. 0-100. | 2 |
| Reputation per common | Reputación que da un perrito común. 0-100. | 1 |
| Highest reputation | La reputación deja de crecer aquí. 0-100,000. | 200 |
Levels y Prices (una lista, hasta 10 niveles; el primero se aplica desde 0)
| Ajuste | Qué cambia |
|---|---|
| From reputation | La reputación en la que empieza este nivel. |
| Hot dogs per quality | Cuántos perritos de cada calidad admite el puesto en este nivel. |
| Perfect from / to, Rare from / to, Common from / to | Rango de precio de un perrito de esa calidad, en $. Cada oferta elige un precio dentro del rango. |
Niveles por defecto:
| From reputation | Hot dogs per quality | Perfecto | Raro | Común |
|---|---|---|---|---|
| 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 |
El puesto también tiene una tarjeta NPC (modelo, animación en reposo, posición), como las rutas.
Comandos
Ninguno.
Teclas
Cada jugador puede cambiarlas en los ajustes de teclas de GTA (sección FiveM); el dueño cambia los valores por defecto en el panel de administración (Keybinds).
| Tecla por defecto | Qué hace |
|---|---|
| G | Soltar el puesto de perritos calientes que estás empujando (jobs_hotdog_release). |
Los depósitos, las paradas, el mostrador y el puesto son puntos de interacción: un aviso con la tecla de interacción (E por defecto) o una opción de target, según el ajuste Interaction style de ai-core.
A qué sustituye
No tiene fxProvide. Un solo motor cubre lo que QBCore / Qbox incluyen como scripts de trabajo separados (taxi, autobús, camionero, basura, grúa, noticias y trabajos de recolección), y el puesto de perritos calientes es un port de qb-hotdogjob. No responde a los exports ni eventos de esos scripts.
Scripts compatibles
Las llaves del vehículo de trabajo pasan por la capa de llaves de AI Core y los objetos por la capa de inventario. Funciona cualquier script de llaves e inventario que AI Core soporte (mira Compatibilidad).
Límites conocidos
- Un turno solo se guarda en memoria: salir del servidor o reiniciar el recurso lo termina, y el vehículo de trabajo se borra.
- El servidor rechaza una parada cuando el jugador está a más de 12 m de ella, a más de 15 m del vehículo de trabajo (rutas de conducción), o llega desde la última parada a más de 60 m/s (teletransportes).
- Los perritos calientes no son objetos de inventario: las existencias viven en el puesto, y los clientes solo son NPC. Los jugadores no pueden comprarse entre sí.
- Canales de logs:
work(pago de rutas) yhotdog(ventas).
Trabajos y servicios
Rutas de trabajo, policía, alertas, prisión, muerte y EMS, banca, menús de jefe y el ayuntamiento.
ai-jobs para desarrolladores
Lo que ai-jobs comparte con otros scripts (no tiene exports): la reputación de perritos calientes, las matrículas y llaves de los vehículos de trabajo, los motivos de registro y sus eventos privados.