Documentación de Renta de barcos con portico elevador

Otra Vida Marina (ov_marina)

Que hace

ov_marina pone en tu servidor FiveM marinas de renta de barcos con un portico elevador (travel lift) de cuatro ruedas, como los de los astilleros de verdad. Cada marina tiene un patio de concreto con el soporte del barco, dos muelles y una fosa que entra al agua. Delante tiene la oficina, con un agente con voz, el totem con la tableta y una pantalla en vivo. Los administradores colocan las marinas con un creador con gizmo. Cada marina puede tener dueno, con su caja, sus precios, su flota y sus empleados. El modelo 3D es propio, tiene colision en todas las piezas y dos niveles de detalle para no perder FPS.

Lo mas importante:

• Portico elevador que funciona como uno real:
• Al rentar: las cinchas bajan sobre el soporte del patio y enganchan el barco. El portico rueda hasta la fosa (las ruedas giran segun avanza) y lo baja al agua.
• Al devolver: el portico sale vacio hacia la fosa y baja las cinchas al agua. Saca tu barco y lo deja en el soporte del patio.
• Enganche de verdad, con el mismo metodo que ov_vehicletransport: el barco va enganchado a las cinchas mientras cuelga. Se suelta flotando, con fisica y el motor encendido, y el jugador queda al timon.
• Agua real de cada marina: las cinchas bajan hasta el nivel del agua de ese sitio.
• Devolucion en cualquier marina: pulsas E cerca, metes el barco entre los muelles y paras. Se guarda solo y te deja en el muelle, no en el agua.
• Oficina a pie de calle: puerta real de GTA con llave, props reales de oficina, silla para el agente y el personal. La ventanilla y la pantalla miran a la calle.
• Agentes con voz y personalidad: el Capitan Bruno y Lucia, con 144 frases en espanol, ingles y portugues. Te siguen con la mirada, te saludan, te recomiendan un barco real de la marina y hablan en 3D. Tambien pueden hablar solo con su voz, sin texto.
• Tableta del cliente: barcos con foto, planes por minutos u horas, impuesto, fianza y total. Se paga en efectivo o banco.
• Reloj de la renta: panel en pantalla con foto, nombre y matricula, cuenta atras, barra de tiempo y fianza. Avisos a los 10, 5 y 1 minutos.
• Quioscos robables, con la misma logica que ov_negocios:
• El agente sale armado, pelea, grita con su voz y avisa a la policia.
• Si lo neutralizas, vacias la caja.
• Con dueno te llevas un porcentaje de su caja; sin dueno, un monto del Fondo de la ciudad.
• Marinas con dueno ("Mi marina"): caja y retiros, abrir o cerrar, autoservicio o atendido, agente, flota y precios, empleados e historial.
• Dinero: sin dueno va al Fondo de la ciudad; con dueno, a la caja. El impuesto de ciudad es compatible con sbr-presidentes.

Como se usa (jugadores)

1. Ve a una marina OV Marina (blip de barco en el mapa).
2. Habla con el capitan en la ventanilla (E) o usa el totem.
3. Elige el barco y el plan, revisa el total y paga.
4. El portico saca tu barco del patio y lo baja al agua; quedas al timon con las llaves.
5. Para devolverlo, pulsa E cerca de cualquier marina, mete el barco en la fosa entre los muelles y para.

Administracion

• /marinaadmin (ACE ov_marina.admin o los grupos de Config.Admin.grupos):
• Marinas: nueva con el creador (fantasma transparente, rueda para girar, H cambia la oficina de lado, E fija, gizmo para afinar), ir, mover, apagar, blip, modo, dueno y borrar. La fosa va hacia el agua.
• Catalogo: solo barcos, con foto, precio por hora y fianza, en las pestanas Vanilla y Addon detectadas del juego.
• Planes: minutos y factor de precio.
• Rentas activas: terminar una renta.
• /marinasilla x y z h: ajusta la postura sentada.
• /mimarina: Mi marina (dueno y empleados).

Instalacion

1. Copia ov_marina a resources y anade ensure ov_marina despues de ox_lib, oxmysql, el framework y el sistema de llaves.
2. Las tablas se crean solas.
3. add_ace group.admin ov_marina.admin allow.
4. Opcional, con sbr-presidentes: anade ov_marina a Config.Api.allowedResources, ov_marina y ov-marina- como tipo general, y ov-marina-interno- a los exentos.
5. La primera vez, haz un reinicio completo del servidor para que carguen los modelos.

Configuracion

• Config.Planes, Config.CatalogoInicial (Seashark, Dinghy, Suntrap, Squalo, Tropic, Jetmax y Speeder) y Config.Renta (avisos, tiempos, danos).
• Config.Devolucion: segundos quieto en la fosa para guardar solo y velocidad maxima.
• Config.Reloj, Config.Robo, Config.Dinero y Config.Dueno.
• Config.Oficina, Config.Puerta, Config.Silla, Config.Npc, Config.Voz (con subtitulos) y Config.Camara.

Idiomas y frameworks

• Tres idiomas (Config.Idioma = 'es', 'en' o 'pt') en todo, incluida la voz de los agentes.
• QBCore, Qbox y ESX, detectados solos.
• Llaves automaticas: qbx_vehiclekeys, wasabi_carlock, qs-vehiclekeys, MrNewbVehicleKeys, Renewed-Vehiclekeys, qb-vehiclekeys y 0r-vehiclekeys.
• Combustible: ox_fuel, LegacyFuel, cdn-fuel, ps-fuel y lc_fuel.

Requisitos

OneSync, ox_lib, oxmysql, QBCore/Qbox/ESX y un sistema de llaves.

Opcionales:

• ov_3dsound para la voz en 3D.
• ov_npc_control para el robo con el ojito y el aviso a la policia.

Estado

Version 1.0.0. Probado con 157 pruebas: 130 del servidor en los tres idiomas y 27 del puente con QBCore, Qbox y ESX. El modelo 3D esta comprobado en el binario: colision con flags en todas las piezas, color de vertice y dos niveles de detalle.