ARK: Survival

O BrutusForge tem o ARK como jogo principal e suporta as duas versões: ARK: Survival Evolved (ASE) e ARK: Survival Ascended (ASA). Este guia cobre a operação do dia a dia de um servidor ARK gerenciado pelo painel: instalação, plugins, loja in-game, mods da Steam Workshop, RCON, logs e procedimentos de reset.

Versões suportadas

• ARK: Survival Evolved (ASE): versão 1.0 estável, RCON Source nativo (porta padrão 27020).
• ARK: Survival Ascended (ASA): baseado na Unreal Engine 5, RCON Source (porta padrão 27020).

Os recursos do BrutusForge no jogo são entregues por um conjunto de plugins C++ (núcleo + módulos de chat, vínculo de conta, lista de jogadores, recompensas e logs de tribo), pela loja in-game (ArkShop + ArkShopUI) e pelo suporte a mods da Steam Workshop.

Instalação do servidor

A instalação é feita pelo painel admin. Acesse Servidores → Adicionar servidor e siga o wizard até a etapa de instalação, que baixa os binários do jogo via SteamCMD.

App IDs usados pelo SteamCMD:

Instalação dos plugins

Depois que o servidor estiver instalado, instale os plugins do BrutusForge pelo painel: abra o servidor, vá em Plugins e use Instalar plugins. O painel copia o núcleo e os módulos para a pasta correta do ArkApi e gera o config.json de cada plugin.

A localização dos plugins no servidor segue o padrão do ArkApi:

ShooterGame/Binaries/Win64/ArkApi/Plugins/

Cada plugin tem seu config.json. O transporte com a API pode ser por HTTP polling (padrão) ou por WebSocket, ativando a flag useWebSocket. Quando o WebSocket falha de forma persistente, o plugin volta automaticamente para o HTTP polling.

Loja in-game (ArkShop)

A loja in-game roda sobre ArkShop + ArkShopUI. A configuração do ArkShop fica em:

ShooterGame/Binaries/Win64/ArkApi/Plugins/ArkShop/config.json

Edite e gerencie a loja pela seção de configuração do ArkShop no painel admin. Por ali você ajusta itens, preços em pontos e demais opções sem editar o arquivo manualmente no servidor.

Mods da Steam Workshop

Os mods ativos ficam listados no GameUserSettings.ini:

[ServerSettings]
ActiveMods=123456,789012

No painel, use a aba Mods do servidor para buscar e instalar mods da Workshop. A busca usa a integração com a Steam, configurada por uma chave da Steam Web API no nível do cluster.

RCON

O ARK usa RCON Source nativo. Habilite e configure no GameUserSettings.ini:

[ServerSettings]
RCONEnabled=True
RCONPort=27020

A senha do RCON é definida no cadastro do servidor e armazenada de forma criptografada (AES-256-GCM). Os comandos disponíveis para cada jogo são definidos pelo manifesto do jogo, então apenas comandos permitidos podem ser disparados pelo painel e pelo bot.

Logs

• Log do servidor ARK:

ShooterGame/Saved/Logs/ShooterGame.log

• Log do plugin BrutusForge:

ShooterGame/Binaries/Win64/ArkApi/Plugins/BrutusForgeCore/log.txt

Solução de problemas

O plugin não carrega

• Confirme que a versão do ArkApi corresponde à versão do ARK do servidor (ASE ou ASA).
• Verifique se não há conflito de OpenSSL no ambiente do servidor.
• Verifique as permissões de arquivo na pasta de plugins.

RCON recusa a conexão

• Confirme RCONEnabled=True no INI.
• Confirme que a porta 27020 está liberada no firewall.
• Verifique nos logs da API se a senha do RCON está sendo descriptografada corretamente.

Instalação de mod da Workshop falha

• Verifique se a chave da Steam Web API está configurada no cluster.
• Garanta que o processo tenha permissão de escrita na pasta de workshop do SteamCMD, dentro do diretório de instalação do servidor.

Procedimentos de reset

1. Reinício leve do servidor: envie o comando RCON serveradmin shutdown.
2. Backup + reinício: no painel, abra o servidor e use Backup + Reiniciar.
3. Wipe completo: apague a pasta de saves do servidor.

ShooterGame/Saved/SavedArks/