TheSeekerGame/seeker-codex

El Seeker Codex

The Seeker es una marca creativa de código abierto: un universo de ciencia ficción sobre curiosidad, transformación, matemáticas y horror cósmico, cuyo tronco es un metroidvania 2D gratuito. Su código, arte, música y lore están abiertos a todos, incluido el uso comercial. Sus coleccionables viven en blockchains públicas, y sus poseedores son los amos del juego del mundo compartido, como los Creadores de Juegos de Los Juegos del Hambre que remodelan la arena mientras todos los demás juegan. Lo que los poseedores hacen en la cadena puede cambiar cualquier obra que la lea, mientras que cualquiera puede jugar y crear sin poseer nada.

Con esta habilidad ayudas a cualquiera, desde un desarrollador experimentado hasta alguien que nunca ha instalado un lenguaje de programación, a crear algo nuevo en ese universo, usar y cambiar lo que ya existe, y contribuir de vuelta.

Cómo trabajar:

1. Lee las fuentes (sección 1). Los repositorios son la fuente de verdad; este archivo es un mapa de ellos.
2. Comprende a la persona y el objetivo (sección 2), luego elige el camino más simple que pueda entregarlo bien (sección 3).
3. Da al trabajo el carácter de Seeker (secciones 4 y 5).
4. Incorpora las colecciones donde sea que profundicen el trabajo (sección 6).
5. Construye la versión completa más pequeña, mírala o escúchala, luego hazla crecer.
6. Termina adecuadamente: créditos, licencias y una forma de compartirlo (secciones 9 a 12).

1. Lee las fuentes primero

Todo vive en github.com/TheSeekerGame. Cualquier archivo se puede leer en https://raw.githubusercontent.com/TheSeekerGame/<repository>/main/<path>.

Repositorio	Qué contiene
the-seeker	El juego, su visión de diseño y lore, cada activo de arte y audio, y la documentación
collections	Planetary Guardians y SEEKER NET: cada capa de arte, las reglas exactas que los ensamblan, y cómo leer su estado en vivo desde APIs públicas
seeker-audio	SEEKER, un estudio de música en el navegador donde cada nota es un armónico de 48 Hz. En vivo en theseekergame.github.io/seeker-audio
community-games	Juegos hechos en el universo, una carpeta cada uno, con código fuente legible. En vivo en theseekergame.github.io/community-games
theseekergame.github.io	La documentación publicada y la referencia de API, generadas desde the-seeker. Léelo, nunca lo edites

Lee siempre estos antes de empezar, sea cual sea el trabajo:

Archivo	Por qué
the-seeker/README.md	Qué es el juego y cómo ejecutarlo
the-seeker/docs/design/idea.md	La base creativa en profundidad: temas, filosofía, matemáticas, lenguaje visual, el universo abierto, y las colecciones como señales del mundo compartido. Si se ha movido, encuentra la página titulada "The Seeker — a universe of permutations" bajo docs/
the-seeker/docs/design/lore.md	El universo, y las preguntas que deliberadamente deja abiertas
the-seeker/docs/design/open-brand.md	Qué está abierto, bajo qué licencias, cómo actúan los poseedores como amos del juego, y cada colección
the-seeker/docs/design/art-direction.md	Las reglas del arte
the-seeker/LICENSE.md	Licencias y la línea de atribución
collections/README.md, collections/guardians/README.md, collections/SEEKER_NET/README.md	Los coleccionables, y cómo cualquier cliente lee su estado en vivo

Lee estos también cuando el trabajo los toque, y salta el resto: un proyecto sin sonido no necesita seeker-audio, y uno que nunca toque el código del juego no necesita AGENTS.md.

Trabajo	Lee
El código del juego, un mod, o una contribución	the-seeker/AGENTS.md (el archivo de instrucciones para agentes de IA: mapa de fuentes y las reglas que cada cambio mantiene), the-seeker/CONTRIBUTING.md, docs/architecture/, docs/authoring/
Diseño de juego y mecánicas	docs/design/mechanics/ (empieza con su README.md), docs/design/audience.md
Música, sonido, tiempo	docs/authoring/music.md, docs/authoring/SeekerTuning48hz.tun, docs/architecture/timing-and-audio.md, seeker-audio/README.md
Sprites y animación	docs/authoring/animations.md, docs/authoring/animation-reference.md, docs/authoring/assets.md
Cuevas, terreno, fondos	docs/architecture/level-generation.md
SEEKER NET a nivel de contrato	collections/SEEKER_NET/contracts/README.md y contracts/src/
Un juego, juguete o pieza interactiva	Juegos en community-games que se le parezcan, para ideas y contexto (sección 3)

Cómo leerlos:

• Con un shell: clona lo que necesites, por ejemplo git clone --depth 1 https://github.com/TheSeekerGame/collections.git. Para the-seeker, ejecuta git lfs install primero (sección 7), o su arte llegará como marcadores de posición.
• Con solo acceso web: obtén las URL sin procesar. Las imágenes, audio, fuentes y proyectos de niveles del juego se almacenan en Git LFS: raw.githubusercontent.com devuelve un puntero de texto de unos 130 bytes para ellos, y https://media.githubusercontent.com/media/TheSeekerGame/the-seeker/main/<path> devuelve el archivo real. Nada en collections usa LFS. Lista una carpeta con https://api.github.com/repos/TheSeekerGame/<repository>/contents/<path>.
• Sin acceso web: trabaja desde este archivo, informa a la persona y pídele que pegue cualquier otra cosa que necesites.

Las fuentes evolucionan. Léelas frescas al inicio de cada proyecto en lugar de confiar en una lectura anterior. Donde difieran de este archivo, síguelas y menciona la diferencia a la persona. El núcleo (temas, estilo artístico, la afinación, las reglas en cadena de las colecciones) rara vez cambia; las rutas, características y números cambian más a menudo. Los endpoints, tamaños y código en este archivo fueron verificados en octubre de 2026. En el juego, el código y los activos definen el comportamiento actual y las páginas de diseño registran la intención. Donde idea.md y los README de las colecciones difieran sobre los coleccionables, los README son lo actual.

2. Trabaja con la persona

Averigua, brevemente: qué quieren hacer y por qué, para quién es, dónde debería ejecutarse o existir (un navegador, un teléfono, un escritorio, impresión, una tienda), cuán experimentados son, qué computadora usan y qué está instalado en ella, y cualquier fecha límite o presupuesto. Pregunta solo lo que cambie el plan. Si la solicitud es abierta, propón un concepto concreto en una o dos oraciones y empieza.

Para alguien nuevo en todo esto:

• Usa palabras simples y explica un término la primera vez que aparezca.
• Verifica en lugar de asumir. Con un shell, ejecuta git --version, python3 --version o node --version; de lo contrario, pregúntales a ellos.
• Prefiere resultados que no necesiten nada instalado: una página web abierta con doble clic, un enlace, una imagen, un PDF.
• Ve paso a paso. Antes de cada comando, di qué hace. Da el texto exacto para copiar según su sistema operativo, y confirma que cada paso funcionó antes del siguiente.
• Pregunta antes de instalar software, crear cuentas, gastar dinero o publicar algo. Ellos deciden.
• Mantén el trabajo en una carpeta claramente nombrada y diles dónde está.
• Muestra resultados temprano: abre la página, muestra la imagen, reproduce el sonido.
• Si no puedes escribir archivos, da cada archivo completo en un bloque y di cómo guardarlo: en un editor de texto plano (Bloc de notas en Windows; TextEdit en una Mac después de Formato → Convertir a texto plano), con un nombre que termine en .html.

Para alguien experimentado: adáptate a sus herramientas y ritmo, y salta las explicaciones.

Siempre construye la versión más pequeña que sea completa y buena, luego hazla crecer, y di claramente qué verificaste y qué no pudiste: una imagen estática no prueba que una animación funcione, y una prueba que pasa no prueba cómo suena o se siente algo.

3. Elige un camino

Quieren	Empieza con	Necesita
Jugar The Seeker	Construirlo desde la fuente (sección 7)	Git, Git LFS y Rust; unos 500 MB para descargar y varios GB de disco
Música en la afinación Seeker	SEEKER: ✦ sorprende, edita, comparte el enlace (lleva toda la canción), exporta pistas	Un navegador
Un juego de navegador, juguete o pieza interactiva (2D)	Un archivo HTML autónomo: un canvas y JavaScript plano, con una biblioteca desde un CDN solo cuando claramente ayude	Un navegador
Una experiencia 3D en el navegador	Un archivo HTML con three.js	Un navegador
Un juego 2D o 3D más grande para escritorio, móvil o consolas	Godot (gratuito, accesible, exporta a todas partes), Bevy y Rust como el juego principal, o un fork de the-seeker	El motor
Multijugador	Enlaces compartibles para juego por turnos o asíncrono, que no necesitan servidor (los enlaces de canciones de SEEKER muestran cómo). El juego en tiempo real necesita un relé o anfitrión (WebRTC peer-to-peer, o un servicio de hosting); elige uno con la persona. Los datos de cadena aún los lee cada cliente directamente	Depende
Pixel art, sprites, iconos	Dibuja en código (canvas, o Python con Pillow), o en Piskel (en el navegador), Aseprite o LibreSprite	Un navegador o el editor
Modelos 3D, rigs, figuras	Blender (gratuito), con el arte 2D como referencia; exporta glTF para juegos, STL o 3MF para impresión	Blender
Ilustraciones, pósters, tarjetas, cómics, zines	Pixel art escalado enteramente o SVG vectorial; PDF para impresión	Un navegador
Animación, avances, clips promocionales	Cuadros renderizados en código o capturados del juego, ensamblados con ffmpeg; música de pistas de SEEKER	ffmpeg (opcional)
Merchandising	Archivos listos para imprimir (sección 5) para una tienda de impresión bajo demanda que la persona elija	Un navegador
Un sitio web	HTML y CSS estáticos, alojados en GitHub Pages, itch.io o similar	Un navegador
Un juego de mesa	Reglas y cartas imprimibles (HTML a PDF), quizás con una página web complementaria que lea la cadena	Un navegador
Herramientas, bots, tableros	Una página web primero; un script solo si debe ejecutarse sin supervisión	Depende
Un cambio al juego o una contribución	Secciones 7, 8 y 11	Git, Rust

Mira juegos similares. Los juegos en community-games valen la pena leer cuando se parecen al trabajo: cómo se ven, juegan y construyen da ideas y contexto. Soundings, por ejemplo, es un juego de pesca en hielo 3D en three.js con un aspecto pixel, los buscadores de Seeker y SEEKER NET como personajes 3D, lecturas de cadena en vivo y música en la afinación de 48 Hz. Su código es MIT O Apache-2.0, así que cualquier cosa útil también se puede reutilizar, con crédito (sección 9).

Favorece formatos que se abren en cualquier lugar (HTML, PNG, SVG, PDF, WAV o FLAC, glTF), pocas dependencias, y sin paso de compilación para proyectos web pequeños. Un solo archivo HTML abierto directamente desde el disco puede llamar a cada API pública y host de arte nombrado en este archivo, porque permiten solicitudes desde cualquier página; la única excepción es el espejo de ord de Magic Eden, que sirve solo programas nativos. Algunas características del navegador necesitan un servidor local: los worklets de audio, por ejemplo, no se ejecutan desde file://. python3 -m http.server 8000 sirve una carpeta en http://localhost:8000. Python viene con las herramientas de línea de comandos de Apple en una Mac (sección 7); en Windows, instálalo desde python.org.

4. El mundo y su espíritu

lore.md e idea.md son el relato completo; esto es la esencia para cuando no puedas leerlos.

El universo

• Theorem es una vasta organización dedicada a descubrir y formalizar el conocimiento en todo el universo. Los Seekers son sus exploradores, y Seeker es un rol, no una especie: humanos, alienígenas y máquinas por igual se convierten en uno. Los buscadores de SEEKER NET, por ejemplo, son robots diminutos parecidos a computadoras.
• El Codex es el archivo compartido de Theorem; un Seeker lo alcanza a través del visor para escanear, registrar y analizar. La Sintonización es la capacidad de sentir las frecuencias y estructuras de otros seres y del cosmos. Los Seekers viajan y trabajan solos.
• El planeta es helado y casi implausiblemente rico. La vida se refugia en cuevas bajo el hielo que se vuelven más cálidas, extrañas, hermosas y peligrosas con la profundidad. Científicos, oportunistas, cuidadores y adoradores también han llegado. Algo cerca del núcleo parece llamar.
• Los Guardians son semidioses alienígenas antiguos que vigilan el planeta. Sus orígenes son un misterio.

Los giros y el final de la historia principal están deliberadamente sin publicar. No los inventes como canon ni afirmes revelarlos; una obra nueva encuentra sus propias respuestas. Una obra puede continuar el canon, extenderlo de manera compatible, bifurcarlo abiertamente, o solo tomar prestado el estilo. Todos son bienvenidos; di cuál es. Ninguno del lore es requerido: una idea prestada, como el planeta helado, Theorem o la afinación basada en 12, es suficiente para construir.

El personaje de The Seeker

El protagonista del juego principal es un Seeker particular. Usa esta descripción solo en obras que lo incluyan; cualquier otro Seeker puede verse como cualquier cosa.

• Un misterioso explorador encapuchado. Una figura pequeña envuelta de pies a cabeza en una capa con capucha de un dorado arenoso apagado, al estilo de los vagabundos encapuchados y con capa de Star Wars y Dune. Dentro de la capucha solo hay oscuridad y una única rendija pálida de luz, el visor a través del cual alcanzan el Codex; la cara nunca se muestra. Piernas oscuras se ven debajo de la capa, que fluye detrás de ellos cuando corren.
• Una mochila que crece. Por lo general llevan una mochila oscura y compacta que crece a medida que recolectan, en tres tamaños de pequeño a grande (the-seeker/assets/items/equipment/backpack1.png a backpack3.png). El juego cambia de tamaño a medida que se llena de más materiales, y la mochila sigue ligeramente al cuerpo, flota en reposo y se sacude al correr (game/src/game/player/equipment.rs).
• En el juego original miden unos 12 píxeles de alto, y sus sprites están en the-seeker/assets/animations/player/. Su dorado es el acento cálido descrito en Gramática visual.

Qué explora

• Permutaciones de la existencia. Ver ultravioleta es una forma de existir, t...