Skip to main content
Empieza por los comandos de estado. Exponen el estado operativo admitido sin requerir registros detallados.

Comandos de estado

Ejecuta en la consola del servidor:
humalike_status informa del arranque de credenciales y de los dominios de proveedor player, inventory, dispatch y actions. humalikenpc:status informa del proveedor de jugador seleccionado, el tamaño de la plantilla y la última sincronización de la plantilla. Ejecuta humalike_status en la consola F8 del cliente para inspeccionar el proveedor de interacción; también imprime de dónde procede el ajuste de interacción: server (establecido en server.cfg y recibido), default (los ajustes del servidor llegaron y lo dejan en auto) o local (aún no recibido). Ejecuta /voice para inspeccionar la conexión de voz local. humalikenpc:reload solicita una actualización inmediata de la plantilla. Los comandos de servidor y cliente están restringidos por ACE allí donde se aplican los permisos de comandos de FiveM.

Estados de proveedor

Registro de depuración temporal

Reinicia el recurso, reproduce un problema, recopila las líneas relevantes y vuelve a ponerlo a 0. El modo de depuración es ruidoso a propósito y no debería quedarse activado en un servidor de producción con carga. Elimina las credenciales y las URLs de conexión firmadas antes de compartir registros.

El recurso no llega a estar listo

Comprueba, en orden:
  1. humalike_license_key usa set, contiene la licencia de servidor actual y aparece antes de ensure humalike.
  2. La URL de callback registrada contiene la dirección IPv4 pública literal enrutable globalmente de este FXServer.
  3. El tráfico TCP entrante llega a ese puerto.
  4. El registro del servidor está activado.
  5. La build de FXServer es actual y OneSync está activado.
Rota la licencia solo si se ha perdido o expuesto; la rotación invalida el valor antiguo de inmediato.

Falta un NPC

  • Confirma que el estado del servidor es listo y que el recuento de la plantilla no es cero.
  • Confirma que el NPC y el servidor están activados en el panel.
  • Para NPC estáticos, verifica el modelo, las coordenadas, la orientación, el routing bucket y la geometría del mapa.
  • Para NPC ambientales, verifica que la política ambiental está activada y que los jugadores están en una zona con tráfico peatonal (una cordillera o mar abierto no reciben a nadie).
  • Ejecuta humalikenpc:reload una vez en lugar de reiniciar el servidor repetidamente.

El NPC no responde

  • Verifica el micrófono del jugador y la asignación de PTT de Humalike.
  • Usa /voice y comprueba que el NPC previsto no está silenciado para ese jugador.
  • Acércate y mira al NPC para una conversación directa.
  • Comprueba los turnos de NPC disponibles del servidor.
  • Confirma que el NPC tiene voz y está activado.
Un NPC también puede decidir no hablar según su personaje y la conversación actual. Prueba varias intervenciones claras antes de tratar el silencio como un fallo de conexión.

/me o /do se ignora

La integración incorporada depende del evento de rol admitido por el framework. Un recurso de chat personalizado puede mostrar el comando sin publicar ese evento. En ese caso, llama a ReportPlayerEvent desde el handler de servidor del recurso de chat. Consulta Informar de eventos del jugador.

La acción de inventario no está disponible

Ejecuta humalike_status y comprueba el dominio inventory. give_item solo se anuncia mientras hay un proveedor de inventario seleccionado. Resuelve un proveedor no disponible o ambiguo y deja que Humalike actualice sus capacidades.

Errores de callback NUI o de assets tras una actualización

La causa habitual son releases mezcladas. Detén Humalike, sustituye el directorio completo del recurso por el contenido de un único humalike.zip y arráncalo de nuevo. No superpongas releases ni copies solo los ficheros web compilados.

Informar de un error

Incluye la versión de la release de Humalike, la versión del artefacto de FXServer, el estado del framework y de los proveedores, los pasos exactos de reproducción y registros saneados. Informa de los problemas de seguridad mediante el informe privado de vulnerabilidades.

Siguiente