Documentación de Televisores con video y pantallas 3D de cualquier tamaño

OV TV (ov_tv)

Qué hace

ov_tv pone televisores con video en tu servidor FiveM. Los jugadores colocan, mueven, rotan y escalan con Gizmo, en cualquier parte, televisores de GTA y pantallas 3D flotantes de cualquier tamaño. Cada cliente crea un solo reproductor, que se sincroniza con el reloj del servidor: todos ven el mismo fotograma. Las pantallas tienen animaciones propias, un menú de control con interfaz propia y un panel de administración. La marca (nombre, logos, imágenes, colores y tipografías) se cambia por pack, sin tocar el código.

Lo más importante:

• Coloca, mueve y rota con Gizmo: /tvcolocar abre el catálogo con las medidas reales de cada pantalla. Se apunta (fantasma transparente), se fija con E y el Gizmo permite afinar posición y giro; para volver a editarla, target Mover / Rotar, tecla G o /tvmover.
• Pantallas 3D de cualquier tamaño: paneles de video flotantes, sin prop, de 0,5 a 20 m de ancho, con posición, giro, inclinación y escala. Ideales para pantallas gigantes, fachadas y huecos sin modelo.
• Un solo reproductor por cliente: se crea para la pantalla más cercana y se destruye al alejarse. Un render target solo muestra un modelo a la vez; si hay otra pantalla igual cerca, el servidor asigna un modelo alterno con la misma medida.
• Catálogo de 191 modelos del juego base con tamaño real de la pantalla, rango UV, espejo y giro, y reproductor recomendado, verificados en los binarios. Con Config.TvsDelMapa el staff controla los televisores que ya están en el mapa.
• Pantallas animadas propias: reposo con la marca del servidor, arranque, cambio de canal, apagado, overlays de canal y de volumen, carta de ajuste y canal Cine.
• Video seguro: solo http o https con lista de dominios (vacía por defecto); sin IP, localhost, usuario ni puerto. Se valida en el servidor, en el cliente y en la página del reproductor.
• Menú de control con interfaz propia (encender, volumen, canales, dirección de video, calidad y silencio por distancia) y panel de administración /ovtv.
• Marca personalizable por pack: config/marca.lua y personalizar/<pack>/. Incluye un pack neutro y uno de ejemplo.
• Items para ox_inventory con icono: televisor de cine, plano grande, de dormitorio y panorámico. También se puede colocar sin item.
• Permisos y límites: límite por jugador y por propiedad, dueño con un hook configurable (por ejemplo tu recurso de casas), ACE ovtv.admin y rate limit. Funciona dentro de instancias.
• Español, inglés y portugués; QBCore, Qbox y ESX.

Cómo se usa (jugadores)

1. Escribe /tvcolocar, elige el modelo y apunta donde la quieras.
2. E fija; en el Gizmo arrastra las flechas para mover y el anillo para girar (R cambia de modo, ENTER guarda).
3. Acércate y pulsa E (o el target) para abrir el menú de control: enciende, elige un canal y sube el volumen.
4. Para cambiarla de sitio usa el target Mover / Rotar (o G); para quitarla, Recoger televisor.

Administración

• /ovtv (ACE ovtv.admin): lista de todas las pantallas con buscador; encender, apagar, reiniciar y eliminar.
• shared/config.lua: modelos y medidas, canales, lista de dominios, límites y permisos de colocación, pantallas 3D y televisores del mapa.
• config/marca.lua y personalizar/<pack>/: la marca del servidor (guía en docs/PERSONALIZAR.md).

Instalación

1. Copia ov_tv a resources y añade ensure ov_tv después de ox_lib (y de ox_inventory y del target si los usas).
2. add_ace group.admin ovtv.admin allow.
3. Items (opcional): copia icons/*.png a ox_inventory/web/images y pega ejemplos/ox_inventory_items.lua en data/items.lua.
4. Si la interfaz no abre la primera vez, reinicia el recurso dos veces y borra la caché del cliente.