Rozwiązywanie problemów

Zawsze najpierw: przeczytaj konsolę serwera i konsolę F8 klienta. Większość problemów coś wypisuje.

Funkcja w ogóle nic nie robi

Czy resource jest ensured? Każdy folder [beyond] potrzebuje własnej linii ensure w server.cfg. Wpisz w konsoli ensure bs_vip (albo co tam masz) i zobacz, czy wystartuje, czy zwróci błąd. To była kiedyś przyczyna “menu VIP pod F7 nie zaimplementowane”, kod był w porządku, po prostu nigdy się nie uruchamiał.

Brak czatu / komendy nie działają

Nie działa ani chat, ani bs_chat, albo działają oba. Uruchom dokładnie jeden. bs_chat zastępuje standardowy czat i zachowuje te same eventy, więc nic innego nie dba o to, który to jest.

Zombie niewidzialne albo “teleport to zombie” ląduje w pustce

Dwie typowe przyczyny:

1. Własny model zombie, który się nie streamuje. Jeśli fxserver.log mówi coś w stylu

   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

   model jest za duży, gra nigdy go nie ładuje, a serwer myśli, że istnieją szwendacze, których żaden klient nie narysował. Napraw asset (skompresowane tekstury z mipmapami, 1024 lub 2048, znacznie poniżej 16 MB na plik) albo nie uruchamiaj paczki. Bez niej dostajesz model zombie z podstawowej gry, który działa.
2. Problem z trybem sieciowym. Uruchom /znet i /zsync. Jeśli serwer ma szwendacze obok ciebie, a twój klient żadnych nie trzyma, spróbuj Zombies.Mode = 'legacy' i zrestartuj bs_zombies. Potem wyślij mi wynik.

Czołgacze wstają: nutria_crawl_anims nie jest uruchomiony albo startuje po bs_zombies.

Zombie ciche

bs_zombiesfx nie działa. Uwaga: zastępuje dźwięki bólu pedów dla każdego peda, także graczy. To znane.

Crashe klienta

• Włącz crumbs (są domyślnie włączone: Config.Crumbs.enabled = true w bs_core). Po crashu kolejny start wypisuje w F8 [crumbs] last session: z ostatnimi 40 zdarzeniami. /bs_crumbs wypisuje bieżącą sesję. Wyślij mi to, to dużo przydatniejsze niż “wywaliło się”.
• Crash przy wchodzeniu / błędy “256 pool”: zwykle streaming mapy. Zobacz Wydajność, rozmiary pooli i zasięgi mapy.
• Upewnij się, że klient ma build wymuszany przez serwer (3095).

Błędy w konsoli, które zobaczysz

callback "x" timed out after 10000ms - resource będący właścicielem tego callbacku nie działa albo wywalił błąd. Callbacki są rozgłaszane, a odpowiada tylko właściciel, więc brak właściciela daje timeout, a nie błąd. Kto go rejestruje, znajdziesz w dokumentacji API.

callback "x" errored: ... - handler serwera rzucił wyjątek. Reszta linii to prawdziwy błąd Lua.

[BS SERVICES] ... - resource poprosił o usługę (BS.Use), której provider nie istnieje albo nie eksportuje tego, co obiecał. Sprawdź, czy provider startuje przed konsumentem.

Spam MUMBLE_ADD_VOICE_CHANNEL_LISTEN: Tried to call native on a channel that didn't exist - pma-voice. Z tego powodu jest wyłączony w domyślnym cfg.

Could not find resource mapmanager / spawnmanager - masz ensure dla resource’ów z cfx-server-data, których nie masz. Usuń je, nie są nam potrzebne.

ox_lib się wywala i ciągnie za sobą ac_radio - masz zip ze źródłami z GitHuba dla ox_lib. Weź zip release, ma web/build/.

Gracze nie mogą otworzyć F1 / F10

Ich identyfikator nie jest w grupie z bs.admin. Sprawdź w konsoli:

test_ace identifier.license:xxxx bs.admin

Anti-cheat oznacza staff albo skrypt

Staff jest wyłączony z kontroli przez ACE. Skrypt teleportujący graczy musi wywołać exports.bs_guard:Allow(src, 'teleport', ms). Zobacz Anti-cheat.

UI się zawiesiło i widać mysz

Jakiś panel otworzył fokus NUI i go nie zamknął. Najpierw wpisz /refreshui, zamyka każdy panel i zwalnia fokus. Jeśli to nie pomoże, zrestartuj resource będący właścicielem panelu. Jeśli da się to odtworzyć, powiedz mi, który panel, każdy panel ma przy każdym wyjściu parować bs:ui:opened z bs:ui:closed.

Logowanie do bazy danych nie działa po aktualizacji

Jeśli używasz db.cfg, sprawdź, czy nadal leży obok server.cfg i czy server.cfg wciąż ma exec db.cfg. git pull nigdy nie rusza db.cfg, ale skopiowanie świeżego server.cfg na swój może zgubić linię exec. Zobacz Przepis i deploy na VPS.

Brak pojazdów świata

• Vehicles.World.enabled jest false albo migracja 029_vehicle_world.sql nie przeszła (sprawdź bs_migrations).
• Uzupełniają się tylko przy restarcie serwera i spawnują tylko na punktach drogowych daleko od graczy i poza safe zone’ami. Pojeździj, pojawiają się 260 do 650 metrów dalej.
• Model w Vehicles.World.pool, którego nie ma na twoim serwerze, nigdy się nie zespawnuje. Sprawdź konsolę F8.

Nie da się zamontować części, auto nie odpala

Auta świata startują bez akumulatora, świecy i zbiornika paliwa. Daj sobie przedmioty z F10 > ITEMS do testów, potem użyj koła pojazdu (G).

Język się nie zmienia

• Resource nie ma jeszcze tego pliku językowego, więc wraca do angielskiego. Na razie tak ma być.
• Napisany przez ciebie resource nie dołącza @bs_core/shared/sh_locale.lua albo nie wymienia locales/*.lua w files. Zobacz Języki.

Menu testera F4 się nie otwiera

bs_tester nie jest w ensure albo gracz nie ma dostępu testera. Admini mają go zawsze, inni potrzebują przełącznika TESTER w F10 > PLAYERS.

Migracja “nigdy nie przeszła”

Pliku nie ma na zakodowanej liście w bs_core/server/sv_migrations.lua. Zobacz Migracje bazy danych.