> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dopenuis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eventos

> Seja bem-vindo a aba de eventos do [dope_hud](https://www.youtube.com/watch?v=REsFxvWVm3s)

<Info>
  **Aviso**: O campo `source` é necessário apenas para o lado do servidor.
</Info>

## Notify de item `dope_item`

Enviar uma notificação ao jogador sempre que ele receber ou perder um item.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="item" type="string" required>
      Nome da imagem do item, onde o envio do arquivo .png não é necessário.
    </ResponseField>

    <ResponseField name="amount" type="number" required>
      Quantidade do item recebido
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Tipo da notify enviada podendo ser `enviado` ou `recebido`
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Nome formatado do item
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('dope_item', source, 'lockpick', 4, 'recebido', 'Lockpick')
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('dope_item', 'lockpick', 4, 'recebido', 'Lockpick')
  ```
</ResponseField>

## Notify normal `Notify`

Envie uma notificação para o jogador.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Tipo de notificação, com opções de configuração disponíveis no arquivo localizado em `dope_hud/client-side/Config_Client.lua`.
    </ResponseField>

    <ResponseField name="message" type="string" required>
      Qual será a mensagem a ser enviada para a notificação
    </ResponseField>

    <ResponseField name="timer" type="number" required>
      Tempo da notificação em milisegundos
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('Notify', source, 'sucesso', 'Esse é um exemplo', 15000)
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('Notify', 'sucesso', 'Esse é um exemplo', 15000)
  ```
</ResponseField>

## Barra de progresso `progress`

Inicie uma barra de progresso para o jogador, simbolizando a conclusão de uma ação.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="message" type="string" required>
      Qual será a mensagem a ser enviada para a barra de progresso
    </ResponseField>

    <ResponseField name="timer" type="number" required>
      Tempo da barra de progresso em milisegundos
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('progress', source, 20000, 'Esse é um exemplo')
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('progress', 'sucesso', 'Esse é um exemplo', 15000)
  ```
</ResponseField>

## Atualizar fome e sede `dope_hud:verifyFomeSede`

Atualize os valores de fome e sede do jogador.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="fome" type="number" required>
      Valor atual da fome do jogador
    </ResponseField>

    <ResponseField name="sede" type="number" required>
      Valor atual da sede do jogador
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('dope_hud:verifyFomeSede', source, 0.9, 0.4)
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('dope_hud:verifyFomeSede', 0.9, 0.4)
  ```
</ResponseField>

## Atualizar estresse `dope_hud:verifyStress`

Atualize o valor do stress do jogador

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="stress" type="number" required>
      Valor atual do stress do jogador
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('dope_hud:verifyStress', source, 0.9)
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('dope_hud:verifyStress', 0.9)
  ```
</ResponseField>

## Ativar/Desativar a interface `dope_hud:disable`

Habilite ou desabilite a interface do velocímetro e o status do jogador.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="fome" type="boolean" required>
      `true` = desativa a interface / `false` = ativa a interface
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('dope_hud:disable', source, false)
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('dope_hud:disable', true)
  ```
</ResponseField>

## Enviar mensagem no chat `chat:addMessage`

Envie uma mensagem direta através do chat da HUD.

<ResponseField>
  <Expandable title="Args">
    <ResponseField name="source" type="string" required>
      Identificação da source do jogador que está realizando a ação
    </ResponseField>

    <ResponseField name="message" type="string" required>
      Mensagem a ser enviada no chat
    </ResponseField>
  </Expandable>

  Exemplo (server-side):

  ```lua theme={null}
  TriggerClientEvent('chat:addMessage', source, 'Esse é um exemplo')
  ```

  Exemplo (client-side):

  ```lua theme={null}
  TriggerEvent('chat:addMessage', 'Esse é um exemplo')
  ```
</ResponseField>