PONEGLYPHSTUDIOS
🇪🇸ES🇬🇧EN

Primeros pasos

Frameworks

PSTUDIOS-HUD autodetecta ESX, QBCore y Qbox, o funciona totalmente en modo standalone — sin necesidad de un recurso puente.

PSTUDIOS-HUD incluye un puente de frameworks integrado (client/bridge.lua). Autodetecta tu framework y expone una API uniforme para el estado del jugador (hambre, sed, estrés). No se requiere ningún recurso puente externo. La vida, la armadura y el oxígeno se leen siempre de nativos, no del framework.

Autodetección

La detección respeta Config.Framework. Con 'auto' comprueba, en orden, qué recurso está iniciado y selecciona el framework correspondiente. También puedes forzar un modo concreto poniendo Config.Framework a 'esx', 'qbcore', 'qbox' o 'standalone'. Consulta Configuración (config.lua) para la referencia completa de la opción.

  • ESX — se detecta cuando el recurso es_extended está iniciado; carga el objeto compartido mediante exports['es_extended']:getSharedObject().
  • Qbox — se detecta cuando el recurso qbx_core está iniciado.
  • QBCore — se detecta cuando el recurso qb-core está iniciado; carga el objeto core mediante exports['qb-core']:GetCoreObject().
  • Standalone — el respaldo cuando no hay ningún framework soportado iniciado, o cuando se fuerza con Config.Framework = 'standalone'.
ℹ️La detección se ejecuta tras una breve espera de arranque (1000 ms) para que los frameworks terminen de iniciarse, y luego imprime el framework detectado en la consola: [PSTUDIOS-HUD] Framework detectado: <name>.

Lectores de estado

Cada framework tiene un lector que devuelve hambre, sed y estrés (0–100). ESX los lee de ESX.PlayerData.metadata (con compatibilidad con esx_status: cachea el evento esx_status:onTick para leer hambre/sed sin coste). QBCore y Qbox los leen del metadata del jugador. Si un lector falla, el puente degrada con elegancia a valores neutros.

Modo standalone

En modo standalone el puente devuelve valores de estado neutros (hambre y sed al 100, estrés a 0), por lo que los anillos permanecen llenos y cosméticos. El HUD funciona por completo sin ningún framework — solo el estado proveniente del framework (hambre/sed/estrés) no está disponible.