Documentación de OV PvP: arenas PvP con 11 modos y 6 mapas en el cielo

OV PvP (ov_pvp + ov_pvp_mapas)

Que hace

OV PvP pone en tu servidor FiveM un sistema completo de arenas PvP. Se vende como un solo pack con dos recursos:

• ov_pvp 3.1.0: el sistema (lobby, partidas, modos, apuestas, torneo, ranking, bots) con su interfaz en Vue.
• ov_pvp_mapas 1.1.0: 6 arenas propias en el cielo, con piezas animadas que tienen colision y se mueven igual para todos los jugadores.

El jugador escribe /pvp, elige el modo, entra al lobby, escoge equipo, arma, mapa y apuesta, y cuando todos estan listos empieza la partida. Al salir vuelve a donde estaba, con su inventario completo.

Lo mas importante:

• 11 modos:
• Duelo 1v1, 2v2, 3v3 y 6v6 por equipos.
• Free For All: todos contra todos; el pote es para el que mas bajas hace.
• Captura la Bandera: llevas la bandera enemiga a tu base; si cae, vuelve sola a los 30 segundos.
• Bomba: rondas de plantar y desactivar en los sitios A y B.
• Gun Game: 14 armas, de la pistola al francotirador pesado; cada baja sube de arma.
• One in Chamber: una bala; cada baja te da otra.
• Crime vs Crime y Police vs Crime: faccion contra faccion, hasta 20 jugadores.
• 6 arenas en el cielo (ov_pvp_mapas):
• Duelo Lima (duelo y 2v2): pilares que suben y bajan.
• Cruce Neon (2v2, 3v3, FFA, Gun Game, One in Chamber): paneles que se deslizan y tapan media calle.
• Torre OV (3v3 y 6v6): elevadores a las alas y balcones, y el logo que gira.
• Islas (FFA, duelo, 2v2, Gun Game, One in Chamber): plataformas que te llevan entre islas y elevadores.
• Fabrica OV (Bomba, 3v3, 6v6, CvC, PvC): puertas blindadas, cinta con cajas que se mueven y ventiladores.
• Coliseo OV (Captura la Bandera, 6v6, FFA, Gun Game, One in Chamber, CvC, PvC): muros que suben y bajan y corona con el logo.
• Bomba OV propia: modelo con pantalla de cuenta atras en vivo, pitido que se acelera con destello, se planta con E y se desactiva con un minijuego de termita.
• Lobby: equipos A/B, apuesta, puntos y tiempo de la partida, mapa con foto, equipamiento y bots IA para completar equipos.
• Apuestas con pote: se cobran al empezar la partida. En empate, o si el staff la termina, se devuelve lo apostado.
• HUD de partida: marcador con reloj, registro de bajas con el icono del arma y los tiros a la cabeza, rachas y el marcador completo con Enter.
• /pvphud: cada jugador mueve el marcador y el registro de bajas a su gusto (se guarda en su juego), por si tapan el HUD de tu servidor.
• Victoria y derrota con estadisticas de la partida, revancha o salir.
• Ranking por bajas, K/D y victorias (/pvptop), ELO, historial (/pvphistorial) y ranking semanal.
• Espectador: /pvpwatch para ver una partida en curso.
• Torneo World Cup: inscripcion de equipos, bracket (cuartos, semifinal y final), reglas y panel de admin para crear, iniciar, cancelar y forzar ganador.
• Inventario seguro: al entrar, el inventario se guarda en la base de datos (pvp_inv_rescate) y se devuelve al salir. Si el jugador se desconecta o el servidor se reinicia a mitad de partida, se le devuelve al volver. Con ox_inventory las armas de la partida son nativas (weaponWheel) y no se toca su inventario.
• Entrada controlada: no se entra muerto, herido ni esposado; con Config.BloquearPresos tampoco preso.
• Aparicion segura: espera a que la arena cargue antes de soltarte, y si caes al vacio te devuelve al punto. Al reaparecer elige el spawn mas lejos del enemigo y te da proteccion unos instantes.
• Compatible con 0r-ambulancejob: dentro de la arena no te da por muerto.
• Avisos en el centro de la pantalla en orden, sin pisarse.
• /pvpcoord: crea tus propias arenas caminando por el mapa y pulsando E en cada punto. Con F abres el editor y exportas a output/maps_output.lua.

Como se usa (jugadores)

1. Escribe /pvp (o pulsa E en el punto de entrada del PvP, si esta activado en Config.EntryPoint).
2. Elige el modo en el selector.
3. En el lobby elige equipo, apuesta, mapa y equipamiento, y pulsa Listo.
4. Cuando hay suficientes jugadores listos empieza la cuenta atras, luego el calentamiento (las bajas aun no cuentan) y la partida.
5. Al terminar eliges revancha o salir. Al salir vuelves a donde estabas, con tu inventario.

/leavepvp sale del lobby o de la partida.

Administracion

Staff = grupo admin o god del framework, o ACE group.admin o command.wcadmin.

• /torneoadmin: panel del torneo (crear con premio y modo 1v1, 2v2, 3v3 o 6v6; iniciar, cancelar, forzar ganador). Tambien por chat con /wcadmin crear|iniciar|cancelar|forzar|status.
• /pvpcoord: herramienta de mapas.
• /pvprescate: lista los inventarios pendientes de devolver y los devuelve a mano.
• /pvpbot: arranca una partida con bots sin pasar por el lobby.

Instalacion

1. Copia ov_pvp_mapas y ov_pvp a resources.
2. En server.cfg, despues de ox_lib, oxmysql, el framework y el inventario, anade ensure ov_pvp_mapas y en la linea siguiente ensure ov_pvp. ov_pvp_mapas va antes que ov_pvp.
3. Las tablas (pvp_stats, pvp_match_history, pvp_inv_rescate y las del ranking semanal) se crean solas.
4. Opcional: add_ace group.admin command.wcadmin allow.
5. La primera vez, haz un reinicio completo del servidor para que carguen los modelos de las arenas.
6. Si reinicias las arenas con restart ov_pvp_mapas, despues escribe ensure ov_pvp: al parar las arenas tambien se para ov_pvp, y restart de un recurso parado no hace nada.

Configuracion

• ov_pvp/config.lua:
• Config.Idioma ('es', 'en' o 'pt'), Config.Framework y Config.Inventario ('auto' por defecto).
• Config.Marca: logo de los menus (el de Otra Vida, tu PNG en html/images/ o sin logo) y el nombre de los textos ("Arenas Otra Vida", "OTRA VIDA WORLD CUP"), o sin nombre.
• Config.Hud: posicion del marcador y del registro de bajas para todos, y el comando para que cada jugador los mueva.
• Config.Modes y Config.ModeOrder (modos, jugadores, puntos, tiempo, tipo de reaparicion), Config.ModeWeapons, Config.LoadoutHpArmor, Config.GunGameWeapons y Config.OICWeapon.
• Config.MinBet, Config.MaxBet, Config.DefaultBet, Config.ScoreOptions y Config.TimeOptions.
• Config.CTF y Config.Bomb (tiempos, dificultad de la termita y pago al equipo ganador).
• Config.BloquearPresos, Config.EntryPoint (punto de entrada con blip), Config.Staging, Config.Victory, Config.Elo, Config.WarmupDuration y Config.ReconnectWindowSec.
• ov_pvp_mapas/config.lua:
• OVPConfig.Logos: mostrar = false deja lisos los paneles del logo y quita las piezas que solo son logo; imagen = 'logo.png' pone tu PNG (cuadrado, 512 x 512) en los mismos sitios, sin modelos nuevos.

Idiomas y frameworks

• Tres idiomas (es, en, pt) en el script y en la interfaz.
• QBCore, Qbox y ESX, detectados solos.
• Inventarios: ox_inventory, qs-inventory, origen_inventory, qb-inventory y el de ESX.

Requisitos

ox_lib, oxmysql, QBCore/Qbox/ESX y un inventario compatible. ov_pvp_mapas viene en el pack.

Opcional: el ranking semanal puede entregar un premio en moneda por una API de monedero propia (convar ov_pvp_bridge_key); sin ella el ranking funciona igual, sin premio automatico.

Preguntas frecuentes

• Pierdo mi inventario si se cae el servidor en mitad de una partida? No. Se guarda en la base de datos al entrar y se devuelve al volver a conectar.
• Puedo usar mis propios mapas? Si. Con /pvpcoord creas arenas en cualquier sitio del mapa y se guardan en output/maps_output.lua.
• Puedo quitar la marca Otra Vida? Si: Config.Marca en los menus y OVPConfig.Logos en las arenas.
• El marcador tapa el HUD de mi servidor. Muevelo para todos con Config.Hud, o cada jugador con /pvphud.
• Reinicie ov_pvp_mapas y el PvP no vuelve. Escribe ensure ov_pvp.

Estado

ov_pvp 3.1.0 y ov_pvp_mapas 1.1.0. Las imagenes de la interfaz son de la vista previa del navegador con datos de muestra; las de las arenas son renders del modelo 3D.