Risoluzione dei problemi

Sempre per prima cosa: leggi la console del server e la console F8 del client. La maggior parte dei problemi stampa qualcosa.

Una funzione non fa niente

La resource è ensured? Ogni cartella di [beyond] ha bisogno della sua riga ensure in server.cfg. Scrivi ensure bs_vip (o quella che è) nella console e guarda se parte o dà errore. Era la causa di “menu VIP F7 non implementato” una volta, il codice era a posto, semplicemente non partiva mai.

Niente chat / i comandi non funzionano

Non hai né chat né bs_chat in esecuzione, oppure li hai entrambi. Esegui esattamente uno. bs_chat sostituisce la chat predefinita e mantiene gli stessi eventi, quindi a nient’altro importa quale sia.

Zombie invisibili, o “teleport to zombie” atterra nel nulla

Due cause abituali:

1. Un modello zombie personalizzato che non va in streaming. Se fxserver.log dice qualcosa come

   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

   il modello è troppo grande, il gioco non lo carica mai e il server pensa che esistano vaganti che nessun client ha disegnato. Correggi l’asset (texture compresse con mipmap, 1024 o 2048, ben sotto i 16 MB per file) oppure non avviare il pack. Senza ottieni il modello zombie del gioco base, che funziona.
2. Problema della modalità in rete. Esegui /znet e /zsync. Se il server ha vaganti vicino a te ma il tuo client non ne ha nessuno, prova Zombies.Mode = 'legacy' e riavvia bs_zombies. Poi mandami l’output.

Strisciatori che si rialzano: nutria_crawl_anims non è avviato, o è avviato dopo bs_zombies.

Zombie silenziosi

bs_zombiesfx non è in esecuzione. Nota che sostituisce i suoni di dolore di tutti i ped, giocatori compresi. È noto.

Crash del client

• Attiva i crumbs (sono attivi di default: Config.Crumbs.enabled = true in bs_core). Dopo un crash, l’avvio successivo stampa [crumbs] last session: in F8 con le ultime 40 cose accadute. /bs_crumbs stampa la sessione corrente. Mandami quello, è molto più utile di “è crashato”.
• Crash durante il caricamento / errori “256 pool”: di solito lo streaming della mappa. Vedi Prestazioni, le dimensioni dei pool e gli extent della mappa.
• Assicurati che il client sia sulla build imposta dal server (3095).

Errori di console che vedrai

callback "x" timed out after 10000ms - la resource proprietaria di quel callback non è in esecuzione, oppure è andata in errore. I callback sono trasmessi in broadcast e risponde solo il proprietario, quindi un proprietario mancante dà un timeout, non un errore. Trova chi lo registra nel riferimento API.

callback "x" errored: ... - l’handler del server ha lanciato un errore. Il resto della riga è il vero errore Lua.

[BS SERVICES] ... - una resource ha richiesto un servizio (BS.Use) il cui provider manca o non esporta ciò che aveva promesso. Controlla che il provider parta prima del consumatore.

Spam di MUMBLE_ADD_VOICE_CHANNEL_LISTEN: Tried to call native on a channel that didn't exist - pma-voice. Per questo è disattivato nel cfg predefinito.

Could not find resource mapmanager / spawnmanager - hai degli ensure per resource di cfx-server-data che non hai. Rimuovili, non ci servono.

ox_lib fallisce e si porta dietro ac_radio - hai lo zip dei sorgenti GitHub di ox_lib. Prendi lo zip di release, ha web/build/.

I giocatori non riescono ad aprire F1 / F10

Il loro identificatore non è in un gruppo con bs.admin. Controlla dalla console:

test_ace identifier.license:xxxx bs.admin

L’anti-cheat segnala lo staff o uno script

Lo staff è esente tramite ACE. Uno script che teletrasporta i giocatori deve chiamare exports.bs_guard:Allow(src, 'teleport', ms). Vedi Anti-cheat.

Una UI è rimasta bloccata con il mouse visibile

Un pannello ha aperto il focus NUI e non l’ha chiuso. Scrivi prima /refreshui, chiude ogni pannello e rilascia il focus. Se non basta, riavvia la resource proprietaria del pannello. Se è riproducibile, dimmi quale pannello, ogni pannello dovrebbe abbinare bs:ui:opened a bs:ui:closed a ogni uscita.

Il login al database fallisce dopo un aggiornamento

Se usi db.cfg, controlla che sia ancora accanto a server.cfg e che server.cfg abbia ancora exec db.cfg. Un git pull non tocca mai db.cfg, ma copiare un server.cfg nuovo sopra il tuo può far sparire la riga exec. Vedi Ricetta e deploy su VPS.

Nessun veicolo del mondo

• Vehicles.World.enabled è false, oppure la migrazione 029_vehicle_world.sql non è stata eseguita (controlla bs_migrations).
• Si riempiono solo al riavvio del server, e fanno spawn solo su punti stradali lontani dai giocatori e fuori dalle zone sicure. Fai un giro, compaiono a 260-650 metri.
• Un modello in Vehicles.World.pool che non esiste sul tuo server non fa mai spawn. Controlla la console F8.

Non si monta un pezzo, l’auto non parte

Le auto del mondo partono senza batteria, candela e serbatoio. Datti gli oggetti da F10 > ITEMS per provare, poi usa la ruota del veicolo (G).

La lingua non cambia

• La resource non ha ancora quel file di lingua, quindi ripiega sull’inglese. Per ora è previsto.
• Una resource che hai scritto non include @bs_core/shared/sh_locale.lua o non elenca locales/*.lua in files. Vedi Lingue.

Il menu tester F4 non si apre

bs_tester non è in ensure, o il giocatore non ha accesso tester. Gli admin ce l’hanno sempre, gli altri hanno bisogno dell’interruttore TESTER in F10 > PLAYERS.

Migrazione “mai eseguita”

Il file non è nella lista fissa in bs_core/server/sv_migrations.lua. Vedi Migrazioni del database.