Todo currículo que eu mando agora tem uma nota lá em cima dizendo “Is reading this CV too boring? Try a more interactive version”, e do lado tem um QR code que abre um jogo de ritmo onde você enfrenta slimes no ritmo da música pra desbloquear o meu histórico profissional. Vindo do cara que fez uma versão em jogo do próprio blog, eu sei, isso não é exatamente um plot twist.
Jogue aqui!#
Mas… por quê?#
Eu tô procurando emprego, e procurar emprego significa escrever currículo, e escrever currículo significa revisar o meu próprio histórico de novo e de novo, as mesmas empresas, as mesmas datas, os mesmos bullet points, até que uma hora eu pensei “porra, que coisa chata”.
A última vez que currículo me irritou desse jeito eu criei o Resume Builder, e uma recrutadora achou o repositório, perguntou se eu sabia React, e foi assim que eu vim parar na Holanda. Então eu já tenho um histórico de resolver problema de currículo com código, e dessa vez eu lembrei do jogo do meu blog e pensei “que tipo de jogo funcionaria bem como um jeito de mostrar o meu currículo?”. E não veio nada na minha cabeça. Nada mesmo.
Gotinha, de novo#
Uns dias depois eu lembrei do Gotinha, o primeiro jogo que eu lancei, a gotinha d’água desviando de hidrantes. Eu sempre quis voltar e melhorar ele, porque de lá pra cá eu evoluí tanto como programador quanto como desenvolvedor de jogos, e o Gotinha ainda é aquele jogo em que as fases são geradas por um monte de tracinhos caindo pela tela.
Então o primeiro rascunho era só o Gotinha, e quanto mais longe você fosse, mais coisa do meu currículo ia aparecendo. Tudo lindo e maravilhoso.
O Gotinha original, ainda desviando de hidrante
O ensaio da banda#
Aí um dia eu fui num ensaio da banda de um amigo, e eles estavam tocando uma música bem funky e chiclete, e aquilo me lembrou do Crypt of the NecroDancer, aquele dungeon crawler em que você só pode se mexer no ritmo da música. E aí eu pensei, e se eu fizesse o Gotinha, só que com ritmo?
Foi isso. O nome é basicamente porque eu gosto muito da palavra “tempo” (em inglês), desde que eu aprendi ela naquela música do Fatboy Slim. Quer dizer, claro, tempo também é o tema do jogo de certa forma, então tudo se encaixa direitinho.
O Gotinha, só que com ritmo: três faixas, uma barra de ritmo embaixo e um slime te esperando
Modo product owner#
O Gotinha tinha uma regra: eu fiz tudo sozinho, o código, os sprites, os efeitos sonoros, a música, até a arte toda tosca. Dessa vez eu queria ver até onde a IA tinha chegado, então eu ia agir basicamente como product owner e criar um jogo do começo ao fim sem criar nada eu mesmo, só a ideia.
Só o código, na verdade. Eu não queria música feita por IA nem arte feita por IA, porque tem um monte de música e arte grátis feitas por gente de verdade por aí. Então depois de pesquisar um pouco e ouvir umas músicas, eu escolhi essas:
- o Ninja Adventure Asset Pack, por Pixel-boy e AAA, pros personagens, monstros, chefes, tiles e efeitos sonoros
- o herói vem do Puny Characters, por Shade, a sheet Warrior-Blue cortada em frames de 16x16
- três músicas do Free Rhythm Game Music Pack 2, por Tricks & Traps: Extended, T.O.E. e Drama
Todos são CC0, então crédito não é obrigatório, mas claro, é muito bem-vindo por essas pessoas talentosas, então numa tela de créditos no jogo eu coloquei todas as atribuições das artes e os respectivos links.
A única exceção foi a poça de veneno. Eu precisava de um tile extra pra um obstáculo e o pack não tinha, então eu usei o Gemini pra fazer um rascunho da ideia, depois redimensionei no Photopea e dei uns retoques. Isso, e a logo, mas eu falo dela mais pra frente.
Tudo aqui é livre pra usar. Valeu a quem fez.
As músicas não entram no jogo do jeito que vêm no pack. Um script corta cada uma num loop de compassos inteiros, começando exatamente na primeira batida, pra música poder ficar em loop pra sempre sem sair do ritmo do jogo:
const TRACKS = [
{ id: "extended", file: "5_extended.wav", bpm: 120, bars: 48 },
{ id: "toe", file: "7_t.o.e.wav", bpm: 120, bars: 48 },
{ id: "drama", file: "2_drama.wav", bpm: 86.6667, bars: 32 },
];
for (const track of TRACKS) {
// ...decode the WAV to mono, low-passed to the kick drum, at 4000 Hz
const phase = measurePhase(pcm, SAMPLE_RATE, track.bpm);
const seconds = (track.bars * BEATS_PER_BAR * 60) / track.bpm;
execFileSync("ffmpeg", [
"-v", "error", "-y", "-ss", phase.toFixed(4), "-t", seconds.toFixed(4), "-i", input,
"-c:a", "libmp3lame", "-b:a", "160k", path.join(outDir, `${track.id}.mp3`),
]);
}O measurePhase acha onde está a primeira batida, e aí o ffmpeg corta exatamente 48 compassos (ou 32 no caso da Drama) a partir dali. Daqui a pouco eu falo mais do measurePhase, porque ele aparece de novo no navegador.
O infinite runner#
Eu peguei o boilerplate do Phaser 4 com Vite e usei o Claude pra criar um conceito de infinite runner, com os inimigos e os obstáculos aparecendo conforme você avança. Que nem no Gotinha, o jogador não vai a lugar nenhum de verdade, é a dungeon que vem até você, mas em vez de duas paredes são três faixas, e cada aperto de botão é um passo.
A geração das fases é bem menos vergonhosa que os tracinhos do Gotinha. A dungeon é montada com padrõezinhos feitos à mão, uma linha por passo, onde s é espinho, o é uma poça de veneno e e é um inimigo:
{ "id": "single-spike-center", "minTier": 0, "rows": [".s."] },
{ "id": "wall-gap-left", "minTier": 1, "rows": [".oo"] },
{ "id": "weave", "minTier": 2, "rows": ["s..", ".s.", "..s"] },
{ "id": "slalom", "minTier": 3, "rows": ["s.o", "os.", "s.o"] }Os padrões mais difíceis vão sendo liberados nos níveis mais altos, e as linhas vazias entre eles vão de três pra uma. Antes de um padrão entrar, o gerador confere se dá mesmo pra passar por ele, começando de cada faixa em que você poderia estar e andando no máximo uma faixa por linha:
export function reachable(rows: readonly Row[], from: readonly Lane[]): Lane[] {
let lanes = new Set<Lane>(from);
for (const row of rows) {
const next = new Set<Lane>();
for (const lane of lanes) {
for (const direction of [0, -1, 1] as const) {
const target = direction === 0 ? lane : moveLane(lane, direction);
if (!isHazard(row[target])) next.add(target);
}
}
lanes = next;
if (lanes.size === 0) return [];
}
return [...lanes].sort() as Lane[];
}Então sempre dá pra sobreviver a uma partida, desde que você não perca o ritmo. Os monstros são opcionais, dá pra desviar deles, menos nos portões. A cada 40 linhas o gerador coloca uma linha pra respirar e depois um monstro ocupando as três faixas, e não tem como fugir:
if (gates && produced >= nextGate) {
// A breath, then the gate. Whatever lane the player is in, they fight, and they can step anywhere during it.
push(decorate(EMPTY));
push(GATE);
lanes = [0, 1, 2];
nextGate = produced + gates.every;
return;
}O primeiro portão vem na linha 12, então toda partida encontra um monstro (e um pedaço do meu currículo) em questão de segundos, e o jogo literalmente mostra “SEM SAÍDA!” na tela quando isso acontece.
Uma poça de veneno, umas moedas e um slime lá na frente
Lutando no ritmo#
Encostar num monstro começa uma luta, e os botões continuam significando a mesma coisa: esquerda, direita e ficar parado. Cada aperto no ritmo acerta o monstro, e o monstro marca faixas em vermelho, e você tem que sair delas antes do golpe cair. Os monstros também são strings, cada caractere é um passo do ataque, e o p mira na faixa em que você estiver:
{ "id": "giant-slime", "sprite": "giant-slime", "boss": true, "hp": 24, "damage": 2, "tier": 1,
"phases": [
{ "fromHpFraction": 1, "cycles": ["..p.", "..s."] },
{ "fromHpFraction": 0.5, "cycles": [".p.p", ".l..r.", "pp.."] }
] }Um aperto Perfeito dá dois de dano e um Bom dá um, e quando um golpe leva um chefe pra próxima fase, o padrão dele recomeça e os ataques que já estavam a caminho são cancelados (e a tela mostra “FÚRIA!”):
export const HIT_DAMAGE: Record<"perfect" | "good", number> = { perfect: 2, good: 1 };
export function hitEnemy(battle: Battle, judgement: "perfect" | "good"): HitResult {
const damage = Math.min(HIT_DAMAGE[judgement], battle.enemyHp);
const enemyHp = battle.enemyHp - damage;
if (enemyHp <= 0) return { battle: { ...battle, enemyHp: 0, strikes: [] }, damage, defeated: true, enraged: false };
const phase = phaseIndex(battle.enemy, enemyHp);
if (phase !== battle.phase) return { battle: { ...battle, enemyHp, phase, cursor: 0, strikes: [] }, damage, defeated: false, enraged: true };
return { battle: { ...battle, enemyHp }, damage, defeated: false, enraged: false };
}Um chefe aparece depois de seis lutas normais. O Giant Slime tem 24 de HP e muda de padrão quando chega na metade, e o Demon Cyclop tem 32 de HP e três fases.
O Demon Cyclop, uma faixa vermelha prestes a levar o golpe e a poça de veneno do lado
Os prints e o vídeo desse post foram gravados com o bot do Playwright que os testes de navegador usam, que joga o jogo de verdade contra o relógio de áudio de verdade, apertando logo depois de cada batida. Ele derrotou o Demon Cyclop sem perder nenhum coração.
A parte em que eu não confiei no Claude#
A única coisa em que eu achava que o Claude não ia mandar bem era sincronizar o tempo do jogo com a música. Jogo de ritmo vive da sensação do aperto caindo exatamente quando a música bate, então eu fiz essa parte na mão pra música padrão, a Extended, principalmente porque eu queria muito acertar a sensação do jogo.
E claro que a Extended foi a chata. Ela é 120 BPM, mas o bumbo dela não bate em toda batida, ele faz “TUM TUM, pausa”, então apertar em toda batida dava a sensação de que um aperto sim, um não, caía no nada. A minha primeira tentativa foi tocar ela a 60 BPM em compassos de dois tempos, e 20 minutos depois eu joguei isso fora e dei um groove pra ela, um ciclo de dois tempos com um passo no primeiro tempo e outro uma colcheia pontuada depois:
{ "id": "extended", "name": "Extended", "file": "extended.mp3", "bpm": 120, "beatsPerBar": 4, "stepEvery": 1,
"groove": { "beats": 2, "steps": [0, 0.75] }, "phaseHint": 0.98, "loopBars": 47, "artist": "Tricks & Traps" }O jogo conta em passos, não em batidas, então com um groove a posição do passo é só um pouco mais de matemática. Dentro de cada ciclo ele acha em qual passo você está e quanto você já andou dele, e todo o resto (o runner, as lutas, a contagem regressiva) continua funcionando em passos sem saber que a música é esquisita:
export function stepPosition(songTime: number, track: Track, calibrationSeconds = 0): number {
const beat = beatPosition(songTime, track, calibrationSeconds);
const { beats, steps } = grooveOf(track);
if (steps.length === 1) return beat / beats;
const cycle = Math.floor(beat / beats);
const within = beat - cycle * beats;
let index = steps.length - 1;
while (index > 0 && steps[index] > within) index--;
const end = index + 1 < steps.length ? steps[index + 1] : beats;
return cycle * steps.length + index + (within - steps[index]) / (end - steps[index]);
}O build também recusa um groove em que dois passos fiquem a menos de 0,36 s um do outro, então as janelas de “Bom” de dois passos nunca se sobrepõem, nem com o Tempo relaxado ligado.
Mantendo o ritmo#
A música é o relógio. O tempo nunca é somado a partir dos deltas dos frames, ele é lido do relógio do Web Audio, e não só do currentTime, que é a amostra sendo renderizada agora, mas do getOutputTimestamp(), que é o som saindo das caixas de som agora:
songTime() {
if (!(context && source)) return silent.songTime();
// Frozen while suspended: the output timestamp would keep extrapolating.
if (context.state !== "running") return lastSongTime;
lastSongTime = Math.max(lastSongTime, heardAt(performance.now()) - startedAt, 0);
return lastSongTime;
},A tela e o input leem o mesmo relógio, então um aperto na batida que você vê é um aperto na batida que você ouve. E se o Web Audio não funcionar de jeito nenhum, ele cai pra um relógio silencioso e o jogo continua jogável com a barra de ritmo na tela.
Um aperto é avaliado pela distância até o passo mais próximo:
/** The starting windows: ±60 ms is perfect, ±120 ms is good. */
export const DEFAULT_WINDOWS: Windows = { perfectMs: 60, goodMs: 120 };
/** The assist for touch screens and slow displays: every window 50% wider. */
export const RELAXED_FACTOR = 1.5;
export function judge(offsetMs: number, windows: Windows): Judgement {
const distance = Math.abs(offsetMs);
if (distance <= windows.perfectMs) return "perfect";
if (distance <= windows.goodMs) return "good";
return "miss";
}Na dungeon um aperto te move na hora, mas um passo sem aperto só conta como erro quando a janela de “Bom” atrasada dele acaba, então um aperto um pouquinho atrasado ainda conta:
/** A step with no press is resolved once its late Good window is over: this song time. */
const graceOver = (step: number) => timeOfStep(step, track, calibration) + windows.goodMs / 1000;Também tem uma opção de “Tempo relaxado” que deixa as duas janelas 50% maiores, e dá pra calibrar o seu próprio atraso nas configurações batucando junto.
A última peça é o measurePhase, o mesmo do script que corta os loops. O jogo roda ele de novo no navegador toda vez que carrega uma música, porque os decodificadores de MP3 adicionam quantidades diferentes de silêncio no começo do arquivo, e sem isso todo aperto ia ficar fora por seja lá quanto silêncio o seu navegador decidiu adicionar. Ele monta um envelope de quanto os graves ficam mais altos a cada milissegundo, aí testa cada deslocamento possível dentro de uma batida e soma os bumbos que caem naquele deslocamento, e em todas as batidas depois dele. O deslocamento com mais bumbo ganha:
export function measurePhase(samples: ArrayLike<number>, sampleRate: number, bpm: number): number {
const { onsets, rate } = onsetEnvelope(samples, sampleRate);
const period = (60 / bpm) * rate;
const candidates = Math.max(1, Math.floor(period));
let best = 0;
let bestScore = -1;
for (let candidate = 0; candidate < candidates; candidate++) {
let score = 0;
for (let at = candidate; at < onsets.length; at += period) score += onsets[Math.round(at)] ?? 0;
if (score > bestScore) {
bestScore = score;
best = candidate;
}
}
return best / rate;
}O problema é que o corpo de um bumbo atinge o pico dezenas de milissegundos depois do clique, então um detector que só escuta os graves lê a batida um pouco atrasada. Por isso cada música também tem um phaseHint, a primeira batida real conferida contra os chimbais, e o navegador só usa a própria medição pra corrigir o que o decodificador deslocou.
Mais duas músicas#
Depois de terminar a Extended, eu pedi pro Claude fazer o mesmo com a T.O.E. e a Drama, e ele mandou bem de verdade.
A T.O.E. foi a fácil, um 120 BPM reto com a primeira batida logo no começo do arquivo. A Drama foi lida primeiro como 130 BPM, mas o pulso que você realmente acompanha batucando são os chimbais, e eles batem a 86,67, dois terços disso, então o loop foi de 48 compassos pra 32 pros mesmos 88 segundos de música.
E depois eu deixei a T.O.E. como música padrão no lugar da Extended, então a única música em que eu não confiei no Claude agora é a que você só escuta se for procurar.
A parte do currículo#
Derrotar monstros desbloqueia memórias no Diário de carreira, 48 delas, desde duas semanas limpando dados de restaurante no Dreamweaver no meu primeiro emprego até a Studocu e o Musclog. E como isso é um currículo, o jogo não pode inventar nada. O arquivo do diário só diz qual pedaço do meu portfólio cada memória mostra, mais um título:
{"id": "studocu-cookies", "kind": "work", "source": "studocu", "highlight": 2, "match": "Made Laravel and Next.js read and write", "title": {"en": "One session, two frameworks", "pt-br": "Uma sessão, dois frameworks"}, "major": true}A empresa, as datas, as tags, o link e o próprio texto vêm do mesmo portfolio.json da minha página de portfólio, no idioma da página, então o jogo não consegue dizer nada que o portfólio não diga. O match é o começo do texto em inglês, e se eu editar ou reordenar uma linha do portfólio, o build falha em vez de publicar uma memória com um título que não combina mais:
else if (locale === "en" && !found.description.startsWith(ref.match)) {
problems.push(`${where}: the portfolio text no longer starts with "${ref.match}" (it starts with "${found.description.slice(0, 40)}")`);
}Os chefes soltam as major primeiro. Você também pega moedas pelo caminho, e as moedas compram memórias na Loja de memórias, 20 moedas cada, que é mais ou menos o que uma partida decente rende. Você escolhe uma parte da carreira (trabalho, projetos ou reconhecimento) e ganha uma memória bloqueada aleatória dela, então uma compra continua sendo surpresa e lutar continua sendo o jeito principal de conseguir memórias:
export const MEMORY_PRICE = 20;
export function buyMemory(data: SaveData, entries: readonly ShopEntry[], category: CareerKind, rng: Rng): { data: SaveData; id: string } | null {
if (data.wallet < MEMORY_PRICE) return null;
const have = new Set(data.found);
const pool = entries.filter((entry) => entry.category === category && !have.has(entry.id));
if (pool.length === 0) return null;
const id = rng.pick(pool).id;
return { data: { ...data, wallet: data.wallet - MEMORY_PRICE, found: [...data.found, id] }, id };
}É uma página estática igual ao resto desse site, então não tem backend, e o seu progresso fica salvo no localStorage.
Memória achada no meio da luta, e o Diário de carreira depois da partida: 5 de 48
E pra quem tá recrutando e não quer jogar de jeito nenhum, a primeira tela diz “Ler um monte de texto é chato mesmo.” e tem um botão escrito “Não, me leva pro portfólio”.
A primeira coisa que aparece pra quem joga pela primeira vez, depois da logo
Splash screen#
Os meus jogos precisavam de uma splash screen, e uma splash screen precisa de uma logo, e eu não tenho uma, então eu pedi pro Gemini algo chamado GNAF, sigla de Games Nobody Asked For, ou “jogos que ninguém pediu” (eu só precisava que parecesse sério). O que veio foi um PNG, e o problema de um PNG do Gemini é que ele é um PNG: bordas borradas, um ciano e um verde-limão que não existem em nenhum outro lugar do meu site, e zero chance de ficar nítido num monitor 4K. Eu cortei ele pra 1198x603, só as letras e o slogan, e esse corte foi o que o Claude vetorizou.
O Claude vetorizou com o potrace (o pacote potracer do Python), numa cópia aumentada 3x
A vetorização transformou ele num SVG: o G e o slogan saíram como curvas, e o N, o A e o F saíram como polígonos de lados retos, porque eles são polígonos de lados retos. No final ficaram quatro paths, um por cor, usando fill-rule="evenodd" pros buracos do G e do A continuarem sendo buracos. Aí eu troquei as cores pela paleta que eu já uso (#8c9eff índigo, #eeff41 limão, #f5f5f5 branco, num fundo #212121) pra logo combinar com o resto do site em vez de parecer que veio de outro lugar, e veio mesmo. O negócio todo tem 18KB, escala pro tamanho que eu quiser, e você pode ver a versão final em gnaf-logo.svg, ou só abrir um dos meus jogos, porque é a primeira coisa que aparece (por uns 2,5 segundos agora, já que antes ela ficava tão pouco tempo na tela que mal dava pra ler).
A versão vetorizada, com as cores trocadas pra combinar com o site
Conclusão#
Dali pra frente foi só ajustar umas coisas aqui e ali, e no histórico do git “aqui e ali” quer dizer poças de veneno, uma animação nova de andar, jogar tudo só com o teclado e a splash screen, tudo no mesmo dia.
Eu queria ver até onde a IA tinha chegado, e ela chegou longe o bastante pra que a única parte em que eu não confiei nela eu acabei entregando depois da primeira música mesmo assim. Enquanto isso, o Gotinha original nem tá mais na Google Play, porque eu tinha que atualizar ele e não atualizei.
O código tá fechado por enquanto, por isso esse post tem tanto código. Você pode jogar Meu corpo é um Tempo aqui.