Deshabilitar el elemento Puente en la pantalla de carga de FiveM

Este tutorial explica cómo eliminar el puente de la pantalla de carga del servidor FiveM
creando o modificando un recurso de pantalla de carga.

Prerrequisitos

Acceso al servidor FiveM con permisos de modificación de recursos
Comprensión básica de HTML/CSS
un editor de texto como Bloc de notas++ (o el bloc de notas predeterminado de Windows)

Método 1: Crear un nuevo recurso de pantalla de carga

Paso 1: Crear la estructura de recursos

loadingscreen/
├── fxmanifest.lua
├── index.html
└── style.css

Paso 2: Configurar fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

author 'YourName'
description 'Custom Loading Screen - Bridge Disabled'
version '1.0.0'

loadscreen 'index.html'
loadscreen_cursor 'yes'

files {
 'index.html',
 'style.css'
}

Paso 3: Crear index.html

<!DOCTYPE html>
<html>
<head>
 <link rel="stylesheet" href="style.css">
</head>
<body>
 <div id="loading-container">
 <h1>Server Name</h1>
 <div class="progress-bar">
 <div class="progress-fill"></div>
 </div>
 </div>
 
 <script>
 // Disable bridge overlay
 window.addEventListener('DOMContentLoaded', () => {
 const bridge = document.querySelector('.bridge-overlay');
 if (bridge) bridge.remove();
 });
 
 // Handle loading progress
 window.addEventListener('message', (e) => {
 if (e.data.eventName === 'loadProgress') {
 const fill = document.querySelector('.progress-fill');
 fill.style.width = e.data.loadFraction * 100 + '%';
 }
 });
 </script>
</body>
</html>

Paso 4: Agregar a server.cfg

ensure loadingscreen

Método 2: Modificar la pantalla de carga existente

Paso 1: Localizar el recurso de la pantalla de carga actual Controlar server.cfg para líneas que comienzan con ensure o start que contiene “cargando” o “pantalla de carga”

Paso 2: Agregar código de eliminación del puente Insertar en el archivo HTML existente antes de cerrar </body> etiqueta:

<script>
 // Remove bridge on load
 document.addEventListener('DOMContentLoaded', function() {
 const bridgeElements = document.querySelectorAll(
 '.bridge-overlay, #bridge, [class*="bridge"]'
 );
 bridgeElements.forEach(el => el.style.display = 'none');
 });
 
 // Backup removal for dynamically loaded elements
 const observer = new MutationObserver((mutations) => {
 mutations.forEach((mutation) => {
 mutation.addedNodes.forEach((node) => {
 if (node.nodeType === 1 && 
 (node.classList?.contains('bridge-overlay') || 
 node.id === 'bridge')) {
 node.remove();
 }
 });
 });
 });
 
 observer.observe(document.body, {
 childList: true,
 subtree: true
 });
</script>

Método de anulación de CSS

Añade al archivo CSS de tu pantalla de carga:

.bridge-overlay,
#bridge,
[class*="bridge-"] {
 display: none !important;
 visibility: hidden !important;
 opacity: 0 !important;
}

Solución de problemas

Puente aún visible:

Borrar caché del servidor: Eliminar cache/ carpeta
Verificar el orden de carga de recursos en server.cfg
Compruebe la consola del navegador (F12) para detectar errores de JavaScript

La pantalla de carga no aparece:

Confirmar loadscreen directiva en fxmanifest.lua
Verificar que las rutas de los archivos coincidan exactamente (distingue entre mayúsculas y minúsculas)
Compruebe la consola del servidor para detectar errores de recursos

Notas técnicas

Las pantallas de carga de FiveM se ejecutan en CEF (Chromium Embedded Framework)
Elemento de puente normalmente inyectado por mecanismos de carga predeterminados
MutationObserver garantiza la eliminación de elementos agregados dinámicamente

Incertidumbres

Los nombres exactos de las clases de elementos de puente pueden variar entre las versiones de FiveM
Algunos marcos personalizados pueden usar diferentes implementaciones de superposición

Resumen: Elimine la superposición del puente de FiveM creando un recurso de pantalla de carga personalizado con JavaScript que apunta y elimina los elementos del puente durante la carga de la página.

Cómo crear una pantalla de carga personalizada

Lista de verificación práctica

Utilice esta guía como lista de verificación antes de modificar un servidor FiveM en producción. Confirme la versión actual del artefacto del servidor, la versión del framework, las dependencias de recursos, los cambios en la base de datos y cualquier archivo del lado del cliente antes de aplicar el cambio.

Realice una copia de seguridad de los archivos de configuración y las tablas de la base de datos afectados.
Primero, aplique el cambio en un servidor de prueba.
Supervise la consola del servidor y la consola F8 del cliente para detectar errores.
Comprueba si el cambio afecta a los trabajos, el inventario, los vehículos, los mapas, la voz, los permisos o los datos del jugador.
Documente el archivo, comando o configuración exactos que modificó para que se puedan revertir rápidamente.

Pruebas previas a la producción

Tras la primera prueba, inicia sesión con una cuenta de jugador normal y repite el proceso desde la perspectiva del jugador. Si el tema está relacionado con el rendimiento, realiza mediciones antes y después con el mismo número de jugadores, ruta y conjunto de recursos. Si se trata de herramientas o permisos de administrador, verifica tanto a los usuarios autorizados como a los denegados.

Errores comunes

La mayoría de los problemas de FiveM se deben a dependencias faltantes, caché obsoleta, nombres de carpeta incorrectos, incompatibilidad de framework o configuración copiada de otro servidor. Evite modificar varios sistemas a la vez; realice un cambio, pruébelo y luego continúe.

Recursos relacionados

Para obtener recursos listos para la producción, compare los recursos de pago en el Tienda FiveMX. Para obtener recursos gratuitos, navegue Recursos de FiveM y pruebe cada recurso antes de usarlo públicamente.

Notas sobre el lanzamiento de la producción

Antes de usar esta guía en un servidor FiveM en vivo, define el resultado exacto que esperas del cambio. Para Deshabilitar Elemento Puente en la Pantalla de Carga de FiveM, eso significa verificar qué recurso, configuración, comando o flujo de trabajo se ve afectado y confirmar que el cambio se ajusta a tu framework actual, versión del artifact y reglas del servidor. Mantén la implementación lo suficientemente pequeña como para poder revertirla rápidamente si los jugadores reportan errores.

Utilice un servidor de pruebas con la misma estructura, esquema de base de datos, orden de recursos y dependencias clave que el servidor de producción. Si el problema afecta la jugabilidad, los permisos, los gráficos, el audio, los vehículos, los mapas, el inventario o el comportamiento económico, realice pruebas con al menos una cuenta de administrador y una cuenta de jugador normal. Observe la salida de la consola del servidor, los registros F8 del cliente y la temporización de los recursos mientras reproduce el flujo de jugadores exacto que se producirá en el servidor en producción.

Lista de verificación de reversión

Guarde el archivo de configuración anterior, la carpeta de recursos y el estado de la base de datos antes de realizar cualquier cambio.
Anota la versión del recurso, la confirmación, la página de descarga o el valor de configuración que hayas probado.
Reinicia primero solo el recurso afectado, si es posible, y luego reinicia el servidor completo si las dependencias lo requieren.
Si aparecen errores, revierta el único recurso o configuración que haya cambiado antes de probar otra solución.

Guía de mantenimiento

Revise esta configuración nuevamente después de las actualizaciones de artefactos FiveM, actualizaciones del marco de trabajo o cambios importantes en los recursos. Una configuración que funciona hoy puede dejar de funcionar después de actualizaciones de dependencias, exportaciones renombradas, eventos modificados o migraciones de bases de datos. Conserve notas junto con la documentación de su servidor para que los futuros administradores comprendan qué se modificó, por qué se modificó y cómo verificarlo nuevamente.

Revisión en curso

Vuelve a verificar Deshabilitar Elemento Puente en la Pantalla de Carga de FiveM después de actualizaciones importantes del artifact de FiveM, cambios de framework o migraciones de recursos. Confirma que el consejo aún coincida con el comportamiento actual del servidor, que cualquier fuente enlazada siga disponible y que los pasos de instalación aún coincidan con los archivos que un propietario de servidor realmente descargará o configurará.

Para servidores públicos, mantén un breve registro de cambios junto a la documentación del servidor. Indica qué se probó, qué se modificó, qué cuentas se usaron para la verificación y cómo revertir los cambios. Esto agiliza el mantenimiento futuro y evita que las notas de configuración antiguas se vuelvan confusas o inseguras para los jugadores.