Skip to content

CLAUDE.md

Latest commit

 

History

History
36 lines (25 loc) · 1.96 KB

CLAUDE.md

File metadata and controls

36 lines (25 loc) · 1.96 KB
Raw

mri_Qhud — avisos para o Claude / IA

⚠️ LEIA ANTES DE "CORRIGIR" QUALQUER COISA

Este resource foi renomeado de ps-hud / mri-hud para mri_Qhud (jul/2026). O nome da pasta É o nome do resource no FiveM — exports, callbacks NUI e GetParentResourceName() seguem o nome da pasta automaticamente.

Se a HUD "parou de funcionar" ou os exports "não existem", a causa mais provável é a pasta local ainda se chamar ps-hud ou mri-hud.

A correção é UMA só: renomear a pasta para mri_Qhud (com o servidor parado — o FXServer trava a pasta enquanto roda).

❌ NÃO saia reescrevendo código, renomeando eventos, mexendo em exports ou "consertando" referências para fazer funcionar com outro nome de pasta. Isso quebra o projeto inteiro.

O que usa o nome novo mri_Qhud

  • Chamadas de outros resources: exports['mri_Qhud']:AdjustVital(...), AddHudPanel, SetHudOrb, SetDigitalElement, ApplySkinPreset, etc.
  • Evento do odômetro: mri_Qhud:client:setOdometer (antes era ps-hud:client:setOdometer).
  • Fallback de dev da NUI (web/src/utils/eventHandler.ts).

O que continua com o prefixo antigo mri_hud — DE PROPÓSITO, não "corrija"

  • Eventos/callbacks internos: mri_hud:* (settings, presets, db:ready...). São internos ao resource; funcionam com qualquer nome de pasta.
  • Tabelas do banco: mri_hud_settings e mri_hud_skin_presets. Renomear exige migração de dados — não mexa.
  • Prints de log [mri_hud] e CSS vars legadas --ps-hud-*.

Outras notas

  • ensure [novos] no server.cfg já sobe o resource — não precisa de linha própria.
  • URLs do GitHub ainda apontam pra mri-Qbox-Brasil/mri-hud (o repo remoto ainda não foi renomeado; o GitHub redireciona quando for).
  • web/node_modules pode não existir — rode pnpm install em web/ antes de pnpm build. O html/ compilado já está no repo, então o resource roda sem build.
  • Os handoffs de design ficam em docs/design_handoff_* (movidos da raiz).