Configurações

As configurações do Five Network estão distribuídas entre o server.cfg e os arquivos de config de cada recurso.

server.cfg

O arquivo principal de configuração do servidor. Localizado na raiz do projeto.

Configurações Essenciais

# Identidade do servidor
sv_hostname "Five Network | Roleplay BR"
sv_projectName "CoreNetwork"
sv_projectDesc "Servidor de Roleplay Brasileiro"

# Licença (obrigatório)
sv_licenseKey "cfxk_xxxxxxxxxxxx"

# Banco de dados
set mysql_connection_string "mysql://user:pass@localhost/fivenetwork"

# Slots
sv_maxclients 128

# Build do jogo (não altere)
sv_enforceGameBuild 3095

# OneSync (obrigatório para bases grandes)
onesync on

Variáveis usadas pelos recursos

Estas são as set/setr que a base realmente lê em tempo de execução:

# Chave da Steam Web API (usada na identificação dos jogadores)
set steam_webApiKey "sua_chave_aqui"

# Aviso no console para queries lentas (ms)
set mysql_slow_query_warning 150

# Token de autenticação dos recursos protegidos
set core_auth ""

# Perfil de efeitos visuais do client
setr profile_skfx 0

# Webhooks lidos por recursos específicos
setr Discord_MDT ""
setr Discord_EMS ""
setr Discord_FREECAM ""

Os demais webhooks não ficam no server.cfg: cada recurso tem o seu config/webhooks.lua.

Permissões de console (ACE)

O bloco de ACE define quem pode rodar comandos pelo painel/console. Troque o identificador pelo seu:

add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:SEU_IDENTIFICADOR group.admin

O server.cfg que acompanha a base vem com sv_maxClients 5 e a string de conexão apontando para o banco corenetwork. Ajuste os dois antes de abrir o servidor ao público.

Configurações por Recurso

Cada recurso possui uma pasta config/ com arquivos Lua de configuração.

vRP Framework — resources/vrp/config/

Arquivo	O que configura
`Global.lua`	Moeda, `SalaryCooldown`, tabela `Groups`, `Theme`, slots de inventário e CDN de itens
`Item.lua`	Definição de todos os itens do servidor
`Vehicle.lua`	Lista de veículos e suas propriedades
`Drops.lua`	Configuração de drops no chão
`Native.lua`	Ajustes de natives aplicados pelo framework
`inventory/` e `textures/`	Assets auxiliares do inventário

Five Vehicles — resources/[five]/five-vehicles/config/

Arquivo	O que configura
`general.lua`	`ThemeColor`, menu de veículos (`vehMenu`), placas fixas de aluguel, bloqueio de veículos de NPC e hooks de API
`garages.lua`	Todas as garagens do mapa
`dealership.lua`	Concessionárias e test drive
`mechanics.lua`	Oficinas e serviços mecânicos
`commands.lua`	Comandos registrados pelo recurso
`vehicles.lua`	Catálogo de veículos do recurso
`framework.lua`	Ponte com o vRP
`notify.lua`	Textos e estilos das notificações

Five Bank — resources/[five]/five-bank/config/

Arquivo	O que configura
`config.lua`	Pontos de atendimento, tipos de conta conjunta e limites
`functions.lua`	Ponte com o vRP e o oxmysql

Five Jobs — resources/[five]/five-jobs/config/

Arquivo	O que configura
`config.lua`	Regras gerais dos empregos
`professions.lua`	Profissões disponíveis
`routes.lua`	Rotas e entregas
`functions.lua`	Ponte com o framework
`webhooks.lua`	Webhooks de log do recurso

Quase todo recurso da pasta [five] segue o mesmo padrão: config/config.lua para as regras, config/functions.lua como ponte com o framework e config/webhooks.lua para os logs.

Adicionando Novos Recursos

Para adicionar um novo recurso:

Posicione a pasta do recurso

Coloque a pasta do recurso em resources/[pasta-adequada]/.

Adicione ao server.cfg

# Para iniciar um recurso individual:
start nome_do_recurso

# Para iniciar todos em uma pasta:
start [nome-da-pasta]

Execute o SQL, se houver

Se o recurso tem tabelas no banco, execute o SQL de criação.

Reinicie o servidor

Reinicie o servidor para carregar o novo recurso.

Configuração de Voz (pma-voice)

# Configurações no server.cfg
setr voice_maxRange 30.0            # Alcance máximo da voz
setr voice_enableProximity true     # Voz por proximidade
setr voice_defaultCycle "PROXIMITY" # Modo padrão

OneSync

# Habilita OneSync (necessário para > 32 jogadores e recursos avançados)
onesync on

# Modo infinity para servidores grandes
# onesync_enableInfinity true

Configuração de Webhooks Discord

Vários recursos suportam webhooks para logs no Discord. Configure nos arquivos de configuração de cada recurso:

Config.Webhook = "https://discord.com/api/webhooks/xxx/yyy"
Config.WebhookName = "Five Network Logs"

Use um webhook por canal/área (compras, banimentos, transações) para manter os logs organizados no seu Discord.

Arquivos de Configuração UI (NUI)

Alguns recursos possuem um config.ui.js na pasta config/ para configurar aspectos visuais das interfaces React:

// Exemplo de config.ui.js
export default {
  primaryColor: "#0143BB",
  serverName: "Five Network",
  logo: "https://exemplo.com/logo.png"
}

Começando

Configuração da Base

Referência Rápida

Recursos

Scripts

Framework vRP

server.cfg

Configurações por Recurso

Adicionando Novos Recursos

Configuração de Voz (pma-voice)

OneSync

Configuração de Webhooks Discord

Arquivos de Configuração UI (NUI)

​server.cfg

​Configurações por Recurso

​Adicionando Novos Recursos

​Configuração de Voz (pma-voice)

​OneSync

​Configuração de Webhooks Discord

​Arquivos de Configuração UI (NUI)

server.cfg

Configurações por Recurso

Adicionando Novos Recursos

Configuração de Voz (pma-voice)

OneSync

Configuração de Webhooks Discord

Arquivos de Configuração UI (NUI)