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

# Instalacja i aktualizacje

> Bezpiecznie instaluj, ustawiaj kolejność, aktualizuj i wycofuj zasób FiveM.

## Zainstaluj wydanie

Użyj pliku `humalike.zip` z
[GitHub Releases](https://github.com/Humalike/humalike-fivem-npc/releases). Nie
pobieraj automatycznych archiwów źródeł GitHuba: zawierają one pliki repozytorium,
a nie złożony zasób runtime.

Umieść rozpakowany katalog `humalike` bezpośrednio w katalogu zasobów i
uruchom go po nazwie:

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

Katalog nie może być zagnieżdżony jako `humalike/humalike`.

## Kolejność zasobów

Humalike może wystartować bez frameworka. Aby automatyczny wybór zadziałał podczas
pierwszego uruchomienia, najpierw uruchom opcjonalne zależności:

```cfg theme={null}
ensure oxmysql
ensure ox_lib
ensure es_extended       # or qb-core / qbx_core
ensure ox_inventory      # optional
ensure ox_target         # optional

ensure humalike
ensure my-humalike-bridge
```

Zależności uruchamiane później i restartowane są wykrywane. Własny most powinien
startować po `humalike` i deklarować go jako zależność.

## Sieć dla callbacku

URL callback zarejestrowany w panelu musi docierać do FXServer z publicznego
internetu. Zezwól na przychodzący ruch TCP do wybranego portu serwera. Jeśli
zmienisz port FXServer lub adres publiczny, zaktualizuj callback w panelu.

Format URL to:

```text theme={null}
http://PUBLIC_IPV4:port
```

Host musi być globalnie routowalnym literalnym adresem IPv4. Nazwy hostów, IPv6,
adresy prywatne, adresy loopback i zarezerwowane adresy przykładowe nie są
akceptowane. Obsługiwane porty to `1024`–`65535`; nie dodawaj ścieżki, zapytania ani
fragmentu.

## Aktualizacja

1. Pobierz nowe wydanie i zweryfikuj jego opublikowaną sumę kontrolną SHA-256.
2. Zatrzymaj `humalike` albo zatrzymaj FXServer.
3. Zachowaj poprzedni katalog jako kopię do wycofania poza aktywnym drzewem
   zasobów.
4. Zastąp cały katalog `humalike`.
5. Uruchom go i wykonaj `humalike_status`.

Nie scalaj nowego wydania ze starym katalogiem. Usunięte pliki pozostałyby
aktywne i mogłyby powodować zachowanie mieszanych wersji.

Własny kod trzymaj w osobnym zasobie mostu. Aktualizacja Humalike nigdy nie powinna
nadpisywać specyficznych dla serwera prac, logiki dyspozytorni, nagród ani hooków UI.

## Wycofanie

Zatrzymaj zasób, przywróć cały katalog z poprzedniego wydania
i uruchom go ponownie. Licencja serwera pozostaje ważna. Jeśli w danym wydaniu zmienił się
schemat panelu lub wymagane zachowanie serwera, przed wycofaniem postępuj zgodnie
z notatkami tego wydania.

## Buildy deweloperskie

Serwery produkcyjne powinny używać archiwów wydań. Kopie repozytorium wymagają
zbudowania frontendu i są przeznaczone wyłącznie dla współtwórców. Wydanie zawiera już
wszystkie skompilowane pliki NUI.

## Dalej

* [Ukończ szybki start](/pl/ai-npc/quickstart).
* [Przejrzyj konfigurację](/pl/ai-npc/configuration).
* [Przygotuj operacje produkcyjne](/pl/ai-npc/operations).