Eventos para o Cliente (TriggerEvent)

Customização de Roupas

Aplicar Roupas Permanentemente

guardian-customization:applyPermanent

Descrição: Aplica permanentemente um conjunto de roupas ao personagem e salva no banco de dados.

Uso:

TriggerEvent("guardian-customization:applyPermanent", skinData)

Parâmetros:

  • skinData (table): Tabela contendo todas as informações de roupa
    {
      pants = {item = number, texture = number}, -- Calças (ID do item e textura)
      arms = {item = number, texture = number}, -- Braços
      tshirt = {item = number, texture = number}, -- Camiseta
      torso = {item = number, texture = number}, -- Torso
      vest = {item = number, texture = number}, -- Colete
      shoes = {item = number, texture = number}, -- Sapatos
      mask = {item = number, texture = number}, -- Máscara
      hat = {item = number, texture = number}, -- Chapéu
      glass = {item = number, texture = number}, -- Óculos
      ear = {item = number, texture = number}, -- Acessório de orelha
      watch = {item = number, texture = number}, -- Relógio
      bracelet = {item = number, texture = number}, -- Pulseira
      accessory = {item = number, texture = number}, -- Acessório
      decals = {item = number, texture = number} -- Decalques
    }
    

Aplicar Roupas Temporariamente

guardian-customization:applyTemporary

Descrição: Aplica temporariamente um conjunto de roupas ao personagem sem salvar no banco de dados. Útil para visualização antes da compra.

Uso:

TriggerEvent("guardian-customization:applyTemporary", skinData)

Parâmetros:

  • skinData (table): Mesma estrutura do evento applyPermanent

Retornar às Roupas Anteriores

guardian-customization:returnTemporary

Descrição: Retorna às roupas anteriores após uma aplicação temporária.

Uso:

TriggerEvent("guardian-customization:returnTemporary")

Parâmetros: Nenhum

Redefinir Roupas

guardian-customization:resetClothing

Descrição: Redefine as roupas do personagem para as salvas no banco de dados.

Uso:

TriggerEvent("guardian-customization:resetClothing", otherPed)

Parâmetros:

  • otherPed (number, opcional): ID do ped para aplicar as roupas, se diferente do jogador

Aplicar Roupas Específicas

guardian-customization:someClothing

Descrição: Aplica um conjunto específico de roupas ao personagem.

Uso:

TriggerEvent("guardian-customization:someClothing", tableClothes, otherPed)

Parâmetros:

  • tableClothes (table): Tabela contendo apenas as partes de roupa a serem alteradas
  • otherPed (number, opcional): ID do ped para aplicar as roupas, se diferente do jogador

Bloquear Comandos de Roupa

guardian-customization:blockCommands

Descrição: Bloqueia ou desbloqueia comandos relacionados a roupas.

Uso:

TriggerEvent("guardian-customization:blockCommands", status)

Parâmetros:

  • status (boolean): true para bloquear, false para desbloquear

Abrir Criador de Roupas

guardian-customization:openCreator

Descrição: Abre o criador de roupas personalizado.

Uso:

TriggerEvent("guardian-customization:openCreator")

Parâmetros: Nenhum

Abrir Menu de Roupas

guardian-customization:openMenu

Descrição: Abre o menu de seleção de roupas.

Uso:

TriggerEvent("guardian-customization:openMenu")

Parâmetros: Nenhum

Alterar Parte de Roupa

guardian-customization:changeClothPart

Descrição: Altera uma parte específica da roupa do personagem.

Uso:

TriggerEvent("guardian-customization:changeClothPart", clothPart, itemId, textureId)

Parâmetros:

  • clothPart (string): Nome da parte da roupa (ex: “pants”, “tshirt”, “torso”)
  • itemId (number): ID do item a ser aplicado
  • textureId (number): ID da textura a ser aplicada

Alternar Visibilidade de Roupa

guardian-customization:toggleClothPart

Descrição: Alterna a visibilidade de uma parte específica da roupa.

Uso:

TriggerEvent("guardian-customization:toggleClothPart", clothPart, status)

Parâmetros:

  • clothPart (string): Nome da parte da roupa (ex: “mask”, “hat”, “glass”)
  • status (boolean, opcional): true para mostrar, false para esconder. Se não for fornecido, alterna o estado atual.

Customização de tatuagens

Aplicar Tatuagens

guardian-tattoos:apply

Descrição: Aplica tatuagens ao personagem.

Uso:

TriggerEvent("guardian-tattoos:apply", tattooList)

Parâmetros:

  • tattooList (table): Lista de tatuagens a serem aplicadas
    {
      [1] = {name = "nome_tatuagem", collection = "colecao_tatuagem"},
      [2] = {name = "nome_tatuagem2", collection = "colecao_tatuagem2"},
      -- etc.
    }
    

Retornar às Tatuagens Anteriores

guardian-tattoos:returnTattoos

Descrição: Retorna às tatuagens anteriores após uma visualização.

Uso:

TriggerEvent("guardian-tattoos:returnTattoos")

Parâmetros: Nenhum

Abrir Menu de Tatuagens

guardian-tattoos:openSystem

Descrição: Abre o menu de tatuagens.

Uso:

TriggerEvent("guardian-tattoos:openSystem")

Parâmetros: Nenhum

Eventos para o Servidor (TriggerServerEvent)

Gerenciamento de Localização

Adicionar Localização de Loja de Roupas

guardian-customization:insertSkinshop

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

Uso:

TriggerServerEvent("guardian-customization:insertSkinshop", coords)

Parâmetros:

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

Adicionar Localização de Loja de Tatuagens

guardian-tattoos:insertTattoos

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

Uso:

TriggerServerEvent("guardian-tattoos:insertTattoos", coords)

Parâmetros:

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

Gerenciamento de Props

Remover Props

guardian-customization:removeProps

Descrição: Remove props (acessórios) de um jogador próximo. Requer permissões específicas (Polícia, Paramédico).

Uso:

TriggerServerEvent("guardian-customization:removeProps", propData)

Parâmetros:

  • propData (table): Informações sobre o prop a ser removido
    {
      type = "hat" -- Tipo do prop (hat, mask, glass, etc.)
    }
    

Comandos de Chat

Os seguintes comandos podem ser digitados diretamente no chat do jogo:

/skinshop

Descrição: Abre o menu da loja de roupas.

Uso:

/skinshop

/mascara [id] [textura]

Descrição: Altera a máscara do personagem.

Uso:

/mascara 54 2

Parâmetros:

  • id (number): ID do item da máscara
  • textura (number): ID da textura da máscara

/camisa [id] [textura]

Descrição: Altera a camiseta do personagem.

Uso:

/camisa 15 3

Parâmetros:

  • id (number): ID do item da camiseta
  • textura (number): ID da textura da camiseta

/jaqueta [id] [textura]

Descrição: Altera a jaqueta/torso do personagem.

Uso:

/jaqueta 24 1

Parâmetros:

  • id (number): ID do item da jaqueta
  • textura (number): ID da textura da jaqueta

/calca [id] [textura]

Descrição: Altera a calça do personagem.

Uso:

/calca 10 5

Parâmetros:

  • id (number): ID do item da calça
  • textura (number): ID da textura da calça

/sapatos [id] [textura]

Descrição: Altera os sapatos do personagem.

Uso:

/sapatos 18 0

Parâmetros:

  • id (number): ID do item dos sapatos
  • textura (number): ID da textura dos sapatos

/chapeu [id] [textura]

Descrição: Altera o chapéu do personagem.

Uso:

/chapeu 33 1

Parâmetros:

  • id (number): ID do item do chapéu
  • textura (number): ID da textura do chapéu

/oculos [id] [textura]

Descrição: Altera os óculos do personagem.

Uso:

/oculos 5 2

Parâmetros:

  • id (number): ID do item dos óculos
  • textura (number): ID da textura dos óculos

Exemplos de Uso

Exemplo 1: Aplicar um conjunto completo de roupas temporariamente

local roupasFesta = {
    pants = {item = 10, texture = 2},
    arms = {item = 15, texture = 0},
    tshirt = {item = 15, texture = 0},
    torso = {item = 24, texture = 5},
    shoes = {item = 20, texture = 0},
    mask = {item = 0, texture = 0},
    hat = {item = 33, texture = 0},
    glass = {item = 5, texture = 0}
}

-- Aplicar temporariamente para visualização
TriggerEvent("guardian-customization:applyTemporary", roupasFesta)

-- Se gostar, aplicar permanentemente
TriggerEvent("guardian-customization:applyPermanent", roupasFesta)

-- Se não gostar, retornar às roupas anteriores
TriggerEvent("guardian-customization:returnTemporary")

Exemplo 2: Alterar apenas uma parte da roupa

-- Alterar apenas a máscara
TriggerEvent("guardian-customization:changeClothPart", "mask", 54, 2)

-- Alterar apenas o chapéu
TriggerEvent("guardian-customization:changeClothPart", "hat", 33, 1)

Exemplo 3: Remover e colocar acessórios

-- Remover chapéu
TriggerEvent("guardian-customization:toggleClothPart", "hat", false)

-- Colocar óculos
TriggerEvent("guardian-customization:toggleClothPart", "glass", true)

Notas Importantes

  1. Alguns comandos e funções podem estar restritos a permissões específicas.
  2. Os IDs de itens e texturas variam dependendo do modelo do personagem (masculino/feminino).
  3. Recomenda-se usar o menu da loja de roupas (/skinshop) para visualizar todas as opções disponíveis.
  4. Alterações permanentes são salvas no banco de dados e persistem entre sessões de jogo.
  5. Algumas roupas podem ter restrições baseadas em empregos ou status do personagem.