Voltar
Referência·

Glossário FiveM & Qbox

Dicionário dos termos técnicos mais usados no desenvolvimento de servidores FiveM com Qbox. Escrito para os programadores brasileiros que estão a começar ou que querem perceber melhor o ecossistema.

A

ACE Permissions

Sistema de permissões nativo do FXServer, assente em identifiers e principals. Define quem pode executar comandos de administração ou aceder a recursos restritos. Configura-se no server.cfg com add_ace.

add_ace identifier.fivem:O_SEU_ID command allow

ambient

No GTA V, refere-se aos NPCs e veículos que o motor do jogo espalha automaticamente pelo mapa. Em scripts de roleplay, convém normalmente reduzi-los ou desativá-los por questões de desempenho.

C

callback (lib.callback)

Mecanismo do ox_lib para a comunicação entre cliente e servidor com resposta assíncrona. Substitui o antigo padrão de TriggerServerEvent + TriggerClientEvent nos pares de pedido e resposta.

lib.callback.await('plugintest:server:getConfig', false)

CEF (Chromium Embedded Framework)

Motor que renderiza a NUI no FiveM. Usa uma versão do Chromium relativamente antiga: algumas funcionalidades modernas de CSS não funcionam, como backdrop-filter:blur.

Citizen.CreateThread

Função do FiveM para correr código assíncrono em ciclo. É o padrão em Lua para qualquer comportamento contínuo (ciclos de renderização, verificação periódica de estado, etc.).

convar

Console variable do FXServer. Configuração global definida no server.cfg (setr foo bar) e lida com GetConvar('foo', 'default'). Pode ser partilhada entre resources.

setr mri:color "#00E699"

D

DUI (Direct UI)

Sistema do FiveM para renderizar páginas web como texturas no mundo 3D, usado em waypoints, painéis publicitários e ecrãs dentro do jogo. Ao contrário da NUI, não ocupa o ecrã inteiro.

E

ESX

Framework FiveM clássica, baseada no essentialmode. Rival histórica do QBCore. Hoje é mantida através do fork ESX Legacy. Tem um catálogo enorme de scripts pagos.

F

fxmanifest.lua

Ficheiro de manifesto obrigatório em qualquer resource FiveM. Declara client_scripts, server_scripts, ui_page, files, dependências, versão do Lua e capabilities.

FXServer

Servidor oficial do FiveM. Executa os scripts, gere as ligações dos jogadores e expõe a API que os resources utilizam. Costuma correr integrado no txAdmin.

G

GPL-3.0

Licença open source com copyleft forte, usada pelo Qbox, QBCore, ox_inventory e MRI Qbox. Permite o uso comercial, mas obriga a que os forks distribuídos mantenham o código aberto.

L

LGPL-3.0

Variante mais permissiva da GPL, usada em bibliotecas (ox_lib, @mriqbox/ui-kit). Permite que projetos proprietários utilizem a biblioteca sem passarem eles próprios a ser GPL; só as alterações à biblioteca têm de ser publicadas.

N

NUI (New UI)

Sistema do FiveM para mostrar uma interface web por cima do jogo. Carrega HTML/CSS/JS num iframe CEF. A comunicação Lua ↔ JS faz-se com SendNUIMessage e RegisterNUICallback.

O

ox_lib

Biblioteca oficial da Overextended para FiveM. Disponibiliza menus, notificações, caixas de input, callbacks tipados, sistema de locales e dezenas de utilitários. É a base de qualquer script Qbox moderno.

ox_inventory

Sistema de inventário moderno da Overextended. Substituiu os inventários legacy (qb-inventory, esx_inventory). É o padrão atual nos servidores Qbox/MRI.

oxmysql

Driver MySQL oficial da Overextended para o FXServer. Substituiu o antigo mysql-async. Tem melhor desempenho e queries baseadas em promises.

Q

QBCore

Framework FiveM popular, base do Qbox. Modular, com uma comunidade enorme e o maior catálogo de scripts pagos no Tebex. Tecnicamente menos moderna do que o Qbox.

Qbox

Fork moderno do QBCore mantido pela Overextended. Integração nativa com o ox_lib, threading assíncrono e melhor desempenho. É a base do MRI Qbox.

R

recipe

Ficheiro de receita do txAdmin que define todos os resources, configurações e o esquema da base de dados necessários para pôr um servidor a funcionar automaticamente. A MRI Qbox publica uma recipe oficial.

resource

Unidade de código no FiveM: uma pasta com fxmanifest.lua e scripts Lua/UI. É carregada pelo FXServer com ensure foo no server.cfg.

resmon

Resource Monitor: ferramenta do FiveM dentro do jogo (F8 → resmon) que mostra o consumo de CPU de cada resource. Essencial para depurar problemas de desempenho.

S

scenario (GTA V)

Animação ambiente pré-definida do GTA V (por exemplo, WORLD_HUMAN_SMOKING, WORLD_HUMAN_HANG_OUT_STREET). Usa-se com TaskStartScenarioInPlace para dar vida aos peds.

shadcn/ui

Biblioteca de componentes React para copiar e colar, baseada em Radix + Tailwind. É o padrão visual das NUIs da MRI, através do @mriqbox/ui-kit.

T

Tebex

Marketplace usado pela comunidade FiveM para vender scripts, mapas, veículos e assets. Plataforma de pagamento + licenciamento por chave.

txAdmin

Painel web oficial para gerir servidores FiveM. Normalmente já vem integrado no FXServer. Faz o deploy de recipes, monitoriza o resmon e oferece chat em direto com os jogadores.

V

Vite

Ferramenta de build moderna para aplicações web (HMR rápido, ESBuild). Usada para compilar as NUIs em React dos scripts MRI (mri_Qadmin, mri_Qspawn, etc.).

Falta algum termo?

Sugira-o no Discord oficial: acrescentamos os mais pedidos na próxima atualização.

Sugerir um termo no Discord

Utilizamos cookies para anúncios e métricas. Consulte a política de privacidade.