Documentación de Renta de aviones con hangar y tractor

Otra Vida Hangar (ov_hangar)

Que hace

ov_hangar pone en tu servidor FiveM hangares de renta de aviones, como en un aeropuerto de verdad. Hay tres tamanos: grande para jets, pequeno para avionetas y de agua para hidroaviones. Cada hangar tiene puertas correderas, una plataforma con el cuadro amarillo de entrega y el tractor Airtug del juego, que saca el avion y lo vuelve a meter. Delante tiene la oficina, con un agente con voz, el totem con la tableta y una pantalla en vivo. Los administradores colocan los hangares con un creador con gizmo. Cada hangar 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:

• Tres hangares:
• Grande (28 x 34 m, puerta de 24 x 7,8 m): caben los jets (Miljet, Nimbus, Luxor, Shamal) y tambien las avionetas.
• Pequeno (18 x 18 m): avionetas (Cuban 800, Duster, Mammatus, Mallard, Velum, Howard, Vestra).
• Agua: el pequeno con rieles, rampa al agua y carro de varada para el Dodo y el Seabreeze.
• Tractor Airtug con push-back, en verde OV, con su operario y la barra de remolque real de GTA:
• Al rentar: se abren las puertas, el tractor engancha la rueda delantera, saca el avion al cuadro amarillo y vuelve rodeando las alas.
• Al devolver: aterrizas y paras en el cuadro. El tractor se pone frente al morro y lo empuja dentro.
• Hangar de agua: el carro baja el hidroavion por la rampa hasta que flota y lo sube al devolverlo. El carro baja hasta el nivel real del agua de cada sitio.
• El hangar nunca dana el avion: se entrega reparado y protegido mientras lo mueve. Al devolverlo, el roce con el carro o la rampa no se cobra de la fianza.
• Cada avion a su hangar: al agregar un avion al catalogo se mide (envergadura, largo y alto) y solo se ofrece en el hangar donde cabe.
• Por dentro: luces reales que se encienden contigo cerca, piso pulido con lineas amarillas y props de taller y aeropuerto de GTA.
• Agentes con voz y personalidad: el Capitan Andres y Valentina, con 144 frases en espanol, ingles y portugues.
• Tableta del cliente: aviones con foto, planes por minutos u horas, impuesto, fianza y total. Se paga en efectivo o banco.
• Reloj de la renta con avisos a los 10, 5 y 1 minutos.
• Quioscos robables, con la misma logica que ov_negocios: el agente sale armado, pelea y avisa a la policia.
• Hangares con dueno ("Mi hangar"): caja y retiros, 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 un hangar OV Hangar (icono de avion en el mapa).
2. Habla con el piloto en la ventanilla (E) o usa el totem.
3. Elige el avion y el plan, revisa el total y paga.
4. El tractor saca tu avion al cuadro amarillo y quedas en la cabina con las llaves. En el hangar de agua, el carro lo baja al agua.
5. Para devolverlo, pulsa E cerca de cualquier hangar OV (en el aire o en tierra), aterriza y para en el cuadro (o encima del carro). Se guarda solo.

Administracion

• /hangaradmin (ACE ov_hangar.admin o los grupos de Config.Admin.grupos):
• Hangares: nuevo con el creador (eliges el tamano; la boca hacia la pista o el agua; rueda para girar, H cambia la oficina de lado, E fija, gizmo para afinar), ir, mover, apagar, blip, modo, dueno y borrar.
• Catalogo: solo aviones, con foto, precio por hora y fianza, en las pestanas Vanilla y Addon. Cada avion se clasifica solo segun su tamano.
• Planes y rentas activas.
• /hangarsilla x y z h: ajusta la postura sentada.
• /mihangar: Mi hangar (dueno y empleados).

Instalacion

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

Configuracion

• Config.Planes, Config.CatalogoInicial (Cuban 800, Duster, Mammatus, Mallard, Velum, Howard, Vestra, Shamal, Nimbus, Luxor, Miljet, Dodo y Seabreeze) y Config.Renta.
• Config.Tractor (modelo, color, operario, barra), Config.Luces, Config.Interior (props de cada tamano), Config.Devolucion y Config.Hidroaviones.
• Config.Reloj, Config.Robo, Config.Dinero, 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 195 pruebas: 168 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, dos niveles de detalle y sin caras superpuestas.