Configuration

HumaLike uses FXServer convars. Put server-only values behind set; use setr only for documented settings that must be visible to clients.

Minimal configuration

set humalike_license_key "ak_secret_replace_me"
setr humalike_debug 0

ensure humalike

The license is the only credential you configure. Runtime and voice credentials are obtained automatically.

Integration selection

Provider domains are independent:

set humalike_player auto
set humalike_inventory auto
set humalike_dispatch auto
set humalike_actions auto
setr humalike_interaction auto

Each value accepts:

auto — select the single highest-priority available provider.
A provider name — require that provider.
none — disable the domain.

If equally ranked providers conflict, auto reports ambiguous instead of guessing. Explicitly select the intended provider.

NPC labels

setr humalike_npc_labels_enabled true
setr humalike_npc_labels_distance 14.0
setr humalike_npc_labels_height 0.98
setr humalike_npc_labels_scale 1.0
setr humalike_npc_labels_default_language pl
setr humalike_npc_labels_show_default_language false

Setting	Default	Description
`humalike_npc_labels_enabled`	`true`	Show the canvas label above AI NPCs.
`humalike_npc_labels_distance`	`14.0`	Maximum render distance in metres.
`humalike_npc_labels_height`	`0.98`	Vertical placement relative to the ped.
`humalike_npc_labels_scale`	`1.0`	Label scale multiplier.
`humalike_npc_labels_default_language`	`pl`	Language treated as the server default.
`humalike_npc_labels_show_default_language`	`false`	Include the language marker for the default language.

Ambient population

set humalike_population_cops false

Setting	Default	Description
`humalike_population_cops`	`false`	Keep GTA’s own random police on while HumaLike owns the street population (see Ambient NPCs); read every few seconds, so it can be flipped live. Everything else — limits, radii, extras — is set in the dashboard.

Wounded and medical gameplay

setr humalike_npc_wounded_enabled true
setr humalike_npc_wounded_duration 300000
setr humalike_npc_death_chance 5
setr humalike_npc_medic_jobs "ambulance,ems"
setr humalike_npc_police_jobs "police"
setr humalike_npc_wounded_require_duty true
setr humalike_npc_medical_dispatch true

Setting	Default	Description
`humalike_npc_wounded_enabled`	`true`	Enable the wounded/death flow.
`humalike_npc_wounded_duration`	`300000`	Wounded window in milliseconds.
`humalike_npc_death_chance`	`5`	Percent chance that a wound becomes fatal.
`humalike_npc_revive_linger`	`30000`	Time the revived NPC remains protected from cleanup.
`humalike_npc_revive_linger_radius`	`20`	Linger radius in metres.
`humalike_npc_medic_jobs`	`ambulance,ems`	Comma-separated jobs allowed to treat NPCs.
`humalike_npc_police_jobs`	`police`	Comma-separated jobs allowed to handle deceased NPCs.
`humalike_npc_wounded_require_duty`	`true`	Require the matching job to be on duty.
`humalike_npc_revive_duration`	`10000`	Treatment progress duration in milliseconds.
`humalike_npc_mortuary_duration`	`5000`	Mortuary interaction duration in milliseconds.
`humalike_npc_treatment_distance`	`6.0`	Server validation distance in metres.
`humalike_npc_deceased_retention`	`900000`	Time to retain a deceased NPC in milliseconds.

Labels can be translated with humalike_npc_revive_label, humalike_npc_revive_progress, humalike_npc_mortuary_label, and humalike_npc_mortuary_progress.

Medical dispatch

Setting	Default	Description
`humalike_npc_medical_dispatch`	`true`	Allow medical dispatch reports.
`humalike_npc_medical_dispatch_chance`	`100`	Percent chance to report an eligible incident.
`humalike_npc_medical_dispatch_delay`	`10000`	Delay before reporting, in milliseconds.
`humalike_npc_medical_dispatch_throttle`	`30`	Minimum interval between reports, in seconds.
`humalike_npc_mortuary_dispatch`	`true`	Notify dispatch about mortuary handling.

Dispatch settings only have an external effect when a dispatch provider is selected.

Wound display

Setting	Default	Description
`humalike_npc_wounds_enabled`	`true`	Track structured wounds.
`humalike_npc_wound_display`	`true`	Allow the wound card to be shown.
`humalike_npc_wound_display_distance`	`3.0`	Maximum inspection distance.
`humalike_npc_max_wounds`	`6`	Maximum displayed wound entries.
`humalike_npc_wound_min_damage`	`5`	Minimum damage used for a wound report.

The wound title, empty/deceased labels, body regions, injury kinds, and severity labels also have humalike_npc_wound_* localization convars. Copy the defaults from the release configuration before translating them.

Pose behavior

Setting	Default	Description
`humalike_npc_pose_abandon_ms`	`120000`	Release a held pose after this time without nearby players.
`humalike_npc_pose_abandon_radius`	`60`	Nearby-player radius used by pose cleanup.
`humalike_npc_pose_threat_watch`	`true`	Let threats interrupt sustained poses.
`humalike_npc_pose_threat_radius`	`30`	Threat observation radius in metres.
`humalike_npc_pose_threat_clear_ms`	`60000`	Time before a threat state clears.

Advanced world tuning

The humalike_world_* convars control collection, batching, snapshots, and NPC reporting. Their defaults are designed for normal servers. Change them only to diagnose a measured issue; shorter intervals increase client, server, and network work.

Setting	Default	Description
`humalike_world_tick_ms`	`20`	Collector scheduling tick.
`humalike_world_moving_interval_ms`	`100`	Player update interval while moving.
`humalike_world_idle_interval_ms`	`1000`	Player update interval while idle.
`humalike_world_listener_interval_ms`	`33`	Local listener update interval.
`humalike_world_npc_edge_enabled`	`1`	Enable NPC world streaming.
`humalike_world_npc_edge_interval_ms`	`200`	NPC frame interval.
`humalike_world_npc_report_radius`	`150`	NPC report radius in metres.
`humalike_world_npc_max_per_frame`	`32`	NPCs per frame, clamped to `1`–`32`.
`humalike_world_voice_enabled`	`1`	Enable voice world updates.
`humalike_world_voice_delta_batch_ms`	`100`	Voice delta batch interval.
`humalike_world_voice_snapshot_ms`	`60000`	Full voice snapshot interval.
`humalike_world_cabin_voice_enabled`	`1`	Enable vehicle cabin routing.

Do not configure undocumented endpoint, authority, or voice-secret convars. They are managed by the released runtime and are not part of the supported customer configuration surface.

Get started

Configure

Integrate

Operate

Minimal configuration

Integration selection

NPC labels

Ambient population

Wounded and medical gameplay

Medical dispatch

Wound display

Pose behavior

Advanced world tuning

Next

​Minimal configuration

​Integration selection

​NPC labels

​Ambient population

​Wounded and medical gameplay

​Medical dispatch

​Wound display

​Pose behavior

​Advanced world tuning

​Next

Minimal configuration

Integration selection

NPC labels

Ambient population

Wounded and medical gameplay

Medical dispatch

Wound display

Pose behavior

Advanced world tuning

Next