Eventos para o Cliente (TriggerEvent)

Gerenciamento de Personagens

Criar Personagem

guardian-character:createCharacter

Descrição: Inicia o processo de criação de personagem, abrindo a interface de criação.

Uso:

TriggerEvent("guardian-character:createCharacter", editMode)

Parâmetros:

  • editMode (boolean, opcional): Se true, abre o criador no modo de edição de um personagem existente.

Atualizar Personagem

guardian-character:updateCharacter

Descrição: Atualiza a aparência do personagem com base nos dados fornecidos.

Uso:

TriggerEvent("guardian-character:updateCharacter", data)

Parâmetros:

  • data (table): Tabela contendo todas as informações da aparência do personagem
    {
      gender = number, -- 0 para masculino, 1 para feminino
      face = number, -- ID do rosto
      skin = number, -- ID da cor da pele
      hair = number, -- ID do cabelo
      hairColor = number, -- ID da cor do cabelo
      eyebrows = number, -- ID das sobrancelhas
      eyebrowsColor = number, -- ID da cor das sobrancelhas
      beard = number, -- ID da barba
      beardColor = number, -- ID da cor da barba
      -- etc.
    }
    

Aplicar Modelo de Skin

guardian-character:applySkin

Descrição: Aplica um modelo específico de skin ao personagem.

Uso:

TriggerEvent("guardian-character:applySkin", modelHash)

Parâmetros:

  • modelHash (string/number): Hash do modelo a ser aplicado (ex: “mp_m_freemode_01” para masculino, “mp_f_freemode_01” para feminino)

Finalização de Roupas

guardian-character:finishedClothes

Descrição: Notifica o sistema que o processo de customização de roupas foi finalizado.

Uso:

TriggerEvent("guardian-character:finishedClothes")

Parâmetros: Nenhum

Configurar Personagens

guardian-character:setupChars

Descrição: Configura a interface de seleção de personagens.

Uso:

TriggerEvent("guardian-character:setupChars")

Parâmetros: Nenhum

Finalizar Carregamento QBX

guardian-character:finishedLoadQBX

Descrição: Notifica que o carregamento do framework QBX foi finalizado.

Uso:

TriggerEvent("guardian-character:finishedLoadQBX")

Parâmetros: Nenhum

Gerenciamento de HUD

Ativar/Desativar HUD

guardian-character:hudActived

Descrição: Ativa ou desativa a HUD do jogo.

Uso:

TriggerEvent("guardian-character:hudActived", status)

Parâmetros:

  • status (boolean): true para ativar, false para desativar

Sistema de Spawn

Spawn do Personagem

guardian-spawn:justSpawn

Descrição: Gerencia o spawn do personagem no mundo.

Uso:

TriggerEvent("guardian-spawn:justSpawn", status, spawnType)

Parâmetros:

  • status (table): Informações de localização para o spawn
    {
      x = number, -- Coordenada X
      y = number, -- Coordenada Y
      z = number, -- Coordenada Z
      h = number  -- Heading (direção)
    }
    
  • spawnType (boolean): Tipo de spawn (true para spawn inicial, false para respawn)

Barbearia

Abrir Barbearia

barbershop:openBarber

Descrição: Abre a interface da barbearia para personalização do personagem.

Uso:

TriggerEvent("barbershop:openBarber")

Parâmetros: Nenhum

Inserir Barbearia

creator:insertBarbershop

Descrição: Adiciona uma nova localização de barbearia no mapa.

Uso:

TriggerEvent("creator:insertBarbershop", locate)

Parâmetros:

  • locate (vector3): Coordenadas da barbearia
    {x, y, z} -- Coordenadas X, Y, Z
    

Resetar Não Pago

creator:resetNotPaid

Descrição: Reseta a aparência do personagem quando o pagamento não é realizado.

Uso:

TriggerEvent("creator:resetNotPaid", data, barbershop)

Parâmetros:

  • data (table): Dados da aparência anterior
  • barbershop (boolean): true se estiver na barbearia, false caso contrário

Eventos para o Servidor (TriggerServerEvent)

Finalizar Criação de Personagem

guardian-character:finishedCharacter

Descrição: Finaliza o processo de criação de personagem e salva os dados no banco de dados.

Uso:

TriggerServerEvent("guardian-character:finishedCharacter", characterData, status, data)

Parâmetros:

  • characterData (table): Dados do personagem criado
  • status (boolean): Status da criação
  • data (table, opcional): Dados adicionais

Recarregar Usuário

guardian-character:reloadUser

Descrição: Recarrega os dados do usuário.

Uso:

TriggerServerEvent("guardian-character:reloadUser", userId, source)

Parâmetros:

  • userId (number): ID do usuário
  • source (number): Source do jogador

Recarregar Personagem

guardian-character:reloadCharacter

Descrição: Recarrega os dados do personagem atual.

Uso:

TriggerServerEvent("guardian-character:reloadCharacter")

Parâmetros: Nenhum

Comandos de Chat

Comandos de Personagem

/newchar

Descrição: Abre o menu de criação de um novo personagem.

Uso: /newchar

Permissões: Requer permissão de administrador

/fixchar

Descrição: Corrige problemas com o personagem atual.

Uso: /fixchar

Permissões: Requer permissão de administrador

/barbershop

Descrição: Abre a barbearia para editar a aparência do personagem.

Uso: /barbershop

Permissões: Disponível para todos os jogadores