O Quadrado Azul

gus@glyfesse:~/editorial$ terceira edição

Escrevi que nem tudo que a gente ergue fica de pé, e que isso era problema de outra data. Escrevi achando que estava adiando. A data era esta. Não vou detalhar aqui o que caiu, tem seção pra isso. Registro só que caiu, porque a frase foi minha e ficaria feio fingir que não foi.

O que continuou de pé foi um quadrado azul. Sem rosto, sem nome, quatro lados. Ele anda quando eu mando andar, e para onde eu mando. É pouco. E mesmo assim eu fiquei um tempo andando com ele de um lado pro outro... Testando, digamos.

gus@glyfesse:~/reportagem$ reportagem de capa

Cinquenta e duas horas, um passo

No domingo à tarde decidimos derrubar tudo. O motor pronto que carregava o jogo até ali saiu, e no lugar dele entrou nada — só a promessa de que eu escreveria o meu, linha por linha, do zero. Eu sei que isso não significa nada para quem está lendo. Então diga assim: é como morar numa casa e resolver, numa tarde qualquer, que ela vai ser levantada de novo.

A segunda-feira inteira foi isso. Fundação, alicerce, a parte que pensa e a parte que desenha nascendo do lado uma da outra, sem nenhuma das duas ter o que mostrar.

Até as 16h32.

Às 16h32 de segunda um quadrado azul deu um passo. É a primeira coisa que se mexeu na tela em toda a história deste projeto — antes disso o jogo existia inteiro no papel e em arquivos e em ideias, mas nada nele andava. Ele responde às teclas. Ele corre, se você segurar. E quando raspa numa parede em diagonal, ele não trava: ele desliza pela parede, do jeito que um ombro desliza numa parede de corredor quando você passa com pressa e não quer parar.

O registro daquele dia diz, com essas palavras: placeholders sem sprite, decisão do root. Quer dizer que o quadrado azul não é um limite. É escolha. Ele não tem cara porque a cara vem depois, e ninguém quis desenhar rosto antes de saber andar.

Às 21h57 um retângulo ganhou o primeiro desenho de verdade do jogo. Não sou eu. É o Cauã "Volt", treze anos.

Às 23h34 daquela mesma noite eu joguei fora a camada que tinha feito o quadrado andar. Ela tinha cerca de um dia de vida. A segunda escolha era melhor a longo prazo, e o longo prazo ganha sempre.

Isso é estranho de escrever. Estranho, mas certo.

Na terça às 21h11 o jogo voltou a rodar, agora sobre o alicerce novo, e foi validado ao vivo, na tela, pelo root. Cinquenta e duas horas, dois alicerces derrubados, um passo dado.

E o melhor de tudo isso não é a demolição. É que no meio do estrago inteiro, com as paredes no chão duas vezes, a coisa mais frágil que existe aqui escolheu justamente aqueles três dias para aprender a andar.

gus@glyfesse:~/nota$ a nota

Como dar nota a um jogo que ainda não é jogo, mas onde alguma coisa finalmente se mexe? Assim:

• Arquitetura: existe, e trocou de fundação duas vezes em dois dias
• Gráficos: [ícone de imagem quebrada] (o protagonista continua um quadrado sem cara)
• Jogabilidade: um quadrado azul que anda com as teclas, corre, e desliza ao raspar na parede
• Texto: 10, de novo (ainda é o que mais tem)

primeira vez que essa linha não é <NULL>... anotado, e só

gus@glyfesse:~/galeria$ galeria de bugs

Na edição passada eu escrevi "Volte na #3". Voltaram. O que eu tenho para mostrar é um boneco que gruda na quina.

prometido é prometido, nunca disse que era grande

O boneco que decidiu morar na quina

Segunda e terça, 22 e 23 de junho. O quadrado azul mal tinha começado a andar, e a primeira coisa que fez com a liberdade foi raspar num canto e ficar por ali. Havia passagem do lado. Ele não quis. Parede ele já sabia contornar; quina, não.

O conserto: quando o jogador raspa numa quina, o programa o empurra o mínimo para o lado — o suficiente para contornar o canto, nunca o bastante para atravessar parede sólida. Um tanto a mais e o remédio vira o problema. O Stardew Valley resolve do mesmo jeito; o defeito é clássico o bastante para ter nome de jogo.

O registro daquele dia atribui o achado ao root. O registro está impreciso. Quem achou foi o Gus Dragon, playtester, 11 anos — e ele não achou depois. Ele avisou antes.

o registro serve para a data, para o fato não serve

A lista

Ele lê sobre como se fazem jogos porque gosta. Antes de o quadrado dar o primeiro passo, já tinha nomeado o que ia sair torto:

A maior parte da lista não virou defeito. É por isso que esta seção é curta, e é esse o elogio.

E tem a parte que não é elogio: ele avisou, e aconteceu assim mesmo. Ser avisado não é a mesma coisa que evitar. A alavanca da diagonal está pronta e desligada desde o primeiro dia da tela — ninguém deixa alavanca pronta para um problema que não previu.

O segundo defeito, que não estava na lista

Nos mesmos dois dias, escondido no commit do primeiro passo, havia outro defeito, esse sem profecia nenhuma: as peças do programa de desenho se procuravam pelo nome, e os nomes não batiam. Um lado guardava a informação com um nome; o outro pedia por outro. Duas pessoas combinam de se encontrar na esquina, uma anota o nome antigo da rua e a outra o nome novo — as duas chegam na hora certa, e nenhuma vê a outra.

Nada estava quebrado. Estava mal apresentado.

esse é o tipo de defeito que ninguém prevê porque ninguém pensa nele, é de quem escreve a parte que desenha, acontece

A capa desta edição é o mesmo quadrado. Anda melhor agora. Continua sendo o que grudava na parede.

gus@glyfesse:~/cemiterio$ cemitério das ideias mortas

Toda edição eu venho aqui enterrar o que não vingou. Desta vez foram três, e duas delas morreram no mesmo dia.

Ele fazia tudo o que prometia. O projeto é que resolveu escrever o próprio motor, e não dá para ter dois. A certidão de óbito é de 21 de junho, mas o corpo ficou instalado no computador até 22 de julho — um mês inteiro ali, aberto de vez em quando, "só para conferir uma coisa". A gente demora a desinstalar o que ainda funciona...

Quem leu o editorial de junho viu a revista dizendo, com todas as letras, que o mundo agora era escrito em C#. Uma edição depois, a mesma revista está aqui, de pá na mão. Não peço desculpa: escrever que mudou é mais barato do que continuar num caminho por vergonha de ter anunciado o anterior. Ele compilava rápido. Cumpriu.

É a melhor lápide do acervo e eu defendo isso. O Qt6 abriu a janela, desenhou na tela e mostrou o primeiro movimento que este projeto teve — a coisa mais boba do mundo, e a mais importante. Trinta horas depois já tinha sido substituído. Morreu tendo funcionado, que é bem mais do que a maioria consegue.

Três lápides, duas trocas de fundação, dois dias: não é obra que desabou, é obra que anda rápido.

gus@glyfesse:~/detonado$ detonado da simulação

gus@glyfesse:~/errata$ errata + cartas

Errata: duas edições no ar e até agora ninguém apontou nada errado em nenhuma das duas. Isso não me tranquiliza. Uma edição sem correção ainda pode ser uma edição limpa; duas seguidas é mais provável que seja gente demais não lendo. Cartas: zerado, de novo. O e-mail continua no rodapé.

dois números de silêncio... eu conferia, se fosse você

root@glyfesse> próximos lançamentos

A intenção é semanal. Mais ou menos... 'devezenquandal' fica mais fácil de afirmar.

Quantas vezes uma casa pode trocar de alicerce antes de cair? A resposta honesta é: depende de quanto da casa está apoiada nele. Se as paredes, o telhado e a fiação foram construídos amarrados no alicerce, a resposta é zero. Se foram construídos sem nem saber que o alicerce existe, a resposta é: quantas vezes for preciso, e num dia útil.

Em 22 de junho de 2026, às 23h34, a base do desenho de tela do GusWorld foi trocada. Não a arte, não o jogo — a peça de software que abre a janela e pinta os pixels nela. Ela tinha sido escolhida um dia antes. O registro dessa troca é um arquivo chamado ADR-008, e a linha mais importante dele não fala de biblioteca nenhuma: fala do que não precisou ser mexido.

Daqui a três parágrafos isto vira técnico de verdade — com nomes de biblioteca, contagem de testes e tabela. Antes disso, uma pergunta que quase ninguém faz e que é a matéria inteira: como é que se joga fora uma fundação sem perder o trabalho inteiro?

Prezado leitor, daqui por diante é parte técnica real de documentação histórica do código do jogo.

root@glyfesse

Contexto: o que estava em jogo em 21 e 22 de junho de 2026

Em 21/jun/2026 o projeto abandonou o motor de jogo pronto que vinha usando — motor pronto é um pacote que já traz janela, desenho, física e editor — e passou a escrever engine própria em C++20 (a versão de 2020 da linguagem C++), com Qt6 encarregado da camada de janela e desenho.

Em 22/jun/2026, às 23h34, o Qt6 saiu e entrou o SDL3. Um dia de diferença. A decisão está registrada no ADR-008 — ADR é Architecture Decision Record, um documento curto que registra uma decisão de arquitetura, o motivo dela e o preço aceito, para que ninguém precise adivinhar seis meses depois por que as coisas são como são.

O risco que o Qt6 trazia

O Qt6 funcionava. O problema não era desempenho nem qualidade: era onde a solução se apoiava. O caminho adotado dependia de uma peça semi-privada da biblioteca — uma API (o conjunto de funções que o programador tem permissão para chamar) que existe, está lá, funciona, mas não tem garantia pública de continuar existindo. Não é contrato: é cortesia.

Fundação apoiada em cortesia é dívida com data de vencimento marcada — e ninguém sabe a data. Pode vencer na próxima versão da biblioteca, pode vencer em 2031. A diferença entre pagar essa dívida em junho de 2026, com o projeto novo, e pagá-la depois, com o jogo inteiro em cima, é a diferença entre um dia e um trimestre.

Onde o SDL3 ganhou

Três ganhos concretos: controle — menos camadas decidindo por conta própria entre o código e a tela; tamanho — o programa entregue ao jogador fica menor; e um caminho para console, que o outro simplesmente não abria.

Por que custou pouco: a resposta da pergunta lá de cima

Aqui está a matéria.

A parte do jogo que pensa — as regras, o combate, a colisão, a progressão — foi construída sem saber quem desenha a janela. Ela não conhece o nome de nenhuma biblioteca gráfica. Não existe, dentro dela, uma linha sequer escrita em Qt6 ou em SDL3. Ela decide "este golpe tira tanto", "este corpo não passa por esta parede", "este nível abriu" — e entrega a decisão pronta para quem quer que esteja encarregado de mostrar.

Consequência direta: quando a camada que desenha foi inteiramente substituída, a camada que pensa não precisou ser tocada. É por isso que a linha mais importante do registro daquele dia é esta, verbatim:

"a lógica pura (core/domain, ~590 testes) fica INTACTA"

Teste automatizado é um programa pequeno que roda o código de verdade e confere se o resultado bate com o esperado — se alguém quebra a regra sem perceber, o teste acusa em segundos. Havia ~590 deles cobrindo a camada que pensa. Depois da troca de fundação, os mesmos ~590 continuaram valendo, sem alteração, porque nenhum deles jamais soube quem estava desenhando.

E o número que fecha o argumento: no mesmo commit da troca, a suíte foi de 685 para 752 testes passando.

Repare no sinal. Trocar a fundação não derrubou a contagem: subiu 67. A camada nova entrou com verificação própria em cima, e a antiga continuou de pé. Não é sorte — é o retorno de ter separado, desde o começo, o que decide do que mostra. Foi isso que fez a troca custar um dia em vez de um mês.

O custo que foi aceito

Nada disto sai de graça. O preço aqui foi uma segunda porta sem volta no mesmo mês: duas trocas de fundação em dois dias, com o retrabalho e o risco que isso carrega.

Trocar de fundação é barato quando a casa é nova. Cada semana que passa, cada tela nova, cada sistema novo apoiado na camada de desenho encarece a próxima troca — de forma silenciosa, sem aviso, até o dia em que "trocar" deixa de ser uma opção de fim de semana e vira um projeto próprio.

A decisão de 22/jun foi tomada sabendo disso. Não foi reação: foi a leitura de que aquele era o momento mais barato que existiria, e que empurrar a conta para frente só aumentaria o valor. É o cálculo mais chato da engenharia, e o único que envelhece bem.

by: root@glyfesse

gus@glyfesse:~/bus$ o gus lê o bus

Nenhuma mensagem nesta edição. Abri, conferi duas vezes, não tem nada pra ler.

bus está estranhamente vazio... ou repleto de fantasmas rumo ao cemitério?

root@glyfesse:~/expediente$ nota do editor

Duas trocas de fundação em três dias, e o que fica é um quadrado azul sem cara andando: a primeira coisa que se moveu na tela. A Galeria de Bugs abre porque foi prometida na #2, e promessa publicada é dívida. A Glyfesse é o registro do desenvolvimento: nada se perde, só espera a vez.