Como criar um servidor de Tibia (OTServ) no Linux com TFS

Subir um servidor próprio de Tibia (OTServ) é um projeto que mistura compilação de C++, configuração de banco MySQL, scripting Lua e gestão de rede em Linux. Este guia foca em colocar um servidor baseado no The Forgotten Server (TFS) 1.5 rodando do zero em uma VPS Ubuntu 24.04 LTS, do clone do repositório até o cliente conectando.

A persona deste tutorial é o owner novo de OTServ que tem familiaridade básica com linha de comando Linux e quer um servidor de testes funcional antes de customizar mapas, sprites e scripts. O caminho é: instalar dependências, compilar o TFS, configurar o MySQL, ajustar config.lua e abrir as portas no firewall. Em hardware razoável, o procedimento inteiro leva entre 30 e 45 minutos.

Não vamos cobrir customização de mapa (RME), criação de scripts Lua ou setup de login server compartilhado pra OT-list — esses são tópicos pra tutoriais dedicados. O foco aqui é o caminho mínimo viável pra ter um servidor que aceita conexões reais.

Pré-requisitos

Confirme que está logado como usuário com sudo e atualize o índice de pacotes antes de começar:

sudo apt update && sudo apt upgrade -y

Instalação das dependências de compilação

O TFS 1.5 é escrito em C++17 e usa Boost, LuaJIT (ou Lua 5.4), MySQL client lib, PugiXML e CryptoPP. Você precisa de todos eles, mais o toolchain GCC e o CMake pra gerar os arquivos de build.

sudo apt install -y build-essential cmake git
sudo apt install -y libluajit-5.1-dev libmariadb-dev libboost-system-dev \
  libboost-iostreams-dev libboost-filesystem-dev libboost-date-time-dev \
  libpugixml-dev libcrypto++-dev libfmt-dev

sudo adduser --disabled-password --gecos "" otserv
sudo usermod -aG sudo otserv

Clone e compilação do TFS

Com as dependências instaladas, baixe o código-fonte e gere o binário.

sudo -iu otserv
cd ~
git clone --depth 1 https://github.com/otland/forgottenserver.git tfs
cd tfs

mkdir build && cd build
cmake ..
make -j$(nproc)

Configuração do banco MySQL

O TFS persiste contas, personagens, casas, guildas e itens em um banco relacional. MariaDB é a implementação padrão no Ubuntu.

exit
sudo apt install -y mariadb-server
sudo mysql_secure_installation

sudo mariadb

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

sudo -iu otserv
cd ~/tfs
mariadb -u otserv -p forgottenserver < schema.sql

Configuração do servidor

Com o banco pronto, ajuste o config.lua pra apontar pras credenciais corretas e definir parâmetros do mundo.

cd ~/tfs
cp config.lua.dist config.lua
nano config.lua

ip = "0.0.0.0"
mysqlHost = "127.0.0.1"
mysqlUser = "otserv"
mysqlPass = "TROQUE_ESTA_SENHA"
mysqlDatabase = "forgottenserver"
mysqlPort = 3306
loginProtocolPort = 7171
gameProtocolPort = 7172
statusProtocolPort = 7171
serverName = "Meu OTServ"
worldType = "pvp"

Liberação do firewall e primeiro start

O TFS usa duas portas TCP: 7171 pro login (autenticação e seleção de personagem) e 7172 pro game (movimentação, chat, combate em tempo real).

exit
sudo ufw allow 7171/tcp
sudo ufw allow 7172/tcp
sudo ufw reload
sudo ufw status

sudo -iu otserv
cd ~/tfs/build
./tfs

The Forgotten Server - Version 1.5
>> Loading config
>> Establishing database connection... MySQL 10.11.x
>> Running database manager
>> Loading vocations
>> Loading items
>> Loading script systems
>> Loading monsters
>> Loading map
>> Loaded map
>> Loaded all modules, server starting up...
>> A server has been started on 0.0.0.0:7171.

Verificação

Em outra máquina (ou no seu próprio desktop), abra um terminal e teste conectividade:

telnet SEU_IP_DA_VPS 7171

Se você ver Connected to ... e o terminal travar esperando input, a porta está aberta e o TFS está escutando. Aperte Ctrl+] e digite quit pra sair.

Pra teste real com cliente Tibia 8.60, ajuste o arquivo Tibia.dat/Tibia.spr da pasta do cliente pra apontar pro seu IP em vez do login.tibia.com oficial — ferramentas como OTClient permitem fazer isso pelo init.lua.

Resolução de problemas

MySQL connection failed

Se o TFS imprime MySQL connection failure!, cheque três coisas:

1. O serviço está rodando: sudo systemctl status mariadb
2. Credenciais batem: tente login manual com mariadb -u otserv -p forgottenserver
3. mysqlHost no config.lua é 127.0.0.1, não localhost (em alguns setups o socket Unix falha mas o TCP funciona)

Port already in use

Erro bind: Address already in use na porta 7171 significa que outro processo está usando. Identifique com:

sudo ss -tulpn | grep 7171

Se for uma instância antiga do TFS, mate com pkill tfs e tente de novo.

Cliente conecta mas não passa do login

O cliente conecta na 7171 (login) mas falha ao mover pra 7172 (game). Quase sempre é firewall bloqueando 7172 enquanto 7171 está aberta — refaça o sudo ufw status e libere a porta que faltar. Se o servidor está atrás de NAT (não é caso comum em VPS), redirecione ambas as portas.

Próximos passos

• Configure o TFS pra rodar como serviço systemd em vez de processo manual — facilita restart automático em queda
• Edite scripts Lua em data/scripts/ pra customizar quests, NPCs e eventos
• Use o RME (Remere’s Map Editor) no Windows pra editar data/world/forgottenserver.otbm
• Configure backups automáticos diários do banco com mysqldump no cron
• Se você está colocando isso em produção pra jogadores reais, uma VPS Hostini já vem com IPv4 fixo, proteção DDoS e disco NVMe — eliminando os três problemas de rede mais comuns em hospedagem doméstica.