Base DRS V1 — ULTRA

Servidor QBCore completo em português: 58 scripts organizados e configurados, SQL com 24 tabelas, mapas, voz e guia passo a passo. Pronto em cerca de 15 minutos.

v1.5.0 QBCore drs_core
Ver na loja

Base de servidor QBCore completa: 58 scripts, mapas, voz, inventário, telemóvel, empregos e assaltos, já organizados, em português e com a base de dados pronta a importar. Traz ficheiros .bat para abrir o servidor e um verificador (drs_core) que diz na consola o que está bem e o que falta.

Na primeira vez, abrir o servidor demora cerca de 15 a 20 minutos.

#Requisitos

SistemaWindows 10/11 (64 bits)
JogoGTA V e FiveM instalados (para entrares no servidor)
Base de dadosMySQL ou MariaDB (a forma mais fácil é o XAMPP)
Conta Cfx.reEm portal.cfx.re, para a chave grátis do servidor
Licença DRSA chave da base, no teu painel em drsfivem.store

Nota

O FXServer (o programa do servidor) não vem no ficheiro: é descarregado do site oficial da Cfx.re pelo 1 - DESCARREGAR FXSERVER.bat.

#Instalação

#1. Descarregar o FXServer

Dá duplo-clique em 1 - DESCARREGAR FXSERVER.bat. Descarrega a versão recomendada do servidor para a pasta artifacts. Repete sempre que quiseres atualizar o FXServer.

#2. Importar a base de dados

  1. Liga o MySQL/MariaDB (no XAMPP: botão Start no MySQL).
  2. Abre o HeidiSQL ou o phpMyAdmin (http://localhost/phpmyadmin).
  3. Importa o ficheiro sql/Base DRS V1 - ULTRA.sql:
    • HeidiSQL: Ficheiro → Executar ficheiro SQL
    • phpMyAdmin: separador Importar → escolher o ficheiro → Executar
  4. Fica criada a base de dados basedrs_v1_ultra com as 24 tabelas.

Se não usares o XAMPP normal (ou se o teu MySQL tiver password), ajusta a ligação no server-data/server.cfg:

server.cfg
set mysql_connection_string "mysql://root@localhost/basedrs_v1_ultra?charset=utf8mb4"
# com password:
set mysql_connection_string "mysql://root:APALAVRAPASSE@localhost/basedrs_v1_ultra?charset=utf8mb4"

#3. Chave do servidor (Cfx.re)

  1. Entra em portal.cfx.re → Servers → Registration Keys.
  2. Cria uma chave (IP: o teu IP público, ou em branco para testes).
  3. Abre server-data/server.cfg com o Bloco de Notas e troca COLOCA_AQUI_A_TUA_CHAVE pela tua chave, entre aspas:
server.cfg
sv_licenseKey "a_tua_chave"

#4. Licença DRS

A base só arranca com a tua chave DRS.

  1. No site, entra no teu painel → As Minhas Licenças. A licença da base mostra a chave (DRS-XXXX-XXXX-XXXX-XXXX).
  2. Cola a chave no ficheiro server-data/resources/[drs]/drs_core/license.key e guarda.

Na mesma página vês os servidores que estão a usar a chave. Se mudares de PC ou de alojamento, liberta o servidor antigo e a chave passa a funcionar no novo.

Atenção

A chave é tua: não a partilhes. Cada chave funciona num número limitado de servidores.

#5. Abrir o servidor

Com txAdmin (recomendado: painel web, reinícios automáticos, logs e bans):

  1. Dá duplo-clique em 2 - ABRIR TXADMIN.bat.
  2. Abre-se o browser em http://localhost:40120. Entra com a tua conta Cfx.re e cria a password do painel.
  3. Escolhe Existing Server Data e cola o caminho da pasta server-data (aparece escrito na janela preta).
  4. Escolhe o server.cfg dessa pasta e carrega em Save & Start.

Sem txAdmin (só a consola): dá duplo-clique em 3 - INICIAR SEM TXADMIN.bat. Para desligar, escreve quit na janela.

#6. Entrar no servidor

Abre o FiveM, carrega em F8 e escreve:

txt
connect localhost

#7. Dar-te admin

  1. Com o servidor ligado e tu dentro, escreve status na consola do servidor. Aparece a tua linha com os identificadores (license:… e fivem:…).
  2. No fim do server.cfg, tira o # da linha abaixo e põe o teu identificador:
server.cfg
add_principal identifier.fivem:1234567 qbcore.god
  1. Reinicia o servidor. Passas a ter todos os comandos de staff (/admin, /car, /tp, /revive…).

#Confirmar que está tudo bem

Uns segundos depois de o servidor arrancar, o drs_core mostra na consola o resumo da base: versão, scripts a correr, base de dados e jogadores. Se alguma coisa estiver mal (base de dados, SQL por importar, licença, scripts que não arrancaram…), aparece logo por baixo com a explicação de como resolver.

Comando (consola do servidor, sem /)O que faz
drsinfoMostra o resumo outra vez
drscheckVolta a verificar a base e diz o que falta e como resolver
drsscriptsLista todos os scripts da base e se estão a correr

#Jogar com amigos

Abre a porta 30120 (TCP e UDP) no router para o IP do teu PC e permite o FXServer na firewall do Windows. Os amigos ligam-se com:

txt
connect O_TEU_IP_PUBLICO:30120

#Personalizar

  • Nome, descrição, número de jogadores e logótipo: server-data/server.cfg e myLogo.png (96×96).
  • Língua: setr qb_locale "pt" (todos os scripts em português; "en" para inglês).
  • Interações com o olho: setr UseTarget true.
  • Empregos, gangs, itens e veículos: server-data/resources/[drs]/drs-core/shared/.
  • Cada script tem o seu config.lua.

#Teclas

TeclaAção
F1Menu radial
TabInventário
MTelemóvel
Alt (manter)Olho de interação · falar no rádio
LTrancar/destrancar o veículo
GLigar/desligar o motor
BCinto de segurança · apontar
YCruise control
XMãos no ar
CtrlAgachar
IMenu do HUD
HomeLista de jogadores
Z / 1–5Ver e usar os espaços rápidos

As teclas mudam-se no jogo em Definições → Teclas → FiveM.

#Comandos principais

A base tem cerca de 200 comandos de jogo. A lista completa, script a script, está no ficheiro COMANDOS.txt.

ComandoO que faz
/adminMenu de administração (staff)
/car <modelo> · /dvCriar ou apagar um veículo (staff)
/tp <id> · /tpmTeleporte para um jogador ou para o marcador (staff)
/revive <id> · /aheal <id>Reanimar ou curar (staff)
/setjob <id> <emprego> <cargo>Definir o emprego (staff)
/givemoney <id> cash <valor>Dar dinheiro em mão (ou bank para o banco) (staff)
/giveitem <id> <item> <quantidade>Dar um item (staff)
/noclipLigar/desligar o noclip (staff)
/weather <clima> · /time <h> <m>Mudar o clima ou a hora (staff)
/report <mensagem>Enviar um relatório à staff
/job · /gang · /idVer o teu emprego, a tua gang ou o teu ID

#O que vem na base

PastaConteúdo
[drs]Os scripts da base: núcleo, inventário, telemóvel, banco, polícia, INEM, mecânicos, empregos (autocarro, lixo, táxi, reboques, camionista, vinha…), assaltos (bancos, joalharia, lojas, casas, carrinhas), casas e apartamentos, stand, garagens, combustível, HUD, menu radial, roupa, multicharacter, prisão e mais, e o drs_core
[standalone]oxmysql, PolyZone, chat, bob74_ipl, fila de entrada, barra de progresso, sons, menus e capturas de ecrã
[voice]pma-voice e rádio
[compat]3 pontes (qb-core, qb-inventory, qb-target)
[defaultmaps]Mapas da prisão, do stand e do hospital Pillbox
[cfx-default]Recursos base da Cfx.re

A lista completa, com o que faz cada script, está no ficheiro CONTEÚDO.txt.

#Scripts QBCore do mercado

A base é compatível com os nomes QBCore standard (exports['qb-core'], qb-menu, dependências como qb-phone…), e a pasta [compat] faz a ponte para qb-core, qb-inventory e qb-target. Por isso podes instalar qualquer script QBCore do mercado sem mexer em nada.

Dica

Imagens de itens novos: põe-nas em [drs]/drs-inventory/html/images e em [compat]/qb-inventory/html/images.

Atenção

Não apagues a pasta [compat]: os scripts do mercado deixam de encontrar o qb-core, o inventário e o olho.

#Resolução de problemas

ProblemaSolução
Server license key authentication failedA chave da Cfx.re está errada ou o IP não corresponde. Cria outra em portal.cfx.re (passo 3).
O drs_core diz que a licença não é válidaConfirma que colaste a chave DRS certa em drs_core/license.key (passo 4). Se mudaste de servidor, liberta o antigo no painel.
oxmysql: … ECONNREFUSED ou Access deniedO MySQL não está ligado ou a ligação no server.cfg está errada (passo 2).
Unknown table ou … doesn't existO SQL não foi importado (passo 2).
Fico preso no ecrã de carregamentoVê a consola do servidor: o primeiro erro a vermelho diz qual é o script.
Não sei o que está malEscreve drscheck na consola do servidor: diz o que falta e como resolver.
Não vejo o servidor na listaUsa connect localhost no F8, ou confirma a porta 30120 (jogar com amigos).

Se nada disto resolver, abre um ticket no painel com o resultado do drscheck.

#Licenças e créditos

A Base DRS V1 — ULTRA junta, organiza, configura e traduz para português scripts de código aberto; os direitos de cada script são dos seus autores e cada pasta mantém o seu LICENSE original.

  • QBCore Framework (github.com/qbcore-fivem): base dos scripts das pastas [drs] e [compat], dos mapas e de vários recursos, na maioria em GPL-3.0.
  • oxmysql (Overextended, LGPL-3.0), pma-voice (AvarianKnight, GPL-3.0), menuv (ThymonA, GPL-3.0), PolyZone (mkafrin, MIT), bob74_ipl (Bob74, MIT), screencapture (itschip) e os recursos cfx-default (Cfx.re).
  • O drs_core é código próprio da DRS (não é GPL): não pode ser alterado, copiado nem distribuído fora da base comprada.

O trabalho da DRS na base: organização, configuração do servidor, traduções para português, SQL unificado, ficheiros de arranque, verificador e documentação. Os detalhes estão no ficheiro LICENÇAS.txt.