TheSeekerGame/seeker-codex

The Seeker Codex

The Seeker é uma marca criativa open-source: um universo de ficção científica sobre curiosidade, transformação, matemática e horror cósmico, cujo tronco é um metroidvania 2D gratuito. Seu código, arte, música e lore estão abertos a todos, incluindo uso comercial. Seus colecionáveis vivem em blockchains públicas, e seus detentores são os mestres do jogo do mundo compartilhado, como os Criadores de Jogos de The Hunger Games remodelando a arena enquanto todos os outros jogam. O que os detentores fazem na cadeia pode mudar todo trabalho que a lê, enquanto qualquer um pode jogar e criar sem possuir nada.

Com esta habilidade você ajuda qualquer pessoa, desde um desenvolvedor experiente até alguém que nunca instalou uma linguagem de programação, a fazer algo novo nesse universo, usar e mudar o que já existe, e contribuir de volta.

Como trabalhar:

1. Leia as fontes (seção 1). Os repositórios são a fonte da verdade; este arquivo é um mapa deles.
2. Entenda a pessoa e o objetivo (seção 2), depois escolha o caminho mais simples que possa entregá-lo bem (seção 3).
3. Dê ao trabalho o caráter do Seeker (seções 4 e 5).
4. Traga as coleções sempre que aprofundarem o trabalho (seção 6).
5. Construa a menor versão completa, olhe ou ouça, depois cresça.
6. Finalize adequadamente: créditos, licenças e uma maneira de compartilhar (seções 9 a 12).

1. Leia as fontes primeiro

Tudo vive em github.com/TheSeekerGame. Qualquer arquivo pode ser lido em https://raw.githubusercontent.com/TheSeekerGame/<repository>/main/<path>.

Repositório	O que contém
the-seeker	O jogo, sua visão de design e lore, todos os ativos de arte e áudio, e a documentação
collections	Planetary Guardians e SEEKER NET: todas as camadas de arte, as regras exatas que as montam e como ler seu estado ao vivo de APIs públicas
seeker-audio	SEEKER, um estúdio de música no navegador onde cada nota é um harmônico de 48 Hz. Ao vivo em theseekergame.github.io/seeker-audio
community-games	Jogos feitos no universo, uma pasta cada, com fonte legível. Ao vivo em theseekergame.github.io/community-games
theseekergame.github.io	A documentação publicada e a referência da API, geradas de the-seeker. Leia, nunca edite

Sempre leia estes antes de começar, qualquer que seja o trabalho:

Arquivo	Por quê
the-seeker/README.md	O que é o jogo e como executá-lo
the-seeker/docs/design/idea.md	A base criativa em profundidade: temas, filosofia, matemática, linguagem visual, o universo aberto e as coleções como sinais do mundo compartilhado. Se tiver sido movido, encontre a página intitulada "The Seeker — a universe of permutations" sob docs/
the-seeker/docs/design/lore.md	O universo e as questões que deliberadamente deixa em aberto
the-seeker/docs/design/open-brand.md	O que está aberto, sob quais licenças, como os detentores atuam como mestres do jogo e cada coleção
the-seeker/docs/design/art-direction.md	As regras da arte
the-seeker/LICENSE.md	Licenças e a linha de atribuição
collections/README.md, collections/guardians/README.md, collections/SEEKER_NET/README.md	Os colecionáveis e como qualquer cliente lê seu estado ao vivo

Leia estes também quando o trabalho os tocar, e pule o resto: um projeto sem som não precisa de seeker-audio, e um que nunca toca no código do jogo não precisa de AGENTS.md.

Trabalho	Leia
O código do jogo, uma modificação ou uma contribuição	the-seeker/AGENTS.md (o arquivo de instruções para agentes de IA: mapa da fonte e as regras que cada mudança mantém), the-seeker/CONTRIBUTING.md, docs/architecture/, docs/authoring/
Design de jogo e mecânicas	docs/design/mechanics/ (comece com seu README.md), docs/design/audience.md
Música, som, timing	docs/authoring/music.md, docs/authoring/SeekerTuning48hz.tun, docs/architecture/timing-and-audio.md, seeker-audio/README.md
Sprites e animação	docs/authoring/animations.md, docs/authoring/animation-reference.md, docs/authoring/assets.md
Cavernas, terreno, fundos	docs/architecture/level-generation.md
SEEKER NET no nível do contrato	collections/SEEKER_NET/contracts/README.md e contracts/src/
Um jogo, brinquedo ou peça interativa	Jogos em community-games que se assemelham, para ideias e contexto (seção 3)

Como lê-los:

• Com um shell: clone o que precisa, por exemplo git clone --depth 1 https://github.com/TheSeekerGame/collections.git. Para the-seeker, execute git lfs install primeiro (seção 7), ou sua arte chega como placeholders.
• Com acesso apenas à web: busque as URLs raw. As imagens, áudio, fontes e projetos de nível do jogo são armazenados em Git LFS: raw.githubusercontent.com retorna um ponteiro de texto de cerca de 130 bytes para eles, e https://media.githubusercontent.com/media/TheSeekerGame/the-seeker/main/<path> retorna o arquivo real. Nada em collections usa LFS. Liste uma pasta com https://api.github.com/repos/TheSeekerGame/<repository>/contents/<path>.
• Sem acesso à web: trabalhe a partir deste arquivo, informe a pessoa e peça que cole o que mais precisar.

As fontes evoluem. Leia-as frescas no início de cada projeto em vez de confiar em uma leitura anterior. Onde elas discordarem deste arquivo, siga-as e mencione a diferença à pessoa. O núcleo (temas, estilo de arte, a afinação, as regras on-chain das coleções) raramente muda; caminhos, recursos e números mudam com mais frequência. Os endpoints, tamanhos e código neste arquivo foram verificados em outubro de 2026. No jogo, código e ativos definem o comportamento atual e as páginas de design registram a intenção. Onde idea.md e os READMEs das coleções diferirem sobre os colecionáveis, os READMEs são atuais.

2. Trabalhe com a pessoa

Descubra, brevemente: o que querem fazer e por quê, para quem é, onde deve rodar ou existir (navegador, celular, desktop, impressão, loja), quão experientes são, qual computador usam e o que está instalado nele, e qualquer prazo ou orçamento. Pergunte apenas o que muda o plano. Se o pedido for aberto, proponha um conceito concreto em uma ou duas frases e comece.

Para alguém novo em tudo isso:

• Use palavras simples e explique um termo na primeira vez que aparecer.
• Verifique em vez de presumir. Com um shell, execute git --version, python3 --version ou node --version; caso contrário, peça que o façam.
• Prefira resultados que não precisem de instalação: uma página web aberta com um duplo clique, um link, uma imagem, um PDF.
• Vá um passo de cada vez. Antes de cada comando, diga o que ele faz. Dê o texto exato a ser copiado para o sistema operacional deles e confirme que cada etapa funcionou antes da próxima.
• Pergunte antes de instalar software, criar contas, gastar dinheiro ou publicar qualquer coisa. Eles decidem.
• Mantenha o trabalho em uma pasta claramente nomeada e informe onde está.
• Mostre resultados cedo: abra a página, mostre a imagem, toque o som.
• Se não puder escrever arquivos, dê cada arquivo inteiro em um bloco e diga como salvá-lo: em um editor de texto simples (Bloco de Notas no Windows; TextEdit no Mac após Formatar → Fazer Texto Simples), com um nome terminando em .html.

Para alguém experiente: combine suas ferramentas e ritmo, e pule as explicações.

Sempre construa a menor versão que seja completa e boa, depois cresça, e diga claramente o que verificou e o que não pôde: uma imagem estática não prova que uma animação funciona, e um teste bem-sucedido não prova como algo soa ou parece.

3. Escolha um caminho

Eles querem	Comece com	Precisa de
Jogar The Seeker	Construa a partir da fonte (seção 7)	Git, Git LFS e Rust; cerca de 500 MB para baixar e vários GB de disco
Música na afinação Seeker	SEEKER: ✦ surpresa, edite, compartilhe o link (ele carrega a música inteira), exporte stems	Um navegador
Um jogo no navegador, brinquedo ou peça interativa (2D)	Um arquivo HTML autossuficiente: um canvas e JavaScript puro, com uma biblioteca de um CDN apenas quando claramente ajudar	Um navegador
Uma experiência 3D no navegador	Um arquivo HTML com three.js	Um navegador
Um jogo 2D ou 3D maior para desktop, celular ou consoles	Godot (gratuito, acessível, exporta para todos os lugares), Bevy e Rust como o jogo principal, ou um fork de the-seeker	O motor
Multijogador	Links compartilháveis para jogos baseados em turnos ou assíncronos, que não precisam de servidor (os links de música do SEEKER mostram como). Jogo em tempo real precisa de um relé ou host (WebRTC peer-to-peer ou um serviço de hospedagem); escolha um com a pessoa. Os dados da cadeia ainda são lidos por cada cliente diretamente	Depende
Pixel art, sprites, ícones	Desenhe em código (canvas, ou Python com Pillow), ou no Piskel (no navegador), Aseprite ou LibreSprite	Um navegador ou o editor
Modelos 3D, rigs, figuras	Blender (gratuito), com a arte 2D como referência; exporte glTF para jogos, STL ou 3MF para impressão	Blender
Ilustrações, pôsteres, cartas, quadrinhos, zines	Pixel art em escala inteira ou SVG vetorial; PDF para impressão	Um navegador
Animação, trailers, clipes promocionais	Quadros renderizados em código ou capturados do jogo, montados com ffmpeg; música de stems do SEEKER	ffmpeg (opcional)
Merch	Arquivos prontos para impressão (seção 5) para uma loja de impressão sob demanda escolhida pela pessoa	Um navegador
Um site	HTML e CSS estáticos, hospedados no GitHub Pages, itch.io ou similar	Um navegador
Um jogo de tabuleiro	Regras e cartas imprimíveis (HTML para PDF), talvez com uma página web companheira que leia a cadeia	Um navegador
Ferramentas, bots, painéis	Uma página web primeiro; um script apenas se precisar rodar sem supervisão	Depende
Uma mudança no jogo ou uma contribuição	Seções 7, 8 e 11	Git, Rust

Olhe para jogos semelhantes. Os jogos em community-games valem a pena ler quando se assemelham ao trabalho: como parecem, jogam e são construídos dá ideias e contexto. Soundings, por exemplo, é um jogo 3D de pesca no gelo em three.js com aparência pixelada, os seekers do Seeker e SEEKER NET como personagens 3D, leituras ao vivo da cadeia e música na afinação de 48 Hz. Seu código é MIT OU Apache-2.0, então qualquer coisa útil também pode ser reutilizada, com crédito (seção 9).

Prefira formatos que abrem em qualquer lugar (HTML, PNG, SVG, PDF, WAV ou FLAC, glTF), poucas dependências e nenhuma etapa de compilação para pequenos projetos web. Um único arquivo HTML aberto diretamente do disco pode chamar todas as APIs públicas e hosts de arte nomeados neste arquivo, porque eles permitem solicitações de qualquer página; a única exceção é o espelho de ordinais Magic Eden, que serve apenas programas nativos. Alguns recursos do navegador precisam de um servidor local: worklets de áudio, por exemplo, não rodam de file://. python3 -m http.server 8000 serve uma pasta em http://localhost:8000. Python vem com as ferramentas de linha de comando da Apple em um Mac (seção 7); no Windows, instale de python.org.

4. O mundo e seu espírito

lore.md e idea.md são o relato completo; esta é a essência para quando você não puder lê-los.

O universo

• Theorem é uma vasta organização dedicada a descobrir e formalizar conhecimento através do universo. Seekers (Buscadores) são seus exploradores, e Seeker é um papel, não uma espécie: humanos, alienígenas e máquinas igualmente se tornam um. Os seekers do SEEKER NET, por exemplo, são pequenos robôs computadorizados.
• O Codex é o arquivo compartilhado de Theorem; um Seeker o alcança através do visor para escanear, registrar e analisar. Sintonia é a capacidade de sentir as frequências e estruturas de outros seres e do cosmos. Seekers viajam e trabalham sozinhos.
• O planeta é gelado e quase implausivelmente rico. A vida se abriga em cavernas sob o gelo que se tornam mais quentes, mais estranhas, mais belas e mais perigosas com a profundidade. Cientistas, oportunistas, cuidadores e adoradores também vieram. Algo perto do núcleo parece chamar.
• Guardians (Guardiões) são antigos deuses alienígenas que vigiam o planeta. Suas origens são um mistério.

As reviravoltas e o final da história principal são deliberadamente não publicados. Não os invente como cânone nem afirme revelá-los; um novo trabalho encontra suas próprias respostas. Um trabalho pode continuar o cânone, estendê-lo de forma compatível, bifurcá-lo abertamente ou apenas emprestar o estilo. Todos são bem-vindos; diga qual é. Nenhum dos lore é obrigatório: uma ideia emprestada, como o planeta congelado, Theorem ou a afinação baseada em 12, é suficiente para construir.

O personagem Seeker

O protagonista do jogo principal é um Seeker específico. Use esta descrição apenas em trabalhos que o incluam; qualquer outro Seeker pode ter qualquer aparência.

• Um misterioso explorador encapuzado. Uma pequena figura envolta dos pés à cabeça em uma capa com capuz de um ouro arenoso e suave, no espírito dos andarilhos encapuzados e envoltos de Star Wars e Dune. Dentro do capuz há apenas escuridão e uma única fenda pálida de luz, o visor através do qual alcançam o Codex; o rosto nunca é mostrado. Pernas escuras aparecem sob a capa, que flui atrás deles quando correm.
• Uma mochila que cresce. Eles geralmente carregam uma mochila escura e compacta que cresce à medida que coletam, em três tamanhos de pequena a grande (the-seeker/assets/items/equipment/backpack1.png a backpack3.png). O jogo troca de tamanhos à medida que mais materiais a enchem, e a mochila segue o corpo ligeiramente, paira em repouso e balança enquanto corre (game/src/game/player/equipment.rs).
• No jogo original eles têm cerca de 12 pixels de altura, e seus sprites estão em the-seeker/assets/animations/player/. Seu ouro é o acento quente descrito na Gramática visual.

O que explora

• Permutações da existência. Ver ultravioleta é uma maneira de existir, tocar em...