Documentación de Renta de carros con capsula

Otra Vida Renta (ov_renta)

Que hace

ov_renta pone en tu servidor FiveM puestos de renta de carros con una capsula de vidrio que sube del suelo con el carro. Cada puesto tiene una oficina con puerta, un agente con voz que atiende sentado en su computador, un totem con tableta y pantallas que pasan los carros disponibles. Los administradores colocan los puestos por la ciudad con un creador con gizmo y manejan el catalogo desde un panel dentro del juego. Cada puesto puede tener dueno, con su caja, sus precios, su flota y sus empleados. El modelo 3D es propio y todas las piezas llevan colision.

Lo mas importante:

• Capsula como un elevador de carros: de origen esta bajo tierra, con el techo al ras del suelo. Al rentar sube con el carro, abre las puertas tipo ala de gaviota, cierra y baja. El script mueve el cuerpo y las dos puertas, cada pieza con su colision.
• Oficina con puerta real de GTA: la puerta usa el sistema de puertas del juego y se empuja. Tiene llave: el personal del puesto y el admin entran; el personal puede abrirla al publico con E.
• Oficina amueblada con props reales de GTA (monitor, teclado, torre, impresora, silla de oficina, dispensador de agua, planta, extintor y camara de seguridad), editables en Config.Oficina.
• Agente con voz y personalidad: Marcos y Daniela, con 132 frases en espanol, ingles y portugues. Te sigue con la mirada, te saluda, comenta si te quedas mirando y se despide. Habla en 3D, con subtitulo y boca que se mueve.
• Conversacion con camara de cine: con E en la ventanilla la camara encuadra su cara y se abre la conversacion: Ver los carros, Que me recomiendas (recomienda un carro real del puesto con su precio), promociones, Hablame de ti y Adios.
• Silla de la oficina: el NPC y el personal usan la postura de trabajar sentado al computador. El personal se sienta con E, cuenta como atendiendo y el NPC se retira; se levanta con X.
• Tableta del cliente: carros con foto, buscador y categorias, planes de tiempo, impuesto, fianza y total; pago en efectivo o banco.
• Pantallas en vivo: la caseta y el totem pasan los carros del puesto con foto y "desde", y mensajes de promocion.
• Devolucion en cualquier puesto: llegas con el carro, pulsas E, lo metes en la capsula y pulsas E otra vez. La capsula baja con el carro.
• Fianza: vuelve entera si el carro vuelve bien; con danos se descuenta; si se acaba el tiempo, se pierde y el carro se retira.
• Creador de puestos en /rentaadmin: el puesto aparece transparente donde apuntas, lo giras con la rueda, cambias la oficina de lado con H, lo fijas con E y lo afinas con el gizmo.
• Puestos con dueno ("Mi renta"): caja y retiros, abrir o cerrar, modo autoservicio o atendido, agente, flota y precios, empleados e historial.
• Dinero: sin dueno va al Fondo de la ciudad; con dueno, a la caja del puesto. El impuesto de ciudad se cobra por el motivo del cobro, compatible con sbr-presidentes.

Como se usa (jugadores)

1. Ve a un puesto OV Renta (blip en el mapa).
2. Habla con el agente en la ventanilla (E) o usa el totem (E).
3. Elige el carro y el plan, revisa el total (renta, impuesto y fianza) y paga en efectivo o banco.
4. La capsula sube con tu carro y abre las puertas. Las llaves son tuyas.
5. Para devolverlo, llega a cualquier puesto, pulsa E, mete el carro en la capsula, para y pulsa E otra vez.

Desde la tableta puedes extender el tiempo. Antes de que se acabe te llega un aviso; si no lo devuelves a tiempo, el carro se retira y pierdes la fianza.

Administracion

• /rentaadmin (ACE ov_renta.admin o los grupos de Config.Admin.grupos):
• Puestos: nuevo puesto con el creador, ir, mover, renombrar, activar o apagar, blip, modo, asignar o quitar dueno y borrar. Al borrar un puesto se borran tambien los carros rentados en ese momento.
• Catalogo: carros con foto, precio por hora y fianza; pestanas Vanilla y Addon con los carros detectados del juego; foto propia por carro.
• Planes: minutos y factor de precio.
• Rentas activas: terminar una renta (devuelve la fianza si el jugador esta conectado).
• /rentasilla x y z h: ajusta la postura sentada en vivo y dice los valores para dejarlos en Config.Silla.

Dueno y empleados

/mirenta, la opcion de gestion en la conversacion o E sentado en el computador abren Mi renta:

• Resumen: caja, rentas de hoy, rentas activas, abrir o cerrar, modo autoservicio o atendido, agente del puesto y retiro de la caja (solo el dueno).
• Flota: que carros ofrece y a que precio, entre el 50 % y el 200 % del precio base.
• Empleados: contratar a jugadores cercanos y despedir.
• Historial de rentas del puesto.

En modo atendido solo se renta si hay personal cerca o sentado en la oficina.

Instalacion

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

Configuracion

• Config.Planes, Config.CatalogoInicial, Config.FianzaPorDefecto, Config.Renta (avisos, tiempos, danos).
• Config.Dinero (Fondo, impuesto y motivos de cobro), Config.Dueno (limites de precio y empleados).
• Config.Pantalla (tiempo por tarjeta, carros y promociones), Config.Oficina (props), Config.Puerta (modelos de puerta y llave), Config.Silla (postura), Config.Npc, Config.Voz y Config.Camara.
• shared/agentes.lua: personalidades y frases; herramientas/generar_voces.py genera las voces con Edge TTS.

Idiomas y frameworks

• Tres idiomas (Config.Idioma = 'es', 'en' o 'pt'): avisos, ayudas, paneles, tableta, pantallas, categorias de carros, mensajes de error y la voz de los agentes.
• Frameworks detectados solos: QBCore, Qbox y ESX.
• Llaves automaticas: qbx_vehiclekeys, wasabi_carlock, qs-vehiclekeys, MrNewbVehicleKeys, Renewed-Vehiclekeys, qb-vehiclekeys y 0r-vehiclekeys, o una funcion propia.
• Gasolina: ox_fuel, LegacyFuel, cdn-fuel, ps-fuel y lc_fuel.

Requisitos

OneSync, ox_lib, oxmysql, QBCore/Qbox/ESX y un sistema de llaves. Para la voz, un recurso de sonido 3D (por defecto ov_3dsound); sin el, el agente habla con subtitulos.

Estado

Version 1.0.1. Probado con 120 pruebas (93 del servidor en los tres idiomas y 27 del puente con QBCore, Qbox y ESX) y en el navegador. La postura sentada y la posicion de la puerta de GTA se afinan en el juego con /rentasilla y Config.Puerta.