Solución de problemas

Siempre lo primero: lee la consola del servidor y la consola F8 del cliente. La mayoría de los problemas imprimen algo.

Una función no hace nada

¿El resource tiene ensure? Cada carpeta de [beyond] necesita su propia línea ensure en server.cfg. Escribe ensure bs_vip (o el que sea) en la consola y mira si arranca o da error. Esa fue una vez la causa de “menú VIP F7 no implementado”, el código estaba bien, simplemente nunca arrancaba.

No hay chat / los comandos no funcionan

No tienes ni chat ni bs_chat en marcha, o tienes los dos. Ejecuta exactamente uno. bs_chat sustituye al chat de serie y mantiene los mismos eventos, así que a nada más le importa cuál sea.

Zombis invisibles, o “teleport to zombie” aterriza en la nada

Dos causas habituales:

1. Un modelo de zombi personalizado que no hace streaming. Si fxserver.log dice algo como

   Asset bs_zombiepeds/u_m_y_zombie_01.ydd uses 64.0 MiB of virtual memory.
   Oversized assets can and WILL lead to streaming issues

   el modelo es demasiado grande, el juego nunca lo carga y el servidor cree que existen caminantes que ningún cliente dibujó. Arregla el asset (texturas comprimidas con mipmaps, 1024 o 2048, muy por debajo de 16 MB por archivo) o no inicies el pack. Sin él obtienes el modelo de zombi del juego base, que funciona.
2. Problema del modo en red. Ejecuta /znet y /zsync. Si el servidor tiene caminantes cerca de ti pero tu cliente no tiene ninguno, prueba Zombies.Mode = 'legacy' y reinicia bs_zombies. Luego envíame la salida.

Crawlers que se levantan: nutria_crawl_anims no está iniciado, o se inicia después de bs_zombies.

Zombis en silencio

bs_zombiesfx no está en marcha. Ten en cuenta que reemplaza los sonidos de dolor de todos los peds, jugadores incluidos. Es algo conocido.

Cierres del cliente

• Activa los crumbs (vienen activados: Config.Crumbs.enabled = true en bs_core). Tras un cierre, el siguiente arranque imprime [crumbs] last session: en F8 con las últimas 40 cosas que pasaron. /bs_crumbs imprime la sesión actual. Envíame eso, es mucho más útil que “se cerró”.
• Cierre al entrar / errores “256 pool”: normalmente es el streaming del mapa. Mira Rendimiento, los tamaños de pool y los extents del mapa.
• Asegúrate de que el cliente está en la build que impone el servidor (3095).

Errores de consola que verás

callback "x" timed out after 10000ms - el resource dueño de ese callback no está en marcha, o dio error. Los callbacks se difunden y solo responde el dueño, así que un dueño ausente da timeout, no error. Busca quién lo registra en la referencia de la API.

callback "x" errored: ... - el handler del servidor lanzó un error. El resto de la línea es el error real de Lua.

[BS SERVICES] ... - un resource pidió un servicio (BS.Use) cuyo proveedor falta o no exporta lo que prometió. Comprueba que el proveedor arranca antes que el consumidor.

Spam de MUMBLE_ADD_VOICE_CHANNEL_LISTEN: Tried to call native on a channel that didn't exist - pma-voice. Por eso está desactivado en el cfg por defecto.

Could not find resource mapmanager / spawnmanager - tienes ensures de resources de cfx-server-data que no tienes. Quítalos, no los necesitamos.

ox_lib falla y arrastra a ac_radio - tienes el zip del código fuente de GitHub de ox_lib. Consigue el zip de release, tiene web/build/.

Los jugadores no pueden abrir F1 / F10

Su identificador no está en un grupo con bs.admin. Compruébalo en la consola:

test_ace identifier.license:xxxx bs.admin

El anti-cheat marca al staff o a un script

El staff está exento por ACE. Un script que teletransporta jugadores tiene que llamar a exports.bs_guard:Allow(src, 'teleport', ms). Mira Anti-cheat.

Una UI se quedó atascada con el ratón visible

Algún panel abrió el foco NUI y no lo cerró. Escribe primero /refreshui, cierra todos los paneles y suelta el foco. Si eso no lo arregla, reinicia el resource dueño del panel. Si es reproducible, dime qué panel, se supone que cada panel empareja bs:ui:opened con bs:ui:closed en cada salida.

Falla el login de la base de datos tras una actualización

Si usas db.cfg, comprueba que sigue junto a server.cfg y que server.cfg todavía tiene exec db.cfg. Un git pull nunca toca db.cfg, pero copiar un server.cfg nuevo encima del tuyo puede quitar la línea exec. Ver Receta y despliegue en VPS.

No hay vehículos de mundo

• Vehicles.World.enabled es false, o la migración 029_vehicle_world.sql no se ejecutó (revisa bs_migrations).
• Solo se rellenan al reiniciar el servidor, y solo hacen spawn en puntos de carretera lejos de los jugadores y fuera de las zonas seguras. Da una vuelta, aparecen a 260 a 650 metros.
• Un modelo de Vehicles.World.pool que no existe en tu servidor nunca hace spawn. Mira la consola F8.

No se puede montar una pieza, el coche no arranca

Los coches del mundo empiezan sin batería, bujía ni depósito de combustible. Dáte los objetos desde F10 > ITEMS para probar y luego usa la rueda del vehículo (G).

El idioma no cambia

• El resource aún no tiene ese archivo de idioma, así que vuelve al inglés. Es lo esperado por ahora.
• Un resource que has escrito no incluye @bs_core/shared/sh_locale.lua o no lista locales/*.lua en files. Ver Idiomas.

El menú de tester F4 no se abre

bs_tester no está en ensure, o el jugador no tiene acceso de tester. Los admins siempre lo tienen, los demás necesitan el interruptor TESTER en F10 > PLAYERS.

Migración “nunca se ejecutó”

El archivo no está en la lista fija de bs_core/server/sv_migrations.lua. Ver Migraciones de la base de datos.