Guia completo para configurar o seu servidor RedM na Legion Hosting. O RedM é um framework de modificação multijogador para Red Dead Redemption 2, criado pela Cfx.re (a mesma equipa por trás do FiveM). Este guia aborda o registo da chave de licença, configuração do servidor, gestão de recursos e ligação de jogadores. Se encontrar problemas, consulte o nosso guia de Resolução de Problemas do RedM.
O que é o RedM?
O RedM é um framework multijogador orientado pela comunidade para Red Dead Redemption 2, desenvolvido e mantido pelo Cfx.re Collective — a mesma organização por trás do FiveM (o framework multijogador para GTA V). O RedM oferece:
- Uma plataforma de servidor dedicado para alojar experiências multijogador personalizadas de RDR2
- Um sistema de recursos/scripts utilizando Lua, C# e JavaScript
- Suporte para modos de jogo personalizados, frameworks de roleplay e mods da comunidade
- Um launcher cliente que liga os jogadores a servidores personalizados
- Acesso a funções nativas para modificação extensiva do jogo
Obter uma Chave de Licença Cfx.re
Cada servidor RedM requer uma chave de licença Cfx.re válida. Esta chave é gratuita e está associada à sua conta Cfx.re.
- Aceda ao Cfx.re Keymaster em
https://keymaster.fivem.net/. - Inicie sessão com a sua conta Cfx.re (ou crie uma se ainda não tiver).
- Clique em Register a new server (ou "New Server" dependendo da interface atual).
- Preencha o formulário:
- Label: Um nome para o seu servidor (apenas para sua referência).
- Server IP: Introduza o endereço IP do seu servidor a partir do GPanel. Pode encontrá-lo na página de resumo do seu servidor.
- Server Type: Selecione o tipo apropriado (normalmente "Other/VPS" para servidores alojados).
- Clique em Generate. A sua chave de licença será apresentada. Copie-a e guarde-a em segurança.
Primeiro Arranque e Variáveis de Arranque do GPanel
Após adquirir o seu servidor RedM na Legion Hosting, inicie sessão no GPanel e navegue até ao seu servidor.
Definir Variáveis de Arranque
Aceda ao separador Startup no GPanel. Verá várias variáveis configuráveis:
| Variável | Descrição | Exemplo |
|---|---|---|
CFX_LICENSE |
A sua chave de licença Cfx.re do Keymaster. Obrigatório. | cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx |
SERVER_HOSTNAME |
Nome de apresentação do seu servidor na lista de servidores. | My new FXServer! |
MAX_PLAYERS |
Número máximo de jogadores conectados (1–32). | 32 |
CFX_VERSION |
A versão de build do servidor CFX a instalar. Utilize latest, recommended ou um número de build específico. |
latest |
STEAM_WEBAPIKEY |
Chave Steam Web API para identidade Steam. Obtenha uma em steamcommunity.com/dev/apikey. Defina como none para desativar. |
none |
Primeiro Arranque
- Introduza a sua chave de licença Cfx.re no campo
CFX_LICENSE. - Defina o nome do servidor e o número máximo de jogadores desejados.
- Aceda ao separador Console e clique em Start.
- O servidor irá descarregar os artefactos do servidor RedM no primeiro arranque. Isto pode demorar alguns minutos.
- Assim que vir mensagens a indicar que o servidor está a escutar (ex.:
Started resource manager), o seu servidor está online.
Configuração do server.cfg
O ficheiro server.cfg é o ficheiro de configuração principal do seu servidor RedM. Aceda-o através do File Manager do GPanel ou via SFTP. Abaixo está um exemplo de configuração abrangente:
# ========================================
# RedM Server Configuration
# ========================================
# Network Endpoints
# These define what IP and port the server listens on.
# 0.0.0.0 means listen on all available interfaces.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
# Server Identity
sv_hostname "My RedM Roleplay Server"
sv_maxclients 32
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
# Server Password (leave empty for no password)
# sv_password "MyServerPassword"
# Server Description and Tags (shown in server browser)
sets sv_projectName "My RedM RP"
sets sv_projectDesc "A Wild West roleplay experience"
sets tags "roleplay, rp, economy, custom"
# Locale
sets locale "en-US"
# Steam Web API Key (optional, for Steam identity)
# Get one from https://steamcommunity.com/dev/apikey
# set steam_webApiKey "YOUR_STEAM_API_KEY"
# OneSync (networked entity sync)
# "on" = standard OneSync, "legacy" = legacy mode
set onesync on
# RCON Password (for remote console access)
rcon_password "YourRconPassword123"
# Resource Directories
# Ensure resources are loaded from these directories
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog
# ========================================
# Add your custom resources below
# ========================================
# ensure my_custom_resource
# ensure vorp_core
# ensure oxmysql
Opções de Configuração Principais Explicadas
| Diretiva | Descrição |
|---|---|
endpoint_add_tcp |
Endpoint TCP para ligações de clientes. Deve corresponder à porta atribuída pelo GPanel. |
endpoint_add_udp |
Endpoint UDP para dados do jogo. Deve ser a mesma porta que o TCP. |
sv_hostname |
O nome do servidor apresentado no navegador de servidores RedM e na ligação direta do cliente. |
sv_maxclients |
Número máximo de slots de jogadores. Não deve exceder o que o seu plano de alojamento suporta. |
sv_licenseKey |
A sua chave de licença Cfx.re. Também pode ser definida através da variável de arranque do GPanel. |
sets |
Define uma convar do servidor que é visível no navegador de servidores (replicada para os clientes). |
set |
Define uma convar do servidor que é visível apenas do lado do servidor. |
set onesync |
Ativa o OneSync para melhor sincronização de entidades. Recomendado manter em on. |
ensure |
Carrega e inicia um recurso. O recurso deve existir num subdiretório resources/. |
endpoint_add_tcp e endpoint_add_udp devem corresponder à porta atribuída ao seu servidor no GPanel. O seu servidor terá uma porta aleatória atribuída, a menos que tenha um IP privado. Se o GPanel mostrar o seu servidor na porta 30120, os seus endpoints devem ser "0.0.0.0:30120". Utilizar uma porta diferente impedirá o servidor de iniciar corretamente.
Gestão de Recursos
Os recursos são os blocos de construção de um servidor RedM. Contêm scripts, assets e configurações que adicionam funcionalidade ao seu servidor.
Estrutura de Recursos
Cada recurso é uma pasta dentro do diretório resources/ contendo, no mínimo, um ficheiro fxmanifest.lua (ou o legado __resource.lua):
resources/
[system]/
chat/
fxmanifest.lua
cl_chat.lua
sv_chat.lua
spawnmanager/
fxmanifest.lua
...
[custom]/
my_resource/
fxmanifest.lua
client.lua
server.lua
config.lua
Carregar Recursos
Os recursos são carregados utilizando o comando ensure no server.cfg:
# Load a specific resource
ensure my_resource
# You can also use 'start' (functionally equivalent to ensure)
start another_resource
A diferença entre ensure e start: ensure irá iniciar o recurso se estiver parado, ou reiniciá-lo se já estiver em execução. start apenas o iniciará se ainda não estiver em execução.
Instalar Novos Recursos
- Descarregue o recurso a partir da sua fonte (GitHub, fóruns da comunidade, etc.).
- Envie a pasta do recurso para o diretório
resources/do seu servidor via SFTP (consulte o Guia de Envio SFTP) ou pelo gestor de ficheiros do GPanel. - Adicione uma linha
ensure resource_nameao seuserver.cfg. - Reinicie o servidor para que o recurso seja carregado.
Frameworks e Recursos Populares para RedM
| Framework/Recurso | Descrição |
|---|---|
| VORP Core | Framework de roleplay popular para RedM. Fornece criação de personagens, inventário, economia e muito mais. O equivalente RedM do ESX/QBCore no FiveM. |
| RSG Core (RedEM:RP) | Outro framework completo de RP com gestão de personagens, empregos e sistemas de economia. |
| oxmysql | Biblioteca MySQL para servidores Cfx.re. Necessária pela maioria dos frameworks para operações de base de dados. |
| ox_lib | Biblioteca de utilitários que fornece funções partilhadas, componentes de UI e módulos auxiliares. |
| vorp_inventory | Sistema de inventário para servidores baseados em VORP. |
Como Conectar
Os jogadores precisam do cliente RedM para se conectarem ao seu servidor. Eis como começar:
Instalar o RedM
- Os jogadores devem possuir uma cópia legítima de Red Dead Redemption 2 no Steam, Epic Games Store ou Rockstar Games Launcher.
- Descarregue o cliente RedM em redm.net.
- Instale o RedM. Ele irá detetar automaticamente a instalação do RDR2.
- Inicie o RedM. No primeiro arranque, irá atualizar e colocar em cache os ficheiros do jogo.
Conectar pelo Navegador de Servidores
- Inicie o RedM.
- Clique em Play no menu principal para abrir o navegador de servidores.
- Procure o seu servidor pelo nome (o valor de
sv_hostnameda sua configuração). - Selecione o seu servidor e clique em Connect. Introduza a palavra-passe se estiver definida.
Ligação Direta
- Inicie o RedM.
- Prima F8 para abrir a consola do cliente.
- Escreva o seguinte comando com o IP e a porta do seu servidor:
connect YOUR_SERVER_IP:PORT
Por exemplo:
connect 192.168.1.100:30120
Encontre o IP e a porta do seu servidor no GPanel na página de resumo do seu servidor, ou consulte Como Encontrar o IP e a Porta do Seu Servidor.
Conceitos Partilhados com o FiveM
Uma vez que o RedM e o FiveM são ambos construídos na plataforma Cfx.re, muitos conceitos são diretamente transferíveis:
- A sintaxe do server.cfg é idêntica entre o FiveM e o RedM.
- Os manifestos de recursos (
fxmanifest.lua) utilizam o mesmo formato e campos. - Os scripts do lado do servidor (Lua, C#, JavaScript) funcionam da mesma forma.
- O oxmysql e outras bibliotecas partilhadas funcionam em ambas as plataformas.
- O painel de gestão txAdmin funciona com servidores FiveM e RedM.
- A sincronização de entidades OneSync está disponível em ambas as plataformas.
As principais diferenças são as funções nativas do lado do cliente (funções específicas do jogo), a compatibilidade de recursos (os recursos FiveM precisam de ser portados para RDR2) e o mundo/entidades disponíveis no jogo.
Artigos Relacionados
- Resolução de Problemas do RedM — Soluções para problemas comuns de chave de licença, ligação, recursos e desempenho.
- Como Encontrar o IP e a Porta do Seu Servidor
- Como Enviar Ficheiros via SFTP
- Primeiros Passos com o Seu Novo Servidor
Precisa de Ajuda?
Se precisar de assistência para configurar o seu servidor RedM, obter uma chave de licença ou configurar recursos, abra um ticket de suporte e a nossa equipa irá ajudá-lo a começar.