Guia prático: baixando e rodando Alice no Mundo das Maravilhas
O projeto "Alice no Mundo das Maravilhas" é uma recriação interativa em código aberto baseada no clássico de Lewis Carroll. Na prática, você baixa o repositório, instala as dependências e roda um servidor local para navegar pela experiência. Não é um jogo triple-A — é algo mais próximo de uma demo técnica feita em Python com bibliotecas como Pygame ou Tkinter, dependendo da versão que você encontrar. O que muita gente não percebe na hora de baixar é que existem várias forks espalhadas pelo GitHub, e nem todas estão atualizadas. A versão original que eu mais uso é a que está em github.com/eduardoborges/alice-wonderland. Ela roda em Python 3.8+ e exige que você tenha o Pygame instalado. Sem ele, simplesmente nada abre.
O que esperar do alice no mundo das maravilhas
A jogabilidade gira em torno de resolver puzzles baseados em citações e cenas do livro. O usuário avança por cenas estáticas com opções de diálogo, e alguns caminhos mudam dependendo das escolhas. É basicamente um visual novel simples, mas com código bem estruturado que facilita estudar a lógica por trás. Uma coisa que os iniciantes costumam ignorar é que o projeto não tem instalador. Você precisa clonar o repositório com git ou baixar o ZIP, entrar na pasta e rodar pip install -r requirements.txt antes de tudo. Se pular esse passo, recebe um erro de módulo não encontrado e acha que o código está quebrado. Na verdade, só faltava o Pygame mesmo.
Outro detalhe técnico importante é que a versão oficial foi testada no Windows 10 e Ubuntu 20.04. Eu já tentei rodar no macOS 12 e tive problemas com o Pygame não encontrando o driver de áudio. A solução foi passar a flag --no-audio ao iniciar, ou usar a versão portable do Pygame que já vem com os codecs embutidos.
Passo a passo para rodar sem dor de cabeça
Vamos direto. Abra o terminal, navegue até a pasta onde quer que o projeto fique e rode: git clone https://github.com/eduardoborges/alice-wonderland.git
Depois disso, entre na pasta e crie um ambiente virtual. Eu recomendo usar venv porque evita conflito com outros projetos. O comando é simples: python -m venv venv
Ative o ambiente. No Windows: venv\Scripts\activate. No Linux/Mac: source venv/bin/activate. Aí sim roda o pip install. pip install -r requirements.txt
👉 Clique no botão abaixo para saber mais sobre o assunto!
Se o requirements.txt reclamar de alguma versão específica do Pygame, não entre em pânico. Troque para a versão mais recente com pip install pygame --upgrade. Isso resolve em 90% dos casos. Para iniciar o jogo, use:
python main.py O arquivo main.py é o entry point. Se o terminal mostrar uma tela preta e fechar imediatamente, verifique se há um arquivo de log na pasta logs/. Na maioria das vezes, o erro é de caminho de imagem — o código procura os assets numa pasta relativa e se você rodou de outro diretório, não encontra.
Problema que eu encontrei e como resolvi
Uma vez, ao rodar o projeto num computador com resolução 4K, a interface ficou completamente distorcida. Os botões de diálogo apareciam fora da tela e o texto ficava cortado. O problema era que o código usava resolução fixa de 800x600, o que não escala bem em telas altas. A solução foi modificar duas linhas no arquivo config.py. Substituí as constantes de largura e altura fixas por cálculos baseados no display atual usando a biblioteca ctypes no Windows ou subprocess no Linux. No final, ficou assim:
Em vez de WIDTH = 800, eu coloquei um chamando get_screen_width() que lê a resolução do monitor via chamada de sistema. Levou cerca de 20 minutos para ajustar e testar. Depois disso, a interface se adapta a qualquer resolução.
Pegadinhas e limitações
Vou ser objetivo aqui: o projeto não é perfeito. Alguns puzzles têm solução única e se você errar o caminho, não há botão de voltar. Tem que reiniciar o jogo inteiro. Isso foi intencional na época do desenvolvimento, mas faz sentido considerar isso antes de investir tempo. Outro ponto: o código usa bastante variáveis globais. Isso não é um problema para rodar, mas se você quiser modificar algo ou estender a história, pode se perder rápido. Recomendo fazer uma cópia de trabalho antes de mexer nos arquivos originais.
Se o seu objetivo é apenas jogar, baixe e siga o passo a passo. Se quiser estudar o código, foque nos arquivos scenes.py e dialogue_engine.py — são os que têm a lógica principal e estão bem comentados. Existem alternativas mais maduras no mesmo gênero, como o Ren'Py, que oferece ferramentas próprias para criar visual novels. Se você quer construir algo do zero, talvez valha a pena olhar por lá em vez de modificar o código existente.
