Pular para o conteúdo principal
Hero Dark

​
Resolva problemas comuns

Resource não inicia

Está com problemas para iniciar o seu produto? Clique aqui

Configurar o resource

Está com dúvidas de como configurar algo no sistema? Clique aqui
Hero Dark

​
Sobre o sistema

A proposta do Radar system é unir performance, personalização e controle total. O jogador tem liberdade para configurar o mapa do jeito que quiser, e o dono do servidor tem poder absoluto para definir o padrão, limitar opções e integrar com outros sistemas. Com as funções exportadas, você pode:
  • Controlar a visualização da minimap e bigmap;
  • Criar rotas personalizadas no GPS (útil para sistemas com rotas de entrega, empregos, missões, etc.);
  • Criar zonas dinâmicas no radar/bigmap, com opções de renderização, ícones personalizados e cores (ótimo para demarcar safe zones, territórios, zonas de perigo, etc.);
  • E muito mais, com a flexibilidade de integrar essas funcionalidades em outros sistemas.

​
Funções Exportadas

​
Client-side

​
Server-side

​
changeMinimapVisualization

Side: client e server Client syntax 
exports['sqh_radar']:changeMinimapVisualization('on' or 'off')
Server syntax 
exports['sqh_radar']:changeMinimapVisualization(player, 'on' or 'off')
Required arguments
  • state (string): 'on' para ligar ou 'off' para desligar.
Server required arguments
  • player (player): jogador alvo que terá a minimap ligada/desligada.
  • state (string): 'on' para ligar ou 'off' para desligar.
Return (server)
  • true em sucesso.
  • false em falha (player inválido, estado inválido, ou cliente ainda não liberado).
Example 
-- CLIENT-SIDE
bindKey('F7', 'down', function()
    exports['sqh_radar']:changeMinimapVisualization('off')
end)

-- SERVER-SIDE
addCommandHandler('minimapoff', function(player)
    local ok = exports['sqh_radar']:changeMinimapVisualization(player, 'off')
    outputChatBox(ok and 'Minimap desligada' or 'Falha ao desligar minimap', player)
end)

​
changeBigmapVisualization

Side: client e server Client syntax 
exports['sqh_radar']:changeBigmapVisualization('on' or 'off')
Server syntax 
exports['sqh_radar']:changeBigmapVisualization(player, 'on' or 'off')
Required arguments
  • state (string): 'on' para abrir ou 'off' para fechar.
Server required arguments
  • player (player): jogador alvo que terá o bigmap alterado.
  • state (string): 'on' para abrir ou 'off' para fechar.
Comportamento
  • Em 'on', abre o bigmap com fluxo completo (cursor, navegação e render).
  • Em 'off', fecha o bigmap caso esteja aberto.
Return (server)
  • true em sucesso.
  • false em falha (player inválido, estado inválido, ou cliente ainda não liberado).
Example 
-- CLIENT-SIDE
addCommandHandler('bigmapoff', function()
    exports['sqh_radar']:changeBigmapVisualization('off')
end)

-- SERVER-SIDE
addCommandHandler('bloquearmapa', function(player)
    local ok = exports['sqh_radar']:changeBigmapVisualization(player, 'off')
    outputChatBox(ok and 'Bigmap fechado' or 'Falha ao fechar bigmap', player)
end)

​
createGPSRoute

Side: client e server Client syntax 
exports['sqh_radar']:createGPSRoute(player, x, y, z)
Server syntax 
exports['sqh_radar']:createGPSRoute(player, x, y, z)
Required arguments
  • player (player)
    • No client: deve ser o localPlayer.
    • No server: player alvo que receberá a rota.
  • x (number): coordenada X do destino.
  • y (number): coordenada Y do destino.
Optional arguments
  • z (number): coordenada Z do destino (padrão 0).
Return
  • true quando a rota é criada/atualizada.
  • false em falha (principalmente no server: player inválido ou coordenadas inválidas).
Client example 
-- CLIENT-SIDE
addCommandHandler('rotacasa', function()
    local created = exports['sqh_radar']:createGPSRoute(localPlayer, 1480.25, -1732.80, 13.55)
    outputChatBox(created and 'Rota criada/atualizada' or 'Falha ao criar rota')
end)
Server example 
-- SERVER-SIDE
addCommandHandler('setrota', function(player)
    local success = exports['sqh_radar']:createGPSRoute(player, 1480.25, -1732.80, 13.55)
    outputChatBox(success and 'Rota enviada para você' or 'Falha ao enviar rota', player)
end)

​
createRadarZone

Side: server Syntax 
local zoneIdOrFalse = exports['sqh_radar']:createRadarZone(zoneData)
Required arguments
  • zoneData (table) com campos obrigatórios:
    • id (string)
    • x (number)
    • y (number)
    • width (number > 0)
    • height (number > 0)
Optional fields
  • name (string) - padrão: id
  • owner (string)
  • renderMode ('name' ou 'blip')
  • blipId (number)
  • blip (number) (alias de blipId)
  • color ('#RRGGBB')
  • icon (string) caminho de ícone
Return
  • string com o ID normalizado da zona em sucesso.
  • false em falha.
Example 
-- SERVER-SIDE
addCommandHandler('criarzona', function(player)
    local px, py = getElementPosition(player)

    local zoneId = exports['sqh_radar']:createRadarZone({
        id = 'zona_evento',
        name = 'Zona de Evento',
        owner = 'Administração',
        x = px - 25,
        y = py - 25,
        width = 50,
        height = 50,
        renderMode = 'blip',
        blipId = 41,
        color = '#E13B3B'
    })

    outputChatBox(zoneId and ('Zona criada: ' .. zoneId) or 'Falha ao criar zona', player)
end)

​
removeRadarZone

Side: server Syntax 
local success = exports['sqh_radar']:removeRadarZone(zoneId)
Required arguments
  • zoneId (string): ID da zona a remover.
Return
  • true se removeu.
  • false se não encontrou ou falhou.
Example 
-- SERVER-SIDE
addCommandHandler('removerzona', function(player, _, zoneId)
    if not zoneId then
        outputChatBox('Use: /removerzona <id>', player)
        return
    end

    local success = exports['sqh_radar']:removeRadarZone(zoneId)
    outputChatBox(success and 'Zona removida' or 'Zona não encontrada', player)
end)

​
getRadarZones

Side: server Syntax 
local zones = exports['sqh_radar']:getRadarZones()
Return
  • table de zonas dinâmicas no formato:
{
    {
        id = 'zona_id',
        name = 'Nome',
        owner = 'Owner',
        icon = 'assets/blips/41.png',
        renderMode = 'name' or 'blip',
        blipId = 41,
        color = '#81B3FF',
        x = 1000,
        y = -1200,
        width = 40,
        height = 40
    },
    ...
}
Example 
-- SERVER-SIDE
addCommandHandler('listarzonas', function(player)
    local zones = exports['sqh_radar']:getRadarZones() or {}
    outputChatBox('Total de zonas: ' .. tostring(#zones), player)

    for _, zone in ipairs(zones) do
        outputChatBox(string.format('- %s (%s)', tostring(zone.name), tostring(zone.id)), player)
    end
end)

​
Observações

  • Todas as exports exigem que o resource já tenha sido liberado pela proteção.
  • As funções acima seguem o que está exportado no meta.xml do sqh_radar.