Documentación de Globo aerostatico con salto en paracaidas

Otra Vida Globo (ov_globo)

Que hace

ov_globo pone en tu servidor FiveM un globo aerostatico gigante como atraccion. Los jugadores compran el boleto en una caseta OV, suben a la canasta por sus puertas, el globo sube hasta el cielo y desde arriba saltan en paracaidas. Lo colocas donde quieras con un creador para administradores, con su plataforma, su caseta y su precio. El modelo 3D es propio, con colision en cada pieza, y trae cinematicas de despegue y de salto.

Lo mas importante:

• Salidas automaticas por fases, sin que nadie las maneje:
• Abordaje (90 s): las puertas se abren y se pueden comprar boletos y subir.
• Subida (150 s): el globo sube con las llamas del quemador hasta la altura maxima.
• Arriba (40 s): todos saltan en paracaidas; al final se lanza a quien quede.
• Bajada (120 s): el globo baja vacio y se prepara para la proxima salida.
• Los tiempos se editan en Config.Tiempos. El servidor manda la fase, asi que todos ven el globo a la misma altura.
• Altura: sube hasta 1800 m sobre el nivel del mar (Config.Altura). Si el puesto esta muy alto, sube al menos 600 m sobre la plataforma (Config.SubidaMinima).
• Boleto y cupo: boleto por persona (2500 por defecto, cada globo puede tener el suyo) y cupo de 10 pasajeros por salida. Sin boleto no se sube; si el globo sale sin ti, el boleto vale para la proxima salida.
• Paracaidas OV: se entrega al comprar el boleto. Deja una estela de humo lima. Si no lo abres, se abre solo al bajar de 200 m sobre el suelo.
• Cinematicas y panel de vuelo:
• Despegue en tres planos (se salta con X).
• Panel con altitud, velocidad, barra de progreso hasta la cima y cuenta atras del salto.
• Mensaje al llegar al cielo, cuenta regresiva 3, 2, 1 y salto en camara lenta.
• Caseta OV: oficina amueblada con props de GTA, puerta real, agente sentado que saluda al acercarte y pantallas en vivo en la caseta y en el totem (proxima salida, cuenta atras, precio y cupo).
• Plataforma con neon lima y logo.
• Creador /globoadmin con fantasma transparente: apuntas con la camara, giras con las flechas y eliges nombre y precio.
• Marca propia: con Config.Marca.logo tu logo sale en la lona, en la plataforma, en las placas de la caseta y en las pantallas.
• Dinero: se cobra en efectivo y, si no alcanza, del banco. Lo cobrado puede ir al Fondo de la ciudad (Config.Dinero).

Como se usa (jugadores)

1. Ve a un puesto Globo OV (icono en el mapa).
2. Acercate al totem (E) para ver el estado de la salida y comprar el boleto, o habla con el agente en la ventanilla (E).
3. Compra el boleto: recibes tambien tu paracaidas.
4. Entra a la canasta por una de las puertas antes de que se cierren.
5. Disfruta el despegue y la subida.
6. Arriba pulsa E para saltar. Cuenta 3, 2, 1, cae libre y abre el paracaidas.

Administracion

• /globoadmin (permiso command.globoadmin; por defecto group.admin):
• Crear un globo aqui: apuntas con la camara donde va la plataforma (flechas izquierda y derecha giran, con Shift mas rapido; arriba y abajo suben o bajan; E confirma). Despues colocas la caseta, con la ventanilla mirando al globo, y escribes el nombre y el precio del boleto.
• Por cada globo: ir al puesto, cambiar nombre y precio, mover el globo con su plataforma, mover la caseta, pasar a la siguiente fase (para pruebas) y borrarlo.
• Los globos se guardan en data/puestos.json. Si borras ese archivo, al arrancar se vuelven a crear los de Config.PuestosIniciales.
• No se puede mover un globo que no esta en tierra, ni borrar uno con pasajeros a bordo.

Instalacion

1. Copia ov_globo a resources y anade ensure ov_globo despues de ox_lib y de tu framework.
2. Requiere ox_lib y OneSync.
3. Si no usas group.admin, da el permiso: add_ace group.<tu_grupo> command.globoadmin allow.
4. La primera vez, haz un reinicio completo del servidor para que carguen los modelos.
5. Crea tu primer globo con /globoadmin.

Configuracion

• Config.Tiempos, Config.Altura, Config.SubidaMinima, Config.Cupo, Config.Precio y Config.Moneda.
• Config.Cuentas, con el orden de cobro, y Config.Dinero para el Fondo de la ciudad.
• Config.Admin (comando y grupo), Config.PuestosIniciales y Config.CasetaNueva.
• Config.Marca (logo propio y titulo de las pantallas), Config.Blip, Config.Pantalla y Config.Avisos.
• Config.Oficina, Config.Puerta, Config.Npc y Config.Silla para la caseta.
• Config.DistanciaVer y Config.DistanciaPuesto, para que el globo no pese cuando estas lejos.

Idiomas y frameworks

• QBCore, Qbox y ESX, detectados solos (Config.Framework = 'auto').
• Textos en espanol.

Requisitos

OneSync, ox_lib y QBCore, Qbox o ESX.

Opcional: sbr-presidentes u otro recurso con DepositFunds para mandar lo cobrado al Fondo de la ciudad.

Estado

Version 1.0.1. Probado con 58 pruebas automaticas: 33 de la logica (alturas, giros, canasta y puesto) y 25 del servidor (permisos, validaciones, guardado, compra, mover, editar y borrar). El modelo 3D tiene colision con flags en cada pieza.