> ## 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.

# Szybki start

> Zainstaluj Humalike i porozmawiaj ze swoim pierwszym NPC AI.

Ten przewodnik prowadzi czysty serwer FiveM od rejestracji do pierwszego NPC AI.

## 1. Zarejestruj serwer

Otwórz [panel AI NPC](https://humalike.ai/ai-npc), wybierz **Zarejestruj
serwer** i podaj:

* Nazwę, która identyfikuje serwer w twoim panelu.
* Jego globalnie routowalny publiczny URL callback IPv4, na przykład
  `http://PUBLIC_IPV4:30120`.

Użyj publicznego adresu IPv4, pod którym gracze łączą się z FXServer. Nazwy hostów, IPv6,
adresy prywatne, adresy loopback i zarezerwowane adresy przykładowe nie są
akceptowane. URL musi używać `http`, zawierać jawny nieuprzywilejowany port
(`1024`–`65535`) i nie mieć ścieżki, zapytania ani fragmentu.

Panel pokazuje nową licencję serwera tylko raz. Skopiuj ją od razu. Zgubioną lub
ujawnioną licencję możesz później zrotować.

## 2. Pobierz zasób

Pobierz `humalike.zip` z najnowszego
[wydania na GitHub](https://github.com/Humalike/humalike-fivem-npc/releases/latest).
Archiwum zawiera gotowy do uruchomienia katalog `humalike`.

Rozpakuj go do katalogu zasobów serwera:

```text theme={null}
resources/
└── humalike/
    ├── fxmanifest.lua
    ├── integration/
    ├── npc/
    ├── voice/
    └── world/
```

## 3. Skonfiguruj FXServer

Dodaj licencję bezpośrednio przed uruchomieniem zasobu:

```cfg theme={null}
set humalike_license_key "ak_secret_replace_me"
ensure humalike
```

<Warning>
  Dla `humalike_license_key` używaj `set`, nie `setr`. Replikowany convar
  ujawniłby licencję podłączonym klientom.
</Warning>

Nie konfiguruj URL-i głosu ani sekretów głosu. Humalike udostępnia głos
automatycznie na podstawie licencji serwera.

## 4. Sprawdź połączenie

Uruchom serwer i wykonaj w jego konsoli:

```text theme={null}
humalike_status
```

Zasób powinien zgłosić zainstalowane poświadczenia runtime i wybranego dostawcę
gracza. Dostawcy frameworka i ekwipunku pojawiają się, gdy działają ich
zależności.

## 5. Utwórz NPC

W panelu:

1. Otwórz zarejestrowany serwer.
2. Wybierz **Utwórz NPC**.
3. Zacznij od NPC **statycznego**.
4. Wybierz jego imię, osobowość, język, głos, model i współrzędne.
5. Zapisz i włącz go.

NPC pojawi się po następnym odświeżeniu listy NPC. Podczas konfigurowania nowego
serwera możesz też zrestartować sam zasób `humalike`.

## 6. Porozmawiaj

Dołącz do serwera, podejdź do NPC, przytrzymaj skonfigurowany klawisz push to talk
i mów. Humalike wybiera NPC, do którego się zwracasz, na podstawie odległości, kierunku
patrzenia, stanu podążania i kontekstu pojazdu.

<Check>
  Jeśli NPC się pojawia, pokazuje aktywny wskaźnik głosu i odpowiada, podstawowa
  instalacja jest ukończona.
</Check>

Jeśli któryś krok się nie powiedzie, zobacz [Operacje i rozwiązywanie problemów](/pl/ai-npc/operations).

## Dalej

* [Skonfiguruj Humalike](/pl/ai-npc/configuration) na swoim serwerze.
* [Wybierz integrację z frameworkiem](/pl/ai-npc/frameworks).
* [Zrozum wybór rozmówcy głosowego](/pl/ai-npc/voice).