GOALHEAD ⚽

Game effect para TikTok Effect House, tema Copa 2026: o usuário controla a
cabeça pra cabecear a bola que cai. Cada cabeçada vale ponto, a bola acelera,
e no fim mostra o placar — formato competitivo feito pra viralizar ("consegue
bater meu recorde?"). Inclui uma transformação (seleção sorteada: nome +
bandeira na tela) pra encaixar no sub-challenge certo.

Repo: https://github.com/kodama1/goalhead (privado)
Local: ~/goalhead (Mac do Marcus)
Ferramenta: TikTok Effect House (app desktop, já instalado)
Alvo: Game Effect Challenge → sub-challenge Avatar & Transformation
(tema oficial "big event buzz" = Copa). Prazo 2026-07-09. Prêmio US$100–1.000.

Mecânica

Toca a tela → sorteia 1 das 48 seleções, mostra nome + bandeira, liga a
transformação (tinta + camisa) e começa.
Bola cai do topo. Usuário move a cabeça pra alinhar e cabecear.
Cada cabeçada: +1, bola acelera e cai de um X aleatório.
Errou (bola passou da cabeça) → game over com o placar. Toca → reinicia.

Estrutura do repo

scripts/GoalheadGame.ts   # lógica (Script Component TS, classe FootyHeaderGame)
assets/ball.png           # bola transparente (Wikimedia, domínio público)
assets/flags/*.png        # 48 bandeiras da Copa (flagcdn.com, 320px)
ASSETS.md                 # fontes dos assets + o que falta
archive/LooksmaxScore.ts  # experimento anterior (filtro looksmax — pivotado)

Como o script liga na cena (Inspector)

ballObj, faceTrackerObj, scoreTextObj, hintTextObj, teamTextObj
facePaintObj, jerseyObj (ligam ao começar = transformação)
flagImageObj (Image) + flagTextures[] — 48 texturas na MESMA ORDEM do
array TEAMS (idx 0=brazil, 1=argentina, 2=colombia ... 47=new-zealand). O
comentário no script mapeia índice → arquivo.
Calibrar no preview: HEAD_Y, TOP_Y/BOTTOM_Y, X_MIN/X_MAX, CATCH_X,
invertHeadX.

Decisões / contexto

Pivot: começou como clone do MOGGED (moggedupapp.com) — filtro looksmax
que dá nota PSL ao rosto. Virou game de futebol da Copa pra mirar o challenge.
Filtro do TikTok = sandbox sem internet: NÃO dá pra chamar IA/agente externo
em tempo real dentro do efeito. Score "de IA real" só num app/web separado.
Looksmax on-device era viável via os 106 keypoints faciais do Face Info
(geometria real determinística: simetria, jawline, terços) — guardado em
archive/LooksmaxScore.ts caso vire app/funil depois.
Política TikTok: efeitos que julgam beleza/atratividade são rejeitados →
tem que ser "game/diversão". Game de cabeçada passa limpo.

Monetização (estudado)

Effect Creator Rewards: categoria Game & Randomizer = menor limiar
(2.000 vídeos únicos pra começar a pagar). Máx US$14k/efeito, US$50k/mês.
Precisa qualificar antes (badge Gold+, 5 efeitos, 3 com 1.000+ vídeos).
RPM baixo pra público BR → filtro sozinho paga pouco com audiência brasileira.
Onde está o dinheiro de verdade: filtro grátis como ISCA → funil pra app
pago por assinatura (modelo MOGGED). Filtro = topo de funil.

Gotchas aprendidos

Wikimedia thumbnails: rejeita larguras fora da lista padrão
(20,40,60,120,250,330,500,960,1280,1920,3840) e bloqueia curl sem User-Agent.
→ Trocado por flagcdn.com (por código ISO, ex.: /w320/br.png).
zsh não faz word-splitting de $var sem aspas (≠ bash) → loop de download
rodou 1x só. Solução: printf '%s\n' ... | while IFS=: read -r ....
Bloom sem créditos (workspace pessoal e "Marcus's Team" = 0) → geração de
imagem por IA travada; usados assets CC0/domínio público.
Códigos especiais flagcdn: Inglaterra=gb-eng, Escócia=gb-sct.

A verificar na API do Effect House (não confirmado)

getHeadX(): acessor da posição da cabeça (Face Info → Center Position).
setFlag(): propriedade de textura do Image (.texture ou material.mainTexture).
Acesso aos 106 keypoints (caso retome o looksmax).

Próximos passos

Montar a cena no Effect House e ligar tudo no Inspector (48 bandeiras na ordem).
Faltam assets: camisa (jersey) e fundo de estádio (+ tinta facial por seleção).
Calibrar coordenadas no preview e testar no celular (QR code).
Publicar selecionando Avatar & Transformation antes de 2026-07-09.

Relacionado: projects/mimic/ (TikTok-driven) · projects/kodama-ai/ (TikTok-driven) · memory/MEMORY