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

# Eventos

> Integre nosso produto com outros scripts de seu servidor, deixando tudo muito mais legal e com sua cara.

## Client-side

### heyy\_houses:onTabletOpen

> Esse evento é exclusivamente de leitura, dispará-lo não fará nenhum evento dentro do script.

Esse evento é disparado toda vez que o tablet é aberto. Um exemplo básico de uso (que é utilizado por nós) é remover arma da mão do jogador para que a animação fique correta, por exemplo.

**Exemplo de uso:**

```lua theme={null}
AddEventHandler("heyy_houses:onTabletOpen", function()
    -- seu código
end)
```

### heyy\_houses:closeUI

Ao disparar esse evento qualquer interface do script é fechada.

**Exemplo de uso:**

```lua theme={null}
-- client-side
TriggerEvent("heyy_houses:closeUI")

-- server-side
TriggerClientEvent("heyy_houses:closeUI", source)
```

### heyy\_houses:requestChestOpen

> Esse evento é exclusivamente de leitura, dispará-lo não fará nenhum evento dentro do script.

Disparado ao tentar abrir o baú de uma propriedade, após todas as verificações de permissão.

Esse evento normalmente é utilizado para abrir o baú da propriedade. Há um equivalente à ele no server, caso seja mais fácil de realizar a abertura por lá. Consulte `heyy_houses:server:requestChestOpen`

**Parâmetros:**

* data
* name: `string`
  * Um nome único vinculado à propriedade. Segue o formato `P-{property_id}`
* display: `string`
  * O nome bonito e formatado da propriedade
* coords: `vector3`
  * A coordenada do baú
* level: `integer`
  * O nível atual do baú
* weight: `integer`
  * O peso máximo suportado pelo baú, de acordo com o nível atual
* slots: `integer`
  * A quantidade de slots do baú, de acordo com o nível atual

<Tip>
  Caso seu script de baú não suporte alterações no número de slots, ou você não queira utilizar, você pode comentar todas as linhas `chestSlots` em `heyy_houses/config/config.lua`, assim não haverá mais nenhuma menção de mais slots quando o jogador for melhorar o baú pela interface.
</Tip>

**Exemplo de uso:**

```lua theme={null}
AddEventHandler("heyy_houses:requestChestOpen", function(data)
    -- seu código para abrir o baú, por exemplo
end)
```

## Server-side

### heyy\_houses:server:requestChestOpen

> Esse evento é exclusivamente de leitura, dispará-lo não fará nenhum evento dentro do script.

Disparado ao tentar abrir o baú de uma propriedade, após todas as verificações de permissão.

Esse evento normalmente é utilizado para abrir o baú da propriedade. Há um equivalente à ele no client, caso seja mais fácil de realizar a abertura por lá. Consulte `heyy_houses:requestChestOpen`

**Parâmetros:**

* data
  * Consulte `heyy_houses:requestChestOpen`, as informações são as mesmas.

**Exemplo de uso:**

```lua theme={null}
-- É necessário utilizar RegisterNetEvent ao invés de AddEventHandler, já que o evento é disparado pelo client.
RegisterNetEvent("heyy_houses:server:requestChestOpen", function(data)
  local src = source
  -- seu código para abrir o baú, por exemplo
end)
```