Documentación de OV Water: agua, olas y tsunami

OV Water: agua, olas y tsunami (ov_water_edit)

Que hace

ov_water_edit te da un panel de administrador para controlar el agua del mapa de GTA V y un tsunami completo. El panel (/agua) es propio, con la marca Otra Vida, y no usa ox_lib. Con el cambias el oleaje, las olas por zona, la marea y la claridad, aplicas ajustes rapidos y lanzas un tsunami que ven todos los jugadores.

Lo mas importante:

• Panel /agua con cinco pestanas: Oleaje, Olas por zona, Marea y claridad, Tsunami y Ajustes rapidos. Los cambios se aplican a todos los jugadores y se guardan en data/agua.json.
• Tsunami por etapas: Aviso, Retirada, Ola, Inundado y Baja, con una alerta grafica y un reloj.
• Aviso: alerta en pantalla y sirena con volumen bajo (ajustable) que sigue sonando unos segundos cuando empieza la ola.
• Retirada: el mar se retira hasta 15 m y desaparece dejando el fondo al descubierto hasta que llega la ola (se puede apagar).
• Ola: ola 3D propia, con espuma y opaca, en tres tamanos (cresta de 11,6 m, 20,8 m y 34,7 m). Tiene colision de cajas con banderas comprobadas en los binarios.
• Inundacion real: 408 cuadros de agua de 500 m cargados desde un water.xml extra. Suben por zonas con una demora segun la velocidad y la direccion de la ola.
• Baja: el agua vuelve sola a su nivel.
• Fisica: los vehiculos, los objetos sueltos y los NPC flotan y la corriente los arrastra. El agua apaga los motores muy hundidos.
• Golpe de la cresta: lanza a jugadores, NPC, coches (barcos incluidos) y objetos. Se ajusta con Potencia del golpe (de 0 a 5) y la opcion Golpe sin dano protege al jugador unos 10 s.
• Color natural del mar: 408 mosaicos waterfog repintados y los canales de Vespucci repintados.
• Ajustes rapidos: Normal, Calma total, Mar picado, Tormenta, Hora de surf, Marea alta y Marea baja.

Clima de tormenta

Durante el tsunami el cielo se pone tenebroso: nublado en el aviso, niebla cuando el mar se retira, tormenta con la ola y lluvia mientras esta inundado. Al terminar vuelve el clima de antes. Funciona con OV Clima y con qb-weathersync (y copias que lo declaren); con cualquier otro sistema de clima hay un modo local que no depende de ningun script. Se elige en shared/config.lua y se activa o apaga desde el panel.

Como se usa

1. Escribe /agua (hace falta permiso de administrador).
2. Ajusta el oleaje, las olas por zona o la marea; el cambio lo ven todos los jugadores.
3. Para un tsunami, abre la pestana Tsunami, elige la altura, el aviso previo, la velocidad y de donde viene la ola, y pulsa Lanzar tsunami. Hay que pulsar dos veces porque lo veran todos.
4. Con Cancelar tsunami el agua baja sola.

Comandos y permisos

• /agua: abre el panel.
• /aguaprueba [metros] [segundos]: sube el agua un rato y la devuelve.
• /aguaola [s|m|l]: pone una ola quieta delante de ti, con colision, durante 40 s.
• /aguagolpe [metros] [impacto]: lanza lo que haya a tu alrededor como si pasara la cresta.
• /aguatipo [0-4]: cambia el tipo del cuadro de agua donde estas; sin numero lo devuelve.
• /aguadiag, /aguaquad y /aguacarga: informan de los cuadros de agua y de los mosaicos cargados.

Permisos (ACE): ov_water.admin, command.agua o group.admin, editables en Config.Permisos. Los comandos de prueba piden permiso al servidor y valen en F8 y en el chat.

Instalacion

1. Copia ov_water_edit a resources y anade ensure ov_water_edit.
2. Haz un reinicio completo del servidor la primera vez, para que carguen los modelos.
3. Si no usas group.admin, da el permiso: add_ace group.<tu_grupo> ov_water.admin allow.
4. Entra al juego y escribe /agua.

Configuracion

• Config.Permisos y Config.Comando.
• Config.Limites y Config.Defecto, con los limites y los valores iniciales del oleaje, las zonas y la marea.
• Config.Presets, con los ajustes rapidos.
• Config.Tsunami, con los limites y los valores por defecto del tsunami.

shared/config.lua y data/ son editables.

Requisitos

• Compatible con todos los frameworks (QBCore, Qbox, ESX y los demas): no depende de ninguno ni de ox_lib. Los permisos son ACE del servidor.

OneSync y una version actual de FiveM con las natives de agua (GetWaterQuad*, SetWaterQuad*, LoadWaterFromPath). No necesita ox_lib ni framework.

Limites

• La inundacion es una lamina plana por cuadro: solo se inunda el terreno que queda por debajo de la altura elegida.
• La retirada del mar y la marea tienen limites seguros, porque valores mayores dejan bandas negras en el horizonte.

Estado

Version 2.1.0. Verificado en el juego: inundacion real con casas bajo el agua, ola 3D con espuma solida, golpe a NPC, coches y objetos, canales de Vespucci recoloreados, alerta y sirena. Pruebas automaticas incluidas: 4683 de la logica del tsunami, 56 del servidor y 152 del cliente con simulador.