> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humalike.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Operacje i rozwiązywanie problemów

> Sprawdzaj stan runtime i rozwiązuj typowe problemy z instalacją, NPC, głosem i dostawcami.

Zacznij od poleceń statusu. Pokazują wspierany stan operacyjny
bez potrzeby rozbudowanych logów.

## Polecenia statusu

Uruchom w konsoli serwera:

```text theme={null}
humalike_status
humalikenpc:status
```

`humalike_status` raportuje bootstrap poświadczeń oraz domeny dostawców `player`, `inventory`,
`dispatch` i `actions`. `humalikenpc:status` raportuje
wybranego dostawcę gracza, rozmiar listy NPC i ostatnią synchronizację listy NPC.

Uruchom `humalike_status` w konsoli F8 klienta, aby sprawdzić dostawcę
interakcji; wypisuje też, skąd pochodzi ustawienie interakcji: `server`
(ustawione w server.cfg i odebrane), `default` (ustawienia serwera dotarły i
zostawiają je na `auto`) lub `local` (jeszcze nie odebrane). Uruchom `/voice`, aby sprawdzić
lokalne połączenie głosowe.

`humalikenpc:reload` żąda natychmiastowego odświeżenia listy NPC. Polecenia serwera i klienta
są ograniczone przez ACE tam, gdzie obowiązują uprawnienia poleceń FiveM.

## Stany dostawców

| Stan          | Znaczenie                                                       | Działanie                                               |
| ------------- | --------------------------------------------------------------- | ------------------------------------------------------- |
| `selected`    | Aktywny jest jeden dostępny dostawca.                           | Brak.                                                   |
| `disabled`    | Domena jest skonfigurowana jako `none`.                         | Włącz ją tylko wtedy, gdy funkcja jest potrzebna.       |
| `unavailable` | Żaden dostawca nie pasuje do ustawienia.                        | Uruchom jego zależność lub popraw skonfigurowaną nazwę. |
| `ambiguous`   | Najwyżej sklasyfikowani dostępni dostawcy mają równy priorytet. | Wybierz jednego jawnie.                                 |
| `degraded`    | Wywołanie zwrotne wybranego dostawcy nie powiodło się.          | Sprawdź ten most lub zależność.                         |

## Tymczasowe logowanie debugowania

```cfg theme={null}
set humalike_debug 1
```

Zrestartuj zasób, odtwórz jeden problem, zbierz odpowiednie linie, a następnie ustaw
z powrotem na `0`. Tryb debugowania jest celowo gadatliwy i nie powinien pozostawać włączony
na obciążonym serwerze produkcyjnym.

Przed udostępnieniem logów usuń poświadczenia i podpisane URL-e połączeń.

## Zasób nie osiąga gotowości

Sprawdź, po kolei:

1. `humalike_license_key` używa `set`, zawiera aktualną licencję serwera i
   występuje przed `ensure humalike`.
2. Zarejestrowany URL callback zawiera globalnie routowalny literalny
   publiczny adres IPv4 tego FXServer.
3. Przychodzący ruch TCP dociera do tego portu.
4. Rejestracja serwera jest włączona.
5. Build FXServer jest aktualny, a OneSync jest włączony.

Rotuj licencję tylko wtedy, gdy została zgubiona lub ujawniona; rotacja natychmiast
unieważnia starą wartość.

## Brakuje NPC

* Potwierdź, że status serwera to gotowy, a liczba NPC na liście jest niezerowa.
* Potwierdź, że NPC i serwer są włączone w panelu.
* Dla NPC statycznych zweryfikuj model, współrzędne, kierunek, routing bucket i geometrię
  mapy.
* Dla NPC otoczenia zweryfikuj, że polityka NPC otoczenia jest włączona i że gracze
  stoją w strefie z ruchem pieszym (pasmo górskie lub otwarte morze
  nie dostaje nikogo).
* Uruchom `humalikenpc:reload` raz, zamiast wielokrotnie restartować serwer.

## NPC nie odpowiada

* Zweryfikuj mikrofon gracza i przypisanie PTT Humalike.
* Użyj `/voice` i sprawdź, czy docelowy NPC nie jest wyciszony dla tego gracza.
* Podejdź blisko i zwróć się twarzą do NPC, aby nawiązać bezpośrednią rozmowę.
* Sprawdź dostępne [tury NPC](/pl/npc-turns) serwera.
* Potwierdź, że NPC ma głos i jest włączony.

NPC może też zdecydować, że się nie odezwie, na podstawie swojej postaci i bieżącej
rozmowy. Przetestuj kilka wyraźnych wypowiedzi, zanim uznasz milczenie za awarię
połączenia.

## `/me` lub `/do` jest ignorowane

Wbudowana integracja zależy od wspieranego zdarzenia roleplay frameworka. Własny
zasób czatu może wyświetlać polecenie bez publikowania tego zdarzenia. W
takim przypadku wywołaj `ReportPlayerEvent` z serwerowego handlera zasobu czatu. Zobacz
[Zgłaszanie zdarzeń gracza](/pl/ai-npc/integrations/world-events).

## Akcja ekwipunku jest niedostępna

Uruchom `humalike_status` i sprawdź domenę `inventory`. `give_item` jest ogłaszane
tylko wtedy, gdy wybrany jest dostawca ekwipunku. Rozwiąż problem niedostępnego lub
niejednoznacznego dostawcy, a następnie pozwól Humalike odświeżyć swoje możliwości.

## Błędy callbacków NUI lub plików po aktualizacji

Częstą przyczyną są mieszane wydania. Zatrzymaj Humalike, zastąp cały katalog
zasobu zawartością jednego `humalike.zip` i uruchom go ponownie. Nie
nakładaj wydań na siebie ani nie kopiuj samych skompilowanych plików web.

## Zgłaszanie błędu

Dołącz wersję wydania Humalike, wersję artefaktu FXServer, status frameworka i
dostawców, dokładne kroki odtworzenia oraz oczyszczone logi. Problemy bezpieczeństwa zgłaszaj
przez [prywatne zgłaszanie podatności](https://github.com/Humalike/humalike-fivem-npc/security/advisories/new).

## Dalej

* [Sprawdź publiczne polecenia i eksporty](/pl/ai-npc/reference).
* [Przejrzyj wskazówki bezpieczeństwa](/pl/ai-npc/security).
* [Otwórz panel AI NPC](https://humalike.ai/ai-npc).