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

# Konfiguracja

> Skonfiguruj wybór dostawców, etykiety, rany i zaawansowane zachowanie świata.

Humalike używa convarów FXServer ustawianych przez `set`. Zasób wysyła graczom
wartości, których potrzebuje ich gra, gdy dołączają, więc żadne udokumentowane ustawienie
nie wymaga `setr`; istniejące `setr` nadal działa. Licencję trzymaj wyłącznie za
`set`.

Ustawienia są odczytywane przy starcie zasobu: po zmianie któregoś uruchom
`restart humalike`. Dwa wyjątki, `humalike_population_cops` i
`humalike_npc_vehicles`, są odczytywane ponownie co kilka sekund.

## Konfiguracja minimalna

```cfg theme={null}
set humalike_license_key "ak_secret_replace_me"
set humalike_debug 0

ensure humalike
```

Licencja to jedyne poświadczenie, które konfigurujesz. Poświadczenia runtime i głosu
są pozyskiwane automatycznie.

## Wybór integracji

Domeny dostawców są niezależne:

```cfg theme={null}
set humalike_player auto
set humalike_inventory auto
set humalike_dispatch auto
set humalike_actions auto
set humalike_interaction auto
```

Każda wartość przyjmuje:

* `auto` — wybierz jedynego dostępnego dostawcę o najwyższym priorytecie.
* Nazwę dostawcy — wymagaj tego dostawcy.
* `none` — wyłącz domenę.

Jeśli dostawcy o równym priorytecie kolidują, `auto` zgłasza `ambiguous` zamiast
zgadywać. Wskaż jawnie zamierzonego dostawcę.

## Język interfejsu

```cfg theme={null}
set humalike_ui_language en
```

| Ustawienie             | Domyślnie | Opis                                                                                                         |
| ---------------------- | --------: | ------------------------------------------------------------------------------------------------------------ |
| `humalike_ui_language` |      `en` | Język tekstów, które sam Humalike pokazuje graczom: panel `/voice` i jego własne podpowiedzi. `en` lub `pl`. |

Etykiety reanimacji, kostnicy i ran są tłumaczone pojedynczo przez ich własne
convary poniżej.

## Etykiety NPC

```cfg theme={null}
set humalike_npc_labels_enabled true
set humalike_npc_labels_distance 14.0
set humalike_npc_labels_height 0.98
set humalike_npc_labels_scale 1.0
set humalike_npc_labels_default_language en
set humalike_npc_labels_show_default_language false
```

| Ustawienie                                  | Domyślnie | Opis                                                                                                              |
| ------------------------------------------- | --------: | ----------------------------------------------------------------------------------------------------------------- |
| `humalike_npc_labels_enabled`               |    `true` | Pokazuj etykietę canvas nad NPC AI.                                                                               |
| `humalike_npc_labels_distance`              |    `14.0` | Maksymalna odległość renderowania w metrach.                                                                      |
| `humalike_npc_labels_height`                |    `0.98` | Położenie pionowe względem peda.                                                                                  |
| `humalike_npc_labels_scale`                 |     `1.0` | Mnożnik skali etykiety.                                                                                           |
| `humalike_npc_labels_default_language`      |      `en` | Język, którym mówi większość NPC. NPC mówiący innym językiem dostaje na etykiecie flagę (lub kod swojego języka). |
| `humalike_npc_labels_show_default_language` |   `false` | Dołącz znacznik języka także dla języka domyślnego.                                                               |

## Populacja otoczenia

```cfg theme={null}
set humalike_population_cops false
set humalike_npc_vehicles true
```

| Ustawienie                 | Domyślnie | Opis                                                                                                                                                                                                                                                                               |
| -------------------------- | --------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `humalike_population_cops` |   `false` | Zostaw włączoną własną losową policję GTA, gdy Humalike jest właścicielem populacji ulicznej (zobacz [NPC otoczenia](/pl/ai-npc/ambient-npcs)); odczytywane co kilka sekund, więc można je przełączać na żywo. Wszystko inne — limity, promienie, statyści — ustawia się w panelu. |
| `humalike_npc_vehicles`    |    `true` | Pozwól postaciom dynamicznym pojawiać się za kierownicą samochodu lub na motocyklu i jeździć jak ruch uliczny (zobacz [Kierowcy](/pl/ai-npc/ambient-npcs#kierowcy)). Odczytywane co kilka sekund; `false` spawnuje każdą postać pieszo i nigdy w pojeździe.                        |

## Rozgrywka z rannymi i medyczna

```cfg theme={null}
set humalike_npc_wounded_enabled true
set humalike_npc_wounded_duration 300000
set humalike_npc_death_chance 5
set humalike_npc_medic_jobs "ambulance,ems"
set humalike_npc_police_jobs "police"
set humalike_npc_wounded_require_duty true
set humalike_npc_medical_dispatch true
```

| Ustawienie                          |       Domyślnie | Opis                                                                    |
| ----------------------------------- | --------------: | ----------------------------------------------------------------------- |
| `humalike_npc_wounded_enabled`      |          `true` | Włącz przebieg ranny/śmierć.                                            |
| `humalike_npc_wounded_duration`     |        `300000` | Okno stanu rannego w milisekundach.                                     |
| `humalike_npc_death_chance`         |             `5` | Procentowa szansa, że rana okaże się śmiertelna.                        |
| `humalike_npc_revive_linger`        |         `30000` | Czas, przez jaki reanimowany NPC pozostaje chroniony przed sprzątaniem. |
| `humalike_npc_revive_linger_radius` |            `20` | Promień pozostawania w metrach.                                         |
| `humalike_npc_medic_jobs`           | `ambulance,ems` | Rozdzielone przecinkami prace uprawnione do leczenia NPC.               |
| `humalike_npc_police_jobs`          |        `police` | Rozdzielone przecinkami prace uprawnione do obsługi zmarłych NPC.       |
| `humalike_npc_wounded_require_duty` |          `true` | Wymagaj, aby pasująca praca była na służbie.                            |
| `humalike_npc_revive_duration`      |         `10000` | Czas trwania postępu leczenia w milisekundach.                          |
| `humalike_npc_mortuary_duration`    |          `5000` | Czas trwania interakcji kostnicy w milisekundach.                       |
| `humalike_npc_treatment_distance`   |           `6.0` | Odległość walidacji po stronie serwera w metrach.                       |
| `humalike_npc_deceased_retention`   |        `900000` | Czas przechowywania zmarłego NPC w milisekundach.                       |

Interakcje leczenia pokazują te teksty:

| Ustawienie                       | Domyślnie           |
| -------------------------------- | ------------------- |
| `humalike_npc_revive_label`      | `Revive`            |
| `humalike_npc_revive_progress`   | `Treating patient`  |
| `humalike_npc_mortuary_label`    | `Send to mortuary`  |
| `humalike_npc_mortuary_progress` | `Securing the body` |

### Prace bez frameworka

ESX, QBCore i Qbox odpowiadają na sprawdzenia pracy z poziomu frameworka, a własny
dostawca gracza odpowiada na nie własnym `HasJob`. Tylko dostawca gracza `standalone`
odczytuje ACE: praca jest wtedy uprawnieniem nadanym graczowi lub jego grupie, a
nadane uprawnienie liczy się jako bycie na służbie:

```cfg theme={null}
add_ace group.ems humalike.job.ambulance allow
add_ace group.police humalike.job.police allow
add_principal identifier.license:0123456789abcdef group.ems
```

Ustaw `humalike_npc_medic_jobs` na pusty ciąg, aby pozwolić każdemu graczowi leczyć
rannych NPC.

## Dyspozytornia medyczna

| Ustawienie                               | Domyślnie | Opis                                                        |
| ---------------------------------------- | --------: | ----------------------------------------------------------- |
| `humalike_npc_medical_dispatch`          |    `true` | Zezwól na zgłoszenia do dyspozytorni medycznej.             |
| `humalike_npc_medical_dispatch_chance`   |     `100` | Procentowa szansa zgłoszenia kwalifikującego się incydentu. |
| `humalike_npc_medical_dispatch_delay`    |   `10000` | Opóźnienie przed zgłoszeniem, w milisekundach.              |
| `humalike_npc_medical_dispatch_throttle` |      `30` | Minimalny odstęp między zgłoszeniami, w sekundach.          |
| `humalike_npc_mortuary_dispatch`         |    `true` | Powiadamiaj dyspozytornię o obsłudze kostnicy.              |

Ustawienia dyspozytorni mają zewnętrzny efekt tylko wtedy, gdy wybrany jest dostawca
dyspozytorni.

## Wyświetlanie ran

| Ustawienie                            | Domyślnie | Opis                                                 |
| ------------------------------------- | --------: | ---------------------------------------------------- |
| `humalike_npc_wounds_enabled`         |    `true` | Śledź ustrukturyzowane rany.                         |
| `humalike_npc_wound_display`          |    `true` | Zezwól na pokazywanie karty ran.                     |
| `humalike_npc_wound_display_distance` |     `3.0` | Maksymalna odległość oględzin.                       |
| `humalike_npc_wound_display_height`   |     `0.0` | Pionowe przesunięcie karty ran nad pedem, w metrach. |
| `humalike_npc_wound_screen_offset`    |   `0.075` | Przesunięcie karty ran w przestrzeni ekranu.         |
| `humalike_npc_max_wounds`             |       `6` | Maksymalna liczba wyświetlanych wpisów ran.          |
| `humalike_npc_wound_min_damage`       |       `5` | Minimalne obrażenia brane pod uwagę w raporcie rany. |

Teksty karty ran, każdy jako osobne ustawienie:

| Ustawienie                             | Domyślnie             |
| -------------------------------------- | --------------------- |
| `humalike_npc_wound_title`             | `Injuries`            |
| `humalike_npc_wound_none`              | `No visible injuries` |
| `humalike_npc_wound_deceased`          | `Deceased`            |
| `humalike_npc_wound_region_head`       | `Head`                |
| `humalike_npc_wound_region_torso`      | `Torso`               |
| `humalike_npc_wound_region_left_arm`   | `Left arm`            |
| `humalike_npc_wound_region_right_arm`  | `Right arm`           |
| `humalike_npc_wound_region_left_leg`   | `Left leg`            |
| `humalike_npc_wound_region_right_leg`  | `Right leg`           |
| `humalike_npc_wound_kind_gunshot`      | `Gunshot wound`       |
| `humalike_npc_wound_kind_stab`         | `Stab wound`          |
| `humalike_npc_wound_kind_blunt`        | `Blunt trauma`        |
| `humalike_npc_wound_kind_burn`         | `Burn`                |
| `humalike_npc_wound_kind_explosion`    | `Blast injury`        |
| `humalike_npc_wound_kind_fall`         | `Fall injury`         |
| `humalike_npc_wound_kind_vehicle`      | `Vehicle impact`      |
| `humalike_npc_wound_severity_minor`    | `minor`               |
| `humalike_npc_wound_severity_serious`  | `serious`             |
| `humalike_npc_wound_severity_critical` | `critical`            |

## Zachowanie póz

| Ustawienie                          | Domyślnie | Opis                                                              |
| ----------------------------------- | --------: | ----------------------------------------------------------------- |
| `humalike_npc_pose_abandon_ms`      |  `120000` | Zwolnij utrzymywaną pozę po tym czasie bez graczy w pobliżu.      |
| `humalike_npc_pose_abandon_radius`  |      `60` | Promień wykrywania pobliskich graczy używany przy sprzątaniu póz. |
| `humalike_npc_pose_threat_watch`    |    `true` | Pozwól zagrożeniom przerywać podtrzymywane pozy.                  |
| `humalike_npc_pose_threat_radius`   |      `30` | Promień obserwacji zagrożeń w metrach.                            |
| `humalike_npc_pose_threat_clear_ms` |   `10000` | Czas do wygaśnięcia stanu zagrożenia.                             |

## Zaawansowane strojenie świata

Convary `humalike_world_*` sterują zbieraniem, grupowaniem w partie, migawkami
i raportowaniem NPC. Ich wartości domyślne są zaprojektowane dla zwykłych serwerów.
Zmieniaj je tylko, aby zdiagnozować zmierzony problem; krótsze odstępy zwiększają
obciążenie klienta, serwera i sieci.

| Ustawienie                                  | Domyślnie | Opis                                                       |
| ------------------------------------------- | --------: | ---------------------------------------------------------- |
| `humalike_world_tick_ms`                    |      `20` | Tick harmonogramu kolektora.                               |
| `humalike_world_moving_interval_ms`         |     `100` | Odstęp aktualizacji gracza podczas ruchu.                  |
| `humalike_world_idle_interval_ms`           |    `1000` | Odstęp aktualizacji gracza podczas bezczynności.           |
| `humalike_world_listener_interval_ms`       |      `33` | Odstęp aktualizacji lokalnego słuchacza.                   |
| `humalike_world_npc_edge_enabled`           |       `1` | Włącz strumieniowanie świata NPC.                          |
| `humalike_world_npc_edge_interval_ms`       |     `200` | Odstęp klatek NPC.                                         |
| `humalike_world_npc_edge_ticket_retry_ms`   |    `3000` | Odstęp ponowienia po nieudanym bilecie edge NPC.           |
| `humalike_world_npc_edge_ticket_refresh_ms` |   `12000` | Odstęp odświeżania biletu edge NPC.                        |
| `humalike_world_npc_report_radius`          |     `150` | Promień raportowania NPC w metrach.                        |
| `humalike_world_npc_max_per_frame`          |      `32` | NPC na klatkę, ograniczone do `1`–`32`.                    |
| `humalike_world_voice_enabled`              |       `1` | Włącz aktualizacje świata głosu.                           |
| `humalike_world_voice_delta_batch_ms`       |     `100` | Odstęp partii delt głosu.                                  |
| `humalike_world_voice_snapshot_ms`          |   `60000` | Odstęp pełnej migawki głosu.                               |
| `humalike_world_cabin_voice_enabled`        |       `1` | Włącz routing w kabinie pojazdu.                           |
| `humalike_world_cabin_start_delay_ms`       |    `1000` | Opóźnienie przed startem routingu kabiny, co najmniej `0`. |
| `humalike_world_cabin_retry_ms`             |    `2000` | Odstęp ponowienia routingu kabiny, co najmniej `500`.      |
| `humalike_world_cabin_snapshot_ms`          |   `30000` | Odstęp pełnej migawki kabiny, co najmniej `5000`.          |
| `humalike_world_snapshot_interval_ms`       |   `60000` | Odstęp migawki autorytetu serwera.                         |

<Warning>
  Nie konfiguruj nieudokumentowanych convarów endpointów, autorytetu ani sekretów głosu.
  Zarządza nimi wydany runtime i nie są one częścią wspieranej
  powierzchni konfiguracji klienta.
</Warning>

## Dalej

* [Wybierz framework](/pl/ai-npc/frameworks).
* [Skonfiguruj systemy rozgrywki](/pl/ai-npc/gameplay).
* [Sprawdź każdy publiczny interfejs](/pl/ai-npc/reference).