Crumple: Criando uma biblioteca WebGL2 procedural de papel amassado do zero
Publicado originalmente no LinkedIn em 02/11/2026.
Eu só precisava de um papel amassado para o meu jogo. Não achei nada pronto que entregasse física convincente sem arrastar gigabytes de dependências. Então criei uma biblioteca do zero, 100% procedural.
Durante o desenvolvimento de Memory Apartment (meu jogo de terror psicológico e investigação), esbarrei em um detalhe essencial de imersão: o jogador precisa interagir com bilhetes no chão, memorandos velhos, recibos térmicos e cartas que contam os segredos do Edifício Primavera.
O desafio de imersão no Memory Apartment
Eu não queria uma textura 2D estática nem uma animação pré-renderizada rígida. Queria que o papel parecesse físico: voasse até o centro da tela, reagisse à luz ambiente e se desdobrasse diante do jogador.
Se o jogador puder notar que o papel é só um plano com textura colada, a sensação de mistério se desfaz no mesmo instante.
Ao pesquisar o ecossistema, não encontrei nenhuma biblioteca web que unisse deformação geométrica procedural, interação por toque/mouse e áudio físico sem exigir Three.js completo ou frameworks pesados. A solução foi construir o Crumple: uma biblioteca WebGL2 generativa, pesando menos de 37 KB (gzip) e com zero dependências externas.
Instalação e uso rápido
O projeto foi empacotado para uso imediato tanto em aplicações WebGL dedicadas quanto integrado diretamente ao DOM de sites modernos:
# Instalação via NPM
npm install @devandreotti/crumple
import { CrumpleScene } from '@devandreotti/crumple';
// Inicializa o papel sobre um container existente
const paper = new CrumpleScene({
target: document.querySelector('#documento'),
type: 'carta_1998',
wear: ['coffee', 'creased'],
interactive: true,
});
Arquitetura Procedural e Shaders GLSL
Toda a geometria e os relevos do papel são calculados em tempo de execução através de vertex e fragment shaders customizados:
- 100% Generativo por Seed: A malha de polígonos, os vincos principais e as microdeformações utilizam funções analíticas de ruído. Passando a mesma seed, o padrão exato de amassado é reproduzido deterministicamente;
- 10 Presets de Papel: Folha datilografada, papel pautado de caderno escolar, formulário contínuo de impressora matricial, cupom fiscal térmico, foto instantânea, blueprint cianótipo, cartão perfurado IBM e envelope selado;
- 14 Estados de Desgaste Físico: Queimaduras com bordas carbonizadas, manchas de café, marcas de água, vinho, fita adesiva amarelada e carimbos de tinta envelhecida;
- Interatividade Completa: Arraste para desdobrar, virada de folha em 3D (frente e verso), queima interativa e revelação de tinta invisível reagindo à luz do cursor.
Áudio Sintetizado com Web Audio API
Para manter a biblioteca leve e evitar o download de arquivos .mp3 ou .wav externos, todos os efeitos sonoros de papel farfalhando, estalando e queimando são gerados sinteticamente em tempo real:
- Síntese de ruído rosa filtrado por modelagem física (filtro de pico em 420 Hz);
- Envelope dinâmico modulado pela velocidade angular do desdobramento da malha;
- Zero requisições de rede para assets de áudio.
O projeto está publicado no NPM sob @devandreotti/crumple, com código aberto no GitHub e demonstração no Playground interativo.
Mídia da publicação
