Voltar
Runbooks por jogo

Palworld

Atualizado em 2026-06-29

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:

  1. Acesse a tela de criação de servidores e selecione Palworld.
  2. Configure as portas:
    • Jogo: 8211
    • Query: 27015
    • API REST: 8212
  3. O download via SteamCMD é executado automaticamente (appId 2394010 — PalServer).
  4. Confirme a instalação verificando se o executável existe:
    • Linux: PalServer.sh
    • Windows: PalServer.exe

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:

PalWorldSettings.ini
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 servidor
  • players — jogadores online
  • announce / broadcast — mensagem para o servidor
  • save — salvar o mundo
  • shutdown / stop — desligar o servidor
  • kick — remover um jogador

Comandos do bot do Discord

Ao implantar o bot, dois comandos de Palworld são registrados automaticamente, sem configuração extra:

ComandoFunção
/palworld-statuslista os jogadores online
/palworld-broadcast MENSAGEMenvia 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=true no PalWorldSettings.ini.
  • Verifique se a porta 8212 está 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çãoComo validar
Servidor no arcurl -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