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

# Referencia pública

> Índice de convars, comandos, exports, eventos, proveedores y acciones estables.

Esta página es un índice compacto. Sigue las guías enlazadas para los contratos de
callbacks, ejemplos y recomendaciones operativas.

## Convars

| Área                | Ajustes públicos                                                                                                                                                                |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Obligatorio         | `humalike_license_key`                                                                                                                                                          |
| Diagnóstico         | `humalike_debug`                                                                                                                                                                |
| Proveedores         | `humalike_player`, `humalike_inventory`, `humalike_dispatch`, `humalike_actions`, `humalike_interaction`                                                                        |
| Interfaz            | `humalike_ui_language`                                                                                                                                                          |
| Etiquetas           | `humalike_npc_labels_*`                                                                                                                                                         |
| Juego médico        | `humalike_npc_wounded_*`, `humalike_npc_death_chance`, `humalike_npc_revive_*`, `humalike_npc_mortuary_*`, `humalike_npc_treatment_distance`, `humalike_npc_deceased_retention` |
| Trabajos y despacho | `humalike_npc_medic_jobs`, `humalike_npc_police_jobs`, `humalike_npc_medical_dispatch*`                                                                                         |
| Heridas             | `humalike_npc_wounds_enabled`, `humalike_npc_wound_*`, `humalike_npc_max_wounds`                                                                                                |
| Poses               | `humalike_npc_pose_abandon_*`, `humalike_npc_pose_threat_*`                                                                                                                     |
| Ajuste del mundo    | `humalike_world_*` listadas en [Configuración](/es/ai-npc/configuration#ajuste-avanzado-del-mundo)                                                                              |

Las convars no documentadas de endpoint, secreto de tiempo de ejecución y autoridad no
son una interfaz admitida para clientes.

## Comandos

| Lado             | Comando              | Propósito                                                                   |
| ---------------- | -------------------- | --------------------------------------------------------------------------- |
| Servidor         | `humalike_status`    | Estado del tiempo de ejecución y de los proveedores.                        |
| Cliente          | `humalike_status`    | Estado del proveedor de interacción y si llegaron los ajustes del servidor. |
| Servidor/jugador | `humalikenpc:status` | Estado de la plantilla de NPC.                                              |
| Servidor/jugador | `humalikenpc:reload` | Solicitar una actualización inmediata de la plantilla.                      |
| Cliente          | `/voice`             | Estado de la conexión de voz local.                                         |

Las herramientas de generación ambiental solo para desarrolladores están desactivadas
por defecto. Para usarlas en un servidor de pruebas que no sea de producción, establece
`humalike_developer_tools 1` y concede el ACE `humalike.developer_tools`. El comando es:

```text theme={null}
/humalike_dev ambient <spawn|goto|remove|list> [npc_uuid]
/humalike_dev observe <npc_uuid> <key> [field=value ...]
```

Las generaciones de depuración son temporales y no sustituyen a la colocación de NPC
gestionada desde el panel.

## Exports de servidor

```lua theme={null}
exports.humalike:RegisterProvider(domain, descriptor)
exports.humalike:UnregisterProvider(domain, name)
exports.humalike:GetProviderStatus()
exports.humalike:ReportPlayerEvent(playerId, event)
exports.humalike:ReportObservation(npcId, playerId, key, fields, options)
exports.humalike:SetNpcStock(npcId, stock)
exports.humalike:PlaceOrder(npcId, playerId, lines)
exports.humalike:BindNpcEntity(npcId, networkId, options)
exports.humalike:UnbindNpcEntity(bindingId)
exports.humalike:DespawnNpc(npcId)
exports.humalike:RespawnNpc(npcId)
exports.humalike:AcquireNpcControl(npcId, options)
exports.humalike:RenewNpcControl(leaseId, ttlMs)
exports.humalike:ReleaseNpcControl(leaseId)
exports.humalike:GetNpcRuntimeState(npcId)
exports.humalike:ListNpcRuntimeStates()
```

Consulta [API de proveedores](/es/ai-npc/integrations/provider-api),
[Informar de eventos del jugador](/es/ai-npc/integrations/world-events),
[Acciones definidas por el servidor](/es/ai-npc/integrations/custom-actions) y
[NPC externos](/es/ai-npc/integrations/external-npcs) y
[Control en tiempo de ejecución](/es/ai-npc/integrations/runtime-control).

## Exports de cliente

```lua theme={null}
exports.humalike:RegisterInteractionProvider(descriptor)
exports.humalike:UnregisterInteractionProvider(name)
exports.humalike:GetInteractionProviderStatus()
exports.humalike:SetVoiceBusy(reason, active)
```

## Eventos

| Lado               | Evento                               | Carga útil                     |
| ------------------ | ------------------------------------ | ------------------------------ |
| Servidor y cliente | `humalike:integration:ready`         | `{ apiVersion, runtimeEpoch }` |
| Servidor           | `humalike:npc:ready`                 | `{ apiVersion, generation }`   |
| Cliente            | `humalike:voice:transmittingChanged` | `active: boolean`              |

## Nombres de proveedores integrados

* Jugador: `standalone`, `esx`, `qbcore`, `qbox`.
* Inventario: `esx`, `ox_inventory`, `qb_inventory`.
* Interacción: `builtin`, `ox_target`, `qb_target`.

## Claves de acción integradas

`wave`, `start_dancing`, `interrupt_animation`, `kneel`, `hands_up`, `punch`,
`stand_up`, `follow_player`, `stop_following`, `hold_position`,
`release_movement`, `enter_vehicle`, `enter_own_vehicle`, `exit_vehicle`, `walk_away`
y `run_away`.

`give_item` se añade cuando hay un proveedor de inventario disponible. El proveedor de
acciones personalizado seleccionado puede anunciar claves adicionales.

## Tipos neutros de evento del jugador

`rp_action`, `identity_document_shown`, `item_dropped`, `item_picked_up`,
`police_badge_shown`, `ems_badge_shown`, `doj_badge_shown`, `hands_raised` y
`hands_lowered`.

## Siguiente

* [Lee los contratos completos de proveedores](/es/ai-npc/integrations/provider-api).
* [Consulta ejemplos de cargas útiles de eventos](/es/ai-npc/integrations/world-events).
* [Diagnostica un servidor en ejecución](/es/ai-npc/operations).