Este guia mostra como instalar, configurar e operar um servidor de Palworld no BrutusForge: instalação pelo assistente, ativação da API REST para RCON, comandos do bot do Discord e entrega da loja. O foco é o fluxo prático do administrador, do primeiro boot ao monitoramento contínuo.
Instalação do servidor
A instalação é feita pelo assistente do painel administrativo:
- Acesse a tela de criação de servidores e selecione Palworld.
- Configure as portas:
- Jogo:
8211 - Query:
27015 - API REST:
8212
- Jogo:
- O download via SteamCMD é executado automaticamente (appId
2394010— PalServer). - Confirme a instalação verificando se o executável existe:
- Linux:
PalServer.sh - Windows:
PalServer.exe
- Linux:
API REST e RCON
O Palworld expõe uma API REST que o BrutusForge usa como canal de RCON. Ela roda na porta 8212 e autentica via HTTP Basic, usando a senha de administrador do servidor.
Edite o arquivo PalWorldSettings.ini (em Pal/Saved/Config/, dentro da pasta da plataforma) e ajuste:
RESTAPIEnabled=true
RESTAPIPort=8212
AdminPassword="SUA_SENHA_SECRETA"A AdminPassword é usada como senha do HTTP Basic da API REST. Defina-a também nas configurações do servidor no painel, para que o RCON consiga autenticar.
Depois de salvar, reinicie o servidor. Para validar, use o painel de RCON e envie o comando info — ele retorna um JSON com as informações do servidor.
A senha de administrador definida no PalWorldSettings.ini precisa ser idêntica à cadastrada no painel. Se elas divergirem, o RCON retorna HTTP 401.
Comandos suportados
O canal RCON roteia apenas uma lista controlada de comandos. Os verbos disponíveis são:
info— informações do servidorplayers— jogadores onlineannounce/broadcast— mensagem para o servidorsave— salvar o mundoshutdown/stop— desligar o servidorkick— remover um jogador
Comandos do bot do Discord
Ao implantar o bot, dois comandos de Palworld são registrados automaticamente, sem configuração extra:
| Comando | Função |
|---|---|
/palworld-status | lista os jogadores online |
/palworld-broadcast MENSAGEM | envia uma mensagem para o servidor |
Entrega da loja
A API REST do Palworld ainda não oferece um endpoint estável de entrega de itens (give-item). Por isso a entrega automática da loja é limitada.
Enquanto não houver um endpoint estável de entrega:
- A loja usa um modo de aviso: ao concluir uma compra, o servidor anuncia a entrega via
announce. - O administrador entrega o item manualmente pelo console in-game.
Quando o Palworld disponibilizar a entrega direta de itens via API REST, a entrega passará a ocorrer de forma totalmente automática.
Resolução de problemas
API REST recusando conexão (HTTP 401 ou recusada)
- Confirme
RESTAPIEnabled=truenoPalWorldSettings.ini. - Verifique se a porta
8212está aberta no firewall. - Teste a conexão direta:
curl -u admin:SUA_SENHA http://SEU_HOST:8212/v1/api/info- Se retornar 401, a senha de administrador está divergente — alinhe a senha do painel com a do
PalWorldSettings.ini.
Timeout de conexão
A API REST do Palworld pode demorar a responder logo após o boot (cold start). O canal RCON tem um tempo limite de 10 segundos. Se houver timeout recorrente, verifique o log do servidor (pal-server.log) para confirmar que a inicialização concluiu.
Comando desconhecido
Apenas os verbos da lista controlada são aceitos (info, players, announce, broadcast, save, shutdown, stop, kick). Comandos fora dessa lista são rejeitados.
Verificações de saúde
| Verificação | Como validar |
|---|---|
| Servidor no ar | curl -u admin:SENHA http://SEU_HOST:8212/v1/api/info retorna JSON |
| Jogadores online | /v1/api/players retorna um array |
| Bot funcionando | /palworld-status no Discord retorna um embed |
Referência de configuração
O PalWorldSettings.ini expõe cerca de 50 campos. Os principais grupos:
- Servidor:
ServerName,AdminPassword(autenticação REST),ServerPlayerMaxNum,ServerPort,RCONPort,RESTAPIPort - Jogabilidade:
Difficulty,ExpRate,PalCaptureRate,PalSpawnNumRate,PalDamageRateAttack - PvP:
bEnablePlayerToPlayerDamage,bEnableFriendlyFire,DeathPenalty - Pals:
PalEggDefaultHatchingTime,PalAutoHPRegeneRate,PalStaminaDecreaceRate - Construção:
BuildObjectDamageRate,CollectionDropRate,EnemyDropItemRate - Guilda:
GuildPlayerMaxNum,BaseCampMaxNum,AutoSaveSpan,bIsPvP