Sobre a Base Five

A Base Five é uma base completa de servidor FiveM construída sobre o framework vRP, distribuída pela loja Five Network. Ela já vem com dezenas de recursos integrados, banco de dados estruturado e interfaces (NUI) modernas em React.

O que vem na base

A base é organizada em pastas bracketadas que o server.cfg carrega em ordem:

Pasta	Conteúdo
`resources/vrp/`	Framework core (carrega primeiro).
`resources/[system]/`	Infraestrutura de terceiros: `oxmysql`, `ox_lib`, `ox_target`, `ox_doorlock`, `pma-voice`, `PolyZone`, `sleepless_interact`, `screenshot-basic`, `sessionmanager`, `freecam`, `loading`, `mugshot` e `sounds`.
`resources/[weapons]/`	Armas e assets streamados: `WEAPON_BRICK`, `WEAPON_KATANA`, `WEAPON_METAS`, `WEAPON_SHOES` e `WEAPON_SKINS`.
`resources/[scripts]/`	Scripts de gameplay (HUD, inventário, MDT, prisão, propriedades, etc.).
`resources/[five]/`	Recursos `five-*` próprios da base (banco, veículos, empregos, criação, etc.).
`[smartphone]/`	`lb-phone` e bibliotecas.

Arquitetura em uma página

Framework

vRP, com comunicação via Proxy (server↔server) e Tunnel (server↔client). Veja Arquitetura do Framework.

Banco de dados

MySQL via oxmysql. A maioria dos recursos cria as próprias tabelas automaticamente no primeiro boot.

Interfaces (NUI)

React + TypeScript + Vite, compiladas para dist/ (ou build/). Veja Compilando as Interfaces.

Build do jogo

Fixado em 3095, com OneSync ligado.

Anatomia de um recurso `five-*`

five-<nome>/
  fxmanifest.lua          -- declara dependências, scripts e ui_page
  config/                 -- configuração em Lua (a parte que você mais edita)
  server-side/            -- lógica de servidor (vRP/oxmysql)
  client-side/            -- lógica de cliente e ponte com a NUI
  web-side/  (ou web/)    -- interface React (opcional)
  stream/                 -- assets streamados (opcional)

Na prática, 90% da customização do dia a dia acontece nos arquivos config/*.lua de cada recurso (preços, localizações, comandos, permissões, cores e webhooks). Cada página da seção Recursos detalha essas opções.

Convenções importantes

Passport e source

Passport é o ID do personagem (usado nas funções vRP.*). source é o ID de rede do jogador.

Cores / tema

Muitos recursos têm um ThemeColor, mas a global Theme.main (em vrp/config/Global.lua) tem prioridade quando definida.

CDN de imagens

Itens e alguns assets usam URLs externas (ItemsURL, AssetsUrl). Você pode apontar para o seu próprio host.

Nomes de pasta bracketados

[five], [scripts] são literais; sempre cite entre aspas em comandos de terminal.

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

O que vem na base

Arquitetura em uma página

Framework

Banco de dados

Interfaces (NUI)

Build do jogo

Anatomia de um recurso `five-*`

Convenções importantes

​O que vem na base

​Arquitetura em uma página

Framework

Banco de dados

Interfaces (NUI)

Build do jogo

​Anatomia de um recurso five-*

​Convenções importantes

O que vem na base

Arquitetura em uma página

Anatomia de um recurso `five-*`

Convenções importantes