Documentación de OV Viñedo

OV Viñedo (ov_vinedo)

Que hace

Trabajo de bodega de Otra Vida. El jugador corta uva en las parras, la prensa, fermenta el mosto en barriles, lava y llena botellas, las etiqueta, sirve copas y reparte pedidos a bares, licorerías y restaurantes de ov_negocios. Hay tres vinos (tinto, blanco y rosado), tienda, garaje, almacén, vestuario y menú del jefe. Trae un editor de puntos en el juego y textos en español, inglés y portugués.

Estado

• Versión 1.0.0 en pruebas.
• Precio: 30 USD.
• /ovtest ov_vinedo dio 15 OK y 0 fallos según datos/ENCARGO.md (línea 9). Esta documentación no lo ejecutó.
• Sin probar en el juego: menú, editor, cadena completa de trabajo, reparto, garaje y tienda.
• Los datos salen de config.lua, fxmanifest.lua, server/db.lua, items_ox_inventory.txt y LEEME.md del recurso.

Cadena de trabajo

La cadena de cada vino es: uva, mosto (prensa), vino sin etiqueta (barril), vino (etiquetado) y copas.

1. Recoger: con tijeras, de 2 a 4 racimos por parra, 6 s de corte. La parra vuelve a tener uva a los 180 s, para todos los jugadores. Con un 15 % de probabilidad las tijeras quedan sucias.
2. Prensar: 6 uvas dan 1 mosto, en 10 s.
3. Barril: del mosto sale el vino sin etiqueta. El estado del barril se guarda en la tabla ov_vinedo_barriles y sobrevive a los reinicios. Capacidades y tiempos están en la sección "Configuración".
4. Etiquetar: el vino sin etiqueta pasa a ser vino con la etiqueta ov_vin_etiqueta.
5. Limpieza: las tijeras y las botellas sucias son items propios (ov_vin_tijeras_sucias, ov_vin_botella_sucia).
6. Servir: 4 copas en 4 s.
7. Beber: quita 15 de sed, dura 3 s y devuelve la copa vacía.
8. Repartir: pedido de 2 a 6 botellas a un bar, licorería o restaurante, a 140-220 dólares por botella más 60 por km. Hay 900 s para entregar y 60 s de espera entre pedidos.

Dependencias

Declaradas en dependencies del fxmanifest.lua:

Opcionales, se cambian en config.lua:

• ov_negocios: de su tabla ov_negocios salen los destinos de reparto. Si no hay ninguno, se usan los puntos cliente puestos con el editor.
• Vestuario: evento illenium-appearance:client:openOutfitMenu (Config.Vestuario).
• Menú del jefe: evento qb-bossmenu:client:OpenMenu (Config.Jefe).
• Llaves: evento vehiclekeys:client:SetOwner (Config.Garaje.eventoLlaves). Vacío significa sin llaves.

Instalación

1. Copia las carpetas ov_vinedo_props y ov_vinedo a la carpeta de recursos del servidor.
2. Añade al server.cfg, después de ox_inventory y ov_negocios:

ensure ov_vinedo_props ensure ov_vinedo

1. Pega items_ox_inventory.txt en ox_inventory/data/items.lua (sección siguiente).
2. Añade el trabajo vinedo a qb-core/shared/jobs.lua (sección "Trabajo en jobs.lua").
3. Arranca el servidor. Las tablas se crean solas y la primera vez se cargan los puntos de fábrica de Marlowe Vineyards.
4. Ejecuta /ovtest ov_vinedo y comprueba que da 0 fallos.

Para desactivar el recurso, saca su carpeta fuera de la carpeta de recursos. No dejes # ensure ov_vinedo comentado en el server.cfg.

Items para ox_inventory

items_ox_inventory.txt trae 21 items con prefijo ov_vin_. Se pega dentro de ox_inventory/data/items.lua. Las imágenes van en ox_inventory/web/images con el nombre del item y extensión .png.

Los nombres de los items también están en Config.Items y Config.Vinos. Si renombras un item, cámbialo en los tres sitios.

Trabajo en jobs.lua

El trabajo se llama vinedo y tiene grados del 0 al 3. El grado 3 es el jefe (Config.Trabajo.gradoJefe). Añade esto a qb-core/shared/jobs.lua:

['vinedo'] = { label = 'Viñedo', defaultDuty = true, offDutyPay = false, grades = { ['0'] = { name = 'Recolector', payment = 0 }, ['1'] = { name = 'Bodeguero', payment = 0 }, ['2'] = { name = 'Maestro de bodega', payment = 0 }, ['3'] = { name = 'Jefe del viñedo', isboss = true, payment = 0 }, }, },

Los nombres de los grados y los pagos son los del servidor Legacy; puedes cambiarlos. El script solo usa la clave y los grados 0 a 3. Lo que el script usa:

• La clave del trabajo es vinedo y existen los grados 0 a 3.
• Con Config.Trabajo.abierto = true cualquiera puede trabajar sin tener el trabajo.
• La tienda tiene soloTrabajo = true.

Configuración (config.lua)

Todo lo que puede cambiar el dueño del servidor está en config.lua y en shared/idiomas_es.lua, shared/idiomas_en.lua y shared/idiomas_pt.lua.

Los precios de la tienda y del reparto son dólares. Los destinos de reparto salen de los tipos licoreria, bar y restaurante y de los catálogos licoreria, licoreria_puerto, licoreria_sectorcero, bar_marina, sky_lounge y vanilla.

Copia literal de config.lua, líneas 40 a 54

Husillo, barril, fregadero y etiquetado, tal como están en el archivo:

-- Husillo de la prensa (modelo de ov_vinedo_props): se coloca 'altura' m sobre el origen de la prensa, gira 'vueltas' y baja 'bajada' m durante el prensado, luego sube en 'subidaMs' Config.Husillo = { modelo = 'ov_vin_prensa_husillo', altura = 1.08, bajada = 0.30, vueltas = 4, subidaMs = 1200 }

-- Barril: se mete mosto de UN tipo, fermenta y da vino para llenar botellas Config.Barril = { capacidad = 10, -- mosto maximo por barril fermentar = 900, -- segundos que fermenta (15 minutos reales); se cuenta aunque nadie este cerca botellasPorMosto = 3, -- botellas que salen de cada mosto segundosPorBotella = 2, maxPorTanda = 10, -- botellas como maximo en cada llenado }

Config.Fregadero = { segundosPorUnidad = 1.5, maxPorTanda = 10 } Config.Etiquetado = { segundosPorBotella = 2, maxPorTanda = 10 }

Copia literal de config.lua, desde la línea 99

Blip, modelos de los puntos y objetos en la mano, tal como están en el archivo:

-- Blip del viñedo (en el primer punto 'almacen') Config.Blip = { sprite = 85, color = 27, escala = 0.8 }

-- Objetos que se ponen en algunos puntos (nil = ninguno). Del juego base, elegidos en la biblioteca de objetos. -- prensa y barril son modelos propios del recurso ov_vinedo_props. Config.Props = { prensa = 'ov_vin_prensa', barril = 'ov_vin_barril_grifo', almacen = 'h4_prop_h4_barrel_pile_01a', reparto = 'prop_fruit_plas_crate_01', }

-- Objetos en la mano durante cada accion (del juego base) Config.Mano = { recoger = { model = 'prop_fruit_basket', bone = 57005, pos = { 0.40, 0.0, -0.10 }, rot = { 0.0, -90.0, 0.0 } }, etiquetar = { model = 'prop_wine_red', bone = 18905, pos = { 0.10, 0.02, 0.05 }, rot = { -80.0, 0.0, 0.0 } }, servir = { model = 'prop_wine_red', bone = 18905, pos = { 0.10, 0.02, 0.05 }, rot = { -80.0, 0.0, 0.0 } }, beber = { model = 'prop_drink_redwine', bone = 18905, pos = { 0.10, -0.05, 0.03 }, rot = { -100.0, 0.0, -10.0 } }, }

-- Puntos de fabrica en Marlowe Vineyards. Solo se usan la primera vez (tabla vacia); despues manda el editor -- (/vinedoeditor). Tipos validos en shared/logica.lua (Vin.TIPOS). Config.PuntosFabrica = { { tipo = 'parra_tinta', x = -1859.24, y = 2098.63, z = 138.53 }, { tipo = 'parra_tinta', x = -1851.58, y = 2107.21, z = 135.69 }, { tipo = 'parra_tinta', x = -1843.90, y = 2105.78, z = 137.79 }, { tipo = 'parra_tinta', x = -1833.63, y = 2110.65, z = 136.31 }, { tipo = 'parra_tinta', x = -1844.72, y = 2110.52, z = 135.02 }, { tipo = 'parra_tinta', x = -1831.57, y = 2116.44, z = 133.32 }, { tipo = 'parra_blanca', x = -1874.71, y = 2099.45, z = 139.14 }, { tipo = 'parra_blanca', x = -1882.07, y = 2099.61, z = 139.24 }, { tipo = 'parra_blanca', x = -1891.79, y = 2100.55, z = 138.21 }, { tipo = 'parra_blanca', x = -1883.13, y = 2104.22, z = 137.61 }, { tipo = 'parra_blanca', x = -1880.00, y = 2108.84, z = 136.42 }, { tipo = 'parra_blanca', x = -1878.03, y = 2112.95, z = 135.13 }, { tipo = 'parra_rosada', x = -1850.22, y = 2089.88, z = 139.88 }, { tipo = 'parra_rosada', x = -1840.25, y = 2095.50, z = 138.61 }, { tipo = 'parra_rosada', x = -1845.62, y = 2087.16, z = 139.19 }, { tipo = 'parra_rosada', x = -1837.54, y = 2087.06, z = 138.00 }, { tipo = 'parra_rosada', x = -1835.64, y = 2082.72, z = 137.66 }, { tipo = 'parra_rosada', x = -1830.74, y = 2080.66, z = 136.53 }, { tipo = 'prensa', x = -1882.69, y = 2091.74, z = 139.89, h = 250.75 }, { tipo = 'prensa', x = -1888.42, y = 2092.98, z = 139.89, h = 250.75 }, { tipo = 'barril', x = -1904.67, y = 2093.08, z = 139.85, h = 8.0 }, { tipo = 'barril', x = -1900.44, y = 2093.76, z = 139.85, h = 8.0 }, { tipo = 'barril', x = -1895.93, y = 2094.27, z = 139.85, h = 8.0 }, { tipo = 'fregadero', x = -1897.65, y = 2078.97, z = 140.78 }, { tipo = 'etiquetado', x = -1907.54, y = 2092.26, z = 139.99 }, { tipo = 'almacen', x = -1885.70, y = 2075.11, z = 140.00, h = 160.5 }, { tipo = 'vestuario', x = -1909.29, y = 2072.05, z = 140.64 }, { tipo = 'jefe', x = -1860.37, y = 2053.66, z = 141.18 }, { tipo = 'tienda', x = -1890.75, y = 2074.56, z = 140.00, h = 250.0 }, { tipo = 'garaje', x = -1924.95, y = 2048.03, z = 139.83, h = 258.23 }, { tipo = 'garaje_salida', x = -1918.35, y = 2056.79, z = 139.74, h = 258.15 }, { tipo = 'reparto', x = -1879.77, y = 2091.79, z = 140.35 }, }

Comandos y teclas

Permiso del editor: el ACE ov_vinedo.admin, o ser admin o god de qb-core (Config.PermisosAdmin, comprobado con Functions.HasPermission).

El editor muestra todos los puntos con su número. Permite añadir uno del tipo elegido donde está parado el admin, moverlo, ir a él o borrarlo con confirmación.

Tablas SQL

Las crea el propio recurso al arrancar con CREATE TABLE IF NOT EXISTS (VinDB.Crear en server/db.lua). Se pueden crear dos veces sin error y no hace falta importar ningún archivo SQL.

Tabla ov_vinedo_puntos: los puntos del editor.

Tabla ov_vinedo_barriles: el estado de cada barril, que sobrevive a los reinicios.

Ambas usan el motor InnoDB y el juego de caracteres utf8mb4.

Props (ov_vinedo_props)

Recurso aparte, versión 1.2.0, con this_is_a_map 'yes' en su manifest. Trae 6 modelos en stream/ y el archivo ov_vinedo_props.ytyp:

Los modelos sin colisión están declarados con su motivo en OV_DECLARADOS.json del recurso de props.

Solución de problemas

Pruebas con /ovtest ov_vinedo

/ovtest ov_vinedo es el comando de pruebas de Otra Vida. No está en el código de ov_vinedo. Según datos/ENCARGO.md, comprueba:

• los recursos necesarios y los 21 items;
• las tablas ov_vinedo_puntos y ov_vinedo_barriles;
• el trabajo vinedo con grados 0 a 3;
• los 6 modelos de ov_vinedo_props;
• los 32 puntos de fábrica;
• la colisión de prensa y barril, medida con rayos (CHOCA 5/5);
• el husillo animado.

Resultado registrado en el encargo: 15 OK y 0 fallos.

Pruebas de simulación del recurso, con lua5.4 desde la carpeta de ov_vinedo:

lua5.4 tests/sim_logica.lua lua5.4 tests/sim_idiomas.lua lua5.4 tests/sim_servidor.lua

Sin probar en el juego: el menú, el editor, la cadena completa de trabajo, el reparto, el garaje y la tienda. Hector debe hacer esa prueba antes de publicar.