Coisas que aprendemos pelo caminho

Nem toda descoberta rende um artigo próprio. Aqui vai uma coletânea de pequenas lições dos últimos meses — cada uma nos custou pelo menos uma noite.

Portas precisam de três blocos de altura. Parece errado, mas é física: nosso personagem é uma cápsula de pouco menos de 1,9 bloco — só que a lógica de subir degraus (step offset) ainda sonda 0,6 bloco para cima enquanto se anda. Uma porta de dois blocos de altura é matematicamente alta o bastante e, na prática, baixa demais: você fica preso. Desde então, a regra para construir naves e estações é: passagens têm três blocos de altura. Sempre.

O vidro deve ser leitoso. Nosso primeiro vidro transparente era tecnicamente correto e parecia um buraco na parede. O vidro leitoso, fosco, funciona muito melhor como material em um mundo de blocos — dá para ver que tem algo ali. Às vezes a solução realista é a pior.

git pull antes da branch de feature. Uma vez trabalhamos por semanas em um estado enquanto dois PRs grandes já tinham sido mesclados no servidor havia tempo. O conflito de merge no final foi merecido. A branch principal local não é um fato, é uma lembrança.

Windows, caminhos longos e git worktrees. Projetos Unity criam caches de pacotes com aninhamento profundo — tão profundo que os limites de comprimento de caminho do Windows sabotam a limpeza dos git worktrees. O truque que nos salvou foi tão feio quanto eficaz: espelhar um diretório vazio sobre o teimoso com o robocopy e depois apagar.

O editor mente. (Veja o artigo sobre shaders na categoria Tech.) O que funciona no editor do Unity ainda não provou nada sobre o build.

Lições pequenas, grande impacto: cada uma virou uma linha de checklist. Talvez essa seja a verdadeira lição.