Como criar um servidor Tibia OTServ no Windows com TFS: guia técnico

Rodar um OTServ próprio é um dos exercícios mais educativos para quem quer entender game servers — você lida com banco de dados, sockets TCP, scripting Lua e administração de sistema operacional ao mesmo tempo. The Forgotten Server (TFS) é o engine mais usado da cena de Open Tibia desde meados dos anos 2010, e a versão 1.x trouxe uma base de código C++ moderna que facilita muito a manutenção.

Este guia mostra o caminho completo para colocar um TFS 1.5 rodando no Windows Server 2022, com MySQL configurado, portas liberadas no firewall e o cliente conectando ao servidor. A persona aqui é o owner de OTServ iniciante ou intermediário que prefere ambiente Windows pela curva de aprendizado menor — mesmo que Linux ofereça vantagens de performance no longo prazo.

Tempo estimado de execução: 45 a 60 minutos, considerando download dos binários e download do mapa. A configuração reaproveita as builds pré-compiladas distribuídas pela comunidade, sem necessidade de compilar o TFS do zero.

Pré-requisitos

Antes de começar, confirme que você tem acesso administrativo a uma VPS Windows com IP público dedicado. OTServ não funciona em ambientes com CGNAT ou IP compartilhado porque precisa abrir portas de entrada para o cliente Tibia se conectar.

Preparando o ambiente Windows

Antes de baixar o TFS, instale as dependências de runtime que os binários pré-compilados esperam encontrar no sistema. Sem isso, o tfs.exe falha ao iniciar com mensagens crípticas sobre DLLs faltando.

Invoke-WebRequest -Uri "https://aka.ms/vs/17/release/vc_redist.x64.exe" -OutFile "$env:TEMP\vc_redist.x64.exe"
Start-Process -FilePath "$env:TEMP\vc_redist.x64.exe" -ArgumentList "/install","/quiet","/norestart" -Wait

New-Item -ItemType Directory -Path "C:\otserv" -Force
New-Item -ItemType Directory -Path "C:\otserv\backup" -Force

Instalando MySQL para o banco de dados

O TFS usa MySQL (ou MariaDB) para armazenar contas, personagens, casas e estado persistente do mundo. Sem o banco rodando, o servidor não inicia.

CREATE DATABASE forgottenserver CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'otserv'@'localhost' IDENTIFIED BY 'TROQUE_ESSA_SENHA_FORTE';
GRANT ALL PRIVILEGES ON forgottenserver.* TO 'otserv'@'localhost';
FLUSH PRIVILEGES;

Baixando e configurando o TFS

Com runtime e banco prontos, baixe a build do TFS e importe o schema inicial.

C:\otserv\
  tfs.exe
  config.lua.dist
  schema.sql
  data\
  notes\

cd C:\otserv
mysql -u otserv -p forgottenserver < schema.sql

ip = "SEU_IP_PUBLICO_AQUI"
loginProtocolPort = 7171
gameProtocolPort = 7172
statusProtocolPort = 7171

mysqlHost = "127.0.0.1"
mysqlUser = "otserv"
mysqlPass = "TROQUE_ESSA_SENHA_FORTE"
mysqlDatabase = "forgottenserver"
mysqlPort = 3306

serverName = "Meu OTServ"
ownerName = "Seu Nome"
worldType = "pvp"

Liberando portas no firewall

O Windows Firewall bloqueia conexões de entrada por padrão. Você precisa criar regras explícitas para as portas do TFS.

New-NetFirewallRule -DisplayName "OTServ Login" -Direction Inbound -Protocol TCP -LocalPort 7171 -Action Allow
New-NetFirewallRule -DisplayName "OTServ Game" -Direction Inbound -Protocol TCP -LocalPort 7172 -Action Allow

Get-NetFirewallRule -DisplayName "OTServ*" | Select-Object DisplayName, Enabled, Direction

Iniciando o servidor e verificando

Com tudo configurado, é hora de subir o TFS e validar que tudo funciona.

cd C:\otserv
.\tfs.exe

The Forgotten Server - Version 1.5
Loaded config.lua
Loaded items, monsters, NPCs, spells
Connected to MySQL
Loaded map
[OK] Server Online! - 127.0.0.1:7171

Verificação

Confirme que o servidor está aceitando conexões externas executando do seu computador local (não da VPS):

telnet SEU_IP_PUBLICO 7171

Se a tela ficar preta sem mensagem de erro, a porta está aberta e o TFS está respondendo. Pressione Ctrl+] e digite quit para sair.

Para testar com o cliente Tibia real, abra o OTClient ou cliente Tibia adaptado, vá em “Server” e configure: IP = seu IP público da VPS, porta = 7171. Crie uma conta via comando in-game ou direto via SQL e tente logar.

Resolução de problemas

”Cannot connect to login server” do lado do cliente

Causa mais comum: ip em config.lua está como 127.0.0.1 ou IP errado. Confirme com ipconfig o IP da interface de rede e ajuste. Em seguida verifique se a porta 7171 está realmente aberta usando um scanner externo como nmap a partir de outra máquina.

TFS fecha sozinho ao iniciar

Geralmente é Visual C++ Redistributable faltando ou versão errada. Confirme que instalou o pacote x64 2015-2022, não o x86. Outra causa comum: data/items/items.otb corrompido ou de versão diferente do protocolo configurado.

Lag/spike de latência com poucos jogadores

Quase sempre é script Lua mal otimizado. Use debug mode no config.lua (logFile = "logs/server.log") e revise scripts globais ou de eventos disparando queries SQL em loops. Em hardware adequado, TFS 1.5 sustenta tranquilamente algumas centenas de jogadores antes de saturar CPU.

Próximos passos

Com o OTServ rodando, considere os próximos pontos para evoluir o projeto:

• Configure backup automático do MySQL via Task Scheduler do Windows (export diário do dump SQL)
• Suba um site PHP com login.php para os clientes Tibia modernos buscarem informações do servidor (charlist API)
• Adicione monitoramento de uptime externo para receber notificação se o tfs.exe cair
• Customize o mapa com Remere’s Map Editor ou crie quests Lua próprias
• Migre para protocolo moderno (12.x) se quiser features atuais do Tibia oficial

Se você está colocando o servidor em produção com base de jogadores real, uma VPS Hostini para jogos já vem com IPv4 dedicado, proteção DDoS especializada em portas de game (7171/7172) e baixa latência para o Brasil — o que importa muito quando seus jogadores são daqui.