O que é um script de elevador para FiveM?
Um script de elevador para FiveM é um recurso personalizado que adiciona elevadores funcionais e interativos em edifícios com vários andares no seu servidor de roleplay. Sem um recurso dedicado, os jogadores de GTA V / FiveM não têm uma forma realista de se deslocar entre andares — são forçados a usar escadas, comandos de teletransporte ou gambiarras que quebram a imersão instantaneamente.
Um bom script de elevador apresenta aos jogadores um painel NUI in-game quando entram na zona de chamada. Eles selecionam o andar de destino, as portas se animam ao fechar, o personagem se desloca suavemente até o nível alvo, efeitos sonoros são reproduzidos e as portas se abrem na chegada. Toda a interação parece uma parte genuína do mundo do jogo, não um recurso improvisado.
Para servidores de roleplay sérios — complexos de apartamentos, hospitais, delegacias, escritórios em arranha-céus, estacionamentos de vários andares — um bom script de elevador não é luxo. É a diferença entre um edifício que parece vivo e um cenário vazio. Em 2026, o Agency-Elevator da TDYSKY se tornou a solução gratuita de referência da comunidade, e este guia cobre tudo o que você precisa saber para configurá-lo no seu servidor.
Por que escolher o Agency-Elevator?
Existem alguns scripts de elevador nos fóruns do FiveM e no GitHub, mas a maioria sofre de um ou mais problemas sérios: código desatualizado que quebra nas versões modernas do FiveM, sem manutenção ativa, coordenadas de andares fixas no código, sem painel NUI, ou tratamento de animações ruim que faz os jogadores atravessarem a geometria.
O Agency-Elevator foi construído para resolver todos esses problemas de forma limpa. É mantido ativamente pela equipe TDYSKY, totalmente documentado e — crucialmente — completamente gratuito. Você pode obtê-lo diretamente na loja Tebex sem custo nenhum. Veja por que ele se destaca:
- Suporte multi-andar: Defina quantos andares seu edifício tiver. Não há limite fixo no script.
- Animações suaves: O script usa animações nativas do GTA V e teletransportes cuidadosamente sincronizados para que os jogadores não percebam saltos bruscos de posição.
- Painel NUI de seleção de andar: Um overlay de navegador limpo e leve exibe o andar atual e permite que os jogadores cliquem ou pressionem para selecionar seu destino.
- Efeitos sonoros: Campainha do elevador, som de abertura/fechamento das portas e sons ambientes de movimento já incluídos.
- Totalmente configurável: Cada edifício, cada cabine, cada coordenada de andar, cada rótulo — tudo definido em um único arquivo
Config.lua. - Independente de framework: Funciona com QBCore, ESX e configurações completamente Standalone. Sem dependência de framework por padrão.
- Custo zero: GRATUITO — sem pagamento, sem escrow, sem assinatura Tebex além de uma conta gratuita.
Análise detalhada das funcionalidades
Edifícios multi-andar
Cada elevador no Agency-Elevator é definido como uma entrada de tabela na configuração. Você especifica a zona de ativação (onde o jogador fica para chamar o elevador) e lista cada andar com seu nome, coordenadas de destino (x, y, z, orientação) e opcionalmente uma restrição de acesso. Você pode definir elevadores para qualquer número de edifícios em um único recurso — hospital, delegacia, bloco de apartamentos, torre de cassino — tudo gerenciado em um só lugar.
Painel NUI
Quando um jogador entra em uma zona de ativação de elevador, um painel NUI flutuante aparece com uma transição suave. Ele lista todos os andares disponíveis com seus rótulos (por exemplo, "Térreo", "2º andar — Apartamentos", "Cobertura"). Os jogadores clicam no destino ou navegam com os controles do teclado. O painel segue o design da Agency Scripts, mas é totalmente personalizável pelos arquivos HTML/CSS do NUI se você quiser adaptá-lo à identidade visual do seu servidor.
Animações e som
O Agency-Elevator reproduz uma animação de fechamento das portas com o som correspondente quando um andar é selecionado, depois teletransporta o jogador para o andar de destino após um atraso configurável. Ao chegar, o som de abertura das portas é reproduzido e o painel desaparece. Todos os tempos de animação e som são configuráveis no Config.lua para que você ajuste a sensação à velocidade dos elevadores do seu edifício.
Restrições de acesso
Andares individuais podem ser bloqueados por verificações de cargo (QBCore/ESX) ou de item de inventário. Por exemplo, você pode restringir o acesso à cobertura de um prédio de apartamentos a jogadores que possuam a chave da cobertura, ou limitar o andar da sala de servidores a cargos de policial ou administração. Quando um jogador tenta selecionar um andar restrito sem o cargo ou item necessário, uma notificação é exibida e o elevador não se move.
Zonas de ativação configuráveis
Cada gatilho de elevador é definido por uma posição 3D e um raio. Você também pode adicionar opcionalmente um marcador (blip) para que novos jogadores consigam encontrar o elevador a pé. Os marcadores podem ser desativados em servidores que preferem um minimapa mais limpo.
Instalação: passo a passo
Passo 1 — Baixar o Agency-Elevator
Acesse a listagem no Tebex em agency-script.tebex.io/package/7285036 e adicione o Agency-Elevator ao carrinho. É GRATUITO — basta finalizar o pedido com valor zero. Você receberá um link de download pelo sistema de entrega do Tebex (vinculado à sua conta CFX ou fornecido como download direto).
Passo 2 — Colocar o recurso
Extraia o arquivo baixado e coloque a pasta agency-elevator no diretório resources do seu servidor (ou em uma subpasta como resources/[scripts]/).
Passo 3 — Adicionar ao server.cfg
Abra seu server.cfg e adicione a seguinte linha após o recurso do seu framework:
ensure agency-elevator
Passo 4 — Configurar o Config.lua
Abra agency-elevator/config/Config.lua e configure seus elevadores. Consulte a seção abaixo para um exemplo completo. No mínimo, você precisa definir seu framework e pelo menos um elevador com pelo menos dois andares.
Passo 5 — Iniciar o servidor
Reinicie seu servidor (ou use refresh + start agency-elevator no console do servidor). Aproxime-se de qualquer zona de ativação de elevador no jogo e o painel NUI deverá aparecer. Verifique o console do servidor se o painel não aparecer — a maioria dos problemas são coordenadas incorretas na configuração.
Exemplo de Config.lua
Abaixo está um exemplo representativo da configuração do Agency-Elevator. Adapte as coordenadas ao mapa e interiores de edifícios do seu servidor:
-- Agency-Elevator: Config.lua
Config = {}
-- Framework: "standalone", "qbcore", or "esx"
Config.Framework = "qbcore"
-- Show floor markers on the minimap
Config.ShowBlips = false
-- Default floor label shown when no floor is selected
Config.DefaultFloorLabel = "Select Floor"
-- Elevator transition delay in milliseconds (door close → teleport)
Config.TransitionDelay = 1500
-- Enable NUI debug mode (shows borders on the panel)
Config.Debug = false
-- Define your elevators
Config.Elevators = {
{
name = "Mission Row PD - Elevator",
-- Zone where players stand to call the elevator
trigger = { x = 441.6, y = -982.3, z = 30.7, radius = 1.5 },
floors = {
{ label = "Ground Floor", coords = { x = 441.6, y = -982.3, z = 30.7, h = 90.0 } },
{ label = "2nd Floor", coords = { x = 441.6, y = -982.3, z = 34.7, h = 90.0 } },
{ label = "3rd Floor", coords = { x = 441.6, y = -982.3, z = 38.7, h = 90.0 } },
{
label = "Roof Access",
coords = { x = 441.6, y = -982.3, z = 50.7, h = 90.0 },
-- Restrict to police jobs only
jobRestrict = { "police", "sheriff" },
},
},
},
{
name = "Alta Apartments - Elevator",
trigger = { x = -268.4, y = -955.8, z = 31.2, radius = 1.5 },
floors = {
{ label = "Lobby", coords = { x = -268.4, y = -955.8, z = 31.2, h = 0.0 } },
{ label = "Floor 2", coords = { x = -268.4, y = -955.8, z = 35.2, h = 0.0 } },
{ label = "Floor 3", coords = { x = -268.4, y = -955.8, z = 39.2, h = 0.0 } },
{
label = "Penthouse",
coords = { x = -268.4, y = -955.8, z = 48.0, h = 0.0 },
-- Restrict to players who own this item
itemRestrict = "penthouse_key",
},
},
},
}
Compatibilidade com frameworks
Ao definir Config.Framework = "standalone", o Agency-Elevator funciona sem nenhuma dependência de QBCore ou ESX. A seleção de andar e o painel NUI funcionam perfeitamente no modo standalone; as únicas funcionalidades que exigem um framework são as verificações opcionais de cargo e item em andares individuais. Se você definir Config.Framework = "qbcore" ou "esx", o script carrega a bridge correspondente para verificar cargos e itens de inventário dos jogadores quando um andar restrito é selecionado.
Documentação e suporte
A documentação completa — incluindo todas as opções de configuração, dicas de coordenadas, personalização do NUI e perguntas frequentes — está disponível em docs.agencyg.de/elevator. Se você tiver problemas, o servidor do Discord da TDYSKY é a forma mais rápida de obter suporte do desenvolvedor e da comunidade.
Preço: completamente gratuito
O Agency-Elevator tem um preço de GRATUITO. Sem pegadinhas — sem escrow, sem assinatura, sem nível premium que desbloqueia recursos ocultos. O script completo com todas as funcionalidades descritas neste artigo está disponível sem nenhum custo. Esta é a forma da TDYSKY retribuir à comunidade FiveM enquanto demonstra a qualidade da linha Agency Scripts. Você obtém a mesma qualidade de construção e manutenção ativa dos scripts pagos, sem nenhum gasto.
Para contextualizar: muitos recursos de elevador comparáveis nos fóruns do CFX estão desatualizados, são de código fechado ou cobram vários euros por funcionalidades que o Agency-Elevator oferece gratuitamente. Se você tem adiado a adição de elevadores ao seu servidor por questões de custo ou qualidade, já não há razão para esperar.
Para quem é o Agency-Elevator?
O Agency-Elevator é a escolha certa para qualquer servidor FiveM que tenha:
- Edifícios internos com vários andares — hospitais, delegacias, tribunais, torres de escritórios, complexos de apartamentos, estacionamentos cobertos
- Comunidades de RP sérias que se preocupam com imersão e não querem que jogadores se teletransportem ou usem comandos de chat para trocar de andar
- Qualquer configuração de framework — QBCore, ESX ou builds standalone completamente personalizados funcionam desde o primeiro momento
- Servidores com orçamento limitado — não custa nada, então não há barreira financeira para uma experiência de elevador bem cuidada
Comece agora
O download está a um clique de distância. Acesse a listagem no Tebex, finalize o pedido gratuito, coloque o recurso no seu servidor, adicione ensure agency-elevator ao seu server.cfg, configure seus andares e pronto. A instalação completa geralmente leva menos de 15 minutos para um único edifício. A documentação detalhada em docs.agencyg.de/elevator guia você por cada opção se precisar de ajuda.