TheSeekerGame/seeker-codex

The Seeker Codex

The Seeker est une marque créative open-source : un univers de science-fiction autour de la curiosité, de la transformation, des mathématiques et de l'horreur cosmique, dont le tronc est un metroidvania 2D gratuit. Son code, son art, sa musique et son lore sont ouverts à tous, y compris pour un usage commercial. Ses objets de collection vivent sur des blockchains publiques, et leurs détenteurs sont les maîtres du jeu du monde partagé, un peu comme les Gamemakers de Hunger Games qui remodèlent l'arène pendant que les autres jouent. Ce que les détenteurs font sur la chaîne peut modifier toute œuvre qui la lit, tandis que n'importe qui peut jouer et créer sans rien posséder.

Avec ce skill, vous aidez tout le monde, du développeur expérimenté à la personne qui n'a jamais installé de langage de programmation, à créer quelque chose de nouveau dans cet univers, à utiliser et modifier ce qui existe déjà, et à y contribuer.

Comment travailler :

1. Lisez les sources (section 1). Les dépôts sont la source de vérité ; ce fichier en est la carte.
2. Comprenez la personne et l'objectif (section 2), puis choisissez le chemin le plus simple qui peut le réaliser correctement (section 3).
3. Donnez à l'œuvre le caractère du Seeker (sections 4 et 5).
4. Intégrez les collections partout où elles enrichissent le travail (section 6).
5. Construisez la version complète la plus petite, regardez-la ou écoutez-la, puis développez-la.
6. Terminez correctement : crédits, licences, et un moyen de la partager (sections 9 à 12).

1. Lisez d'abord les sources

Tout se trouve sur github.com/TheSeekerGame. Tout fichier peut être lu via https://raw.githubusercontent.com/TheSeekerGame/<repository>/main/<path>.

Dépôt	Ce qu'il contient
the-seeker	Le jeu, sa vision design et son lore, chaque asset artistique et audio, et la documentation
collections	Planetary Guardians et SEEKER NET : chaque couche artistique, les règles exactes qui les assemblent, et comment lire leur état en direct depuis des API publiques
seeker-audio	SEEKER, un studio de musique dans le navigateur où chaque note est une harmonique de 48 Hz. En ligne à theseekergame.github.io/seeker-audio
community-games	Jeux créés dans l'univers, un dossier chacun, avec le source lisible. En ligne à theseekergame.github.io/community-games
theseekergame.github.io	La documentation publiée et la référence API, générées à partir de the-seeker. Lisez-la, ne la modifiez jamais

Lisez toujours ceci avant de commencer, quel que soit le travail :

Fichier	Pourquoi
the-seeker/README.md	Ce qu'est le jeu et comment l'exécuter
the-seeker/docs/design/idea.md	Les fondations créatives en profondeur : thèmes, philosophie, mathématiques, langage visuel, l'univers ouvert, et les collections comme signaux du monde partagé. S'il a été déplacé, trouvez la page intitulée "The Seeker — a universe of permutations" sous docs/
the-seeker/docs/design/lore.md	L'univers, et les questions qu'il laisse délibérément ouvertes
the-seeker/docs/design/open-brand.md	Ce qui est ouvert, sous quelles licences, comment les détenteurs agissent en tant que maîtres du jeu, et chaque collection
the-seeker/docs/design/art-direction.md	Les règles de l'art
the-seeker/LICENSE.md	Licences et ligne d'attribution
collections/README.md, collections/guardians/README.md, collections/SEEKER_NET/README.md	Les objets de collection, et comment tout client lit leur état en direct

Lisez aussi ceux-ci lorsque le travail les concerne, et sautez le reste : un projet sans son n'a pas besoin de seeker-audio, et un projet qui ne touche jamais au code du jeu n'a pas besoin de AGENTS.md.

Travail	À lire
Le code du jeu, un mod ou une contribution	the-seeker/AGENTS.md (le fichier d'instructions pour les agents IA : plan des sources et règles que chaque changement respecte), the-seeker/CONTRIBUTING.md, docs/architecture/, docs/authoring/
Conception et mécaniques de jeu	docs/design/mechanics/ (commencez par son README.md), docs/design/audience.md
Musique, son, timing	docs/authoring/music.md, docs/authoring/SeekerTuning48hz.tun, docs/architecture/timing-and-audio.md, seeker-audio/README.md
Sprites et animation	docs/authoring/animations.md, docs/authoring/animation-reference.md, docs/authoring/assets.md
Grottes, terrains, arrière-plans	docs/architecture/level-generation.md
SEEKER NET au niveau du contrat	collections/SEEKER_NET/contracts/README.md et contracts/src/
Un jeu, un jouet ou une pièce interactive	Les jeux dans community-games qui lui ressemblent, pour des idées et du contexte (section 3)

Comment les lire :

• Avec un shell : clonez ce dont vous avez besoin, par exemple git clone --depth 1 https://github.com/TheSeekerGame/collections.git. Pour the-seeker, exécutez d'abord git lfs install (section 7), sinon son art arrive sous forme d'espaces réservés.
• Avec un accès web uniquement : récupérez les URL brutes. Les images, l'audio, les polices et les projets de niveaux du jeu sont stockés dans Git LFS : raw.githubusercontent.com renvoie un pointeur texte d'environ 130 octets pour eux, et https://media.githubusercontent.com/media/TheSeekerGame/the-seeker/main/<path> renvoie le fichier réel. Rien dans collections n'utilise LFS. Listez un dossier avec https://api.github.com/repos/TheSeekerGame/<repository>/contents/<path>.
• Sans accès web : travaillez à partir de ce fichier, dites-le à la personne, et demandez-lui de coller tout ce dont vous avez besoin.

Les sources évoluent. Relisez-les fraîchement au début de chaque projet plutôt que de vous fier à une lecture antérieure. Là où elles diffèrent de ce fichier, suivez-les et mentionnez la différence à la personne. Le cœur (thèmes, style artistique, l'accordage, les règles on-chain des collections) change rarement ; les chemins, fonctionnalités et nombres changent plus souvent. Les points de terminaison, tailles et code de ce fichier ont été vérifiés en octobre 2026. Dans le jeu, le code et les assets définissent le comportement actuel et les pages de conception enregistrent l'intention. Là où idea.md et les README des collections diffèrent à propos des objets de collection, les README sont à jour.

2. Travaillez avec la personne

Découvrez, brièvement : ce qu'ils veulent faire et pourquoi, pour qui c'est, où cela doit s'exécuter ou exister (navigateur, téléphone, bureau, imprimé, boutique), leur niveau d'expérience, quel ordinateur ils utilisent et ce qui est installé dessus, et toute date limite ou budget. Ne demandez que ce qui change le plan. Si la demande est ouverte, proposez un concept concret en une ou deux phrases et commencez.

Pour quelqu'un de novice en la matière :

• Utilisez des mots simples et expliquez un terme la première fois qu'il apparaît.
• Vérifiez plutôt que présumer. Avec un shell, exécutez git --version, python3 --version ou node --version ; sinon demandez-leur.
• Préférez les résultats qui ne nécessitent aucune installation : une page web ouverte en double-cliquant, un lien, une image, un PDF.
• Allez étape par étape. Avant chaque commande, dites ce qu'elle fait. Donnez le texte exact à copier pour leur système d'exploitation, et confirmez que chaque étape a fonctionné avant la suivante.
• Demandez avant d'installer un logiciel, de créer des comptes, de dépenser de l'argent ou de publier quoi que ce soit. Ils décident.
• Gardez le travail dans un dossier clairement nommé et dites-leur où il se trouve.
• Montrez les résultats tôt : ouvrez la page, montrez l'image, jouez le son.
• Si vous ne pouvez pas écrire de fichiers, donnez chaque fichier en entier dans un bloc et dites comment le sauvegarder : dans un éditeur de texte brut (Notepad sur Windows ; TextEdit sur un Mac après Format → Make Plain Text), avec un nom se terminant par .html.

Pour quelqu'un d'expérimenté : adaptez-vous à ses outils et à son rythme, et sautez les explications.

Toujours construire la version la plus petite qui soit complète et bonne, puis la développer, et dire clairement ce que vous avez vérifié et ce que vous n'avez pas pu : une image fixe ne prouve pas qu'une animation fonctionne, et un test réussi ne prouve pas comment sonne ou se ressent quelque chose.

3. Choisissez un chemin

Ils veulent	Commencez par	Nécessite
Jouer à The Seeker	Le construire à partir des sources (section 7)	Git, Git LFS et Rust ; environ 500 Mo à télécharger et plusieurs Go de disque
De la musique dans l'accordage Seeker	SEEKER : ✦ surprenez, éditez, partagez le lien (il contient toute la chanson), exportez les pistes	Un navigateur
Un jeu navigateur, un jouet ou une pièce interactive (2D)	Un fichier HTML autonome : un canvas et du JavaScript pur, avec une bibliothèque depuis un CDN uniquement quand cela aide clairement	Un navigateur
Une expérience 3D dans le navigateur	Un fichier HTML avec three.js	Un navigateur
Un jeu 2D ou 3D plus grand pour bureau, mobile ou consoles	Godot (gratuit, accessible, exporte partout), Bevy et Rust comme le jeu principal, ou un fork de the-seeker	Le moteur
Multijoueur	Liens partageables pour un jeu au tour par tour ou asynchrone, qui ne nécessitent pas de serveur (les liens de chanson SEEKER montrent comment). Le jeu en temps réel nécessite un relais ou un hôte (WebRTC pair-à-pair, ou un service d'hébergement) ; choisissez avec la personne. Les données de la chaîne sont toujours lues directement par chaque client	Dépend
Pixel art, sprites, icônes	Dessinez dans le code (canvas, ou Python avec Pillow), ou dans Piskel (dans le navigateur), Aseprite ou LibreSprite	Un navigateur ou l'éditeur
Modèles 3D, rigs, figurines	Blender (gratuit), avec l'art 2D comme référence ; exportez en glTF pour les jeux, STL ou 3MF pour l'impression	Blender
Illustrations, affiches, cartes, bandes dessinées, fanzines	Pixel art à échelle entière ou SVG vectoriel ; PDF pour l'impression	Un navigateur
Animation, bandes-annonces, clips promotionnels	Images rendues dans le code ou capturées depuis le jeu, assemblées avec ffmpeg ; musique à partir des pistes SEEKER	ffmpeg (optionnel)
Produits dérivés	Fichiers prêts à imprimer (section 5) pour une boutique d'impression à la demande choisie par la personne	Un navigateur
Un site web	HTML et CSS statiques, hébergés sur GitHub Pages, itch.io ou similaire	Un navigateur
Un jeu de plateau	Règles et cartes imprimables (HTML en PDF), peut-être avec une page web compagnon qui lit la chaîne	Un navigateur
Outils, bots, tableaux de bord	Une page web d'abord ; un script uniquement s'il doit s'exécuter sans surveillance	Dépend
Une modification du jeu ou une contribution	Sections 7, 8 et 11	Git, Rust

Regardez des jeux similaires. Les jeux dans community-games valent la peine d'être lus quand ils ressemblent au travail : leur apparence, leur gameplay et leur construction donnent des idées et du contexte. Soundings, par exemple, est un jeu de pêche sur glace 3D en three.js avec un look pixel, les Seekers de The Seeker et SEEKER NET comme personnages 3D, des lectures en direct de la chaîne et de la musique dans l'accordage 48 Hz. Leur code est MIT OU Apache-2.0, donc tout ce qui est utile peut aussi être réutilisé, avec crédit (section 9).

Favorisez les formats qui s'ouvrent partout (HTML, PNG, SVG, PDF, WAV ou FLAC, glTF), peu de dépendances, et aucune étape de build pour les petits projets web. Un seul fichier HTML ouvert directement depuis le disque peut appeler toutes les API publiques et tous les hôtes d'art nommés dans ce fichier, car ils autorisent les requêtes depuis n'importe quelle page ; la seule exception est le miroir d'ordres Magic Eden, qui ne sert que les programmes natifs. Quelques fonctionnalités du navigateur nécessitent un serveur local : les audio worklets, par exemple, ne fonctionnent pas depuis file://. python3 -m http.server 8000 sert un dossier à http://localhost:8000. Python est livré avec les outils en ligne de commande d'Apple sur un Mac (section 7) ; sur Windows, installez-le depuis python.org.

4. Le monde et son esprit

lore.md et idea.md sont le compte-rendu complet ; voici l'essentiel pour quand vous ne pouvez pas les lire.

L'univers

• Theorem est une vaste organisation dédiée à la découverte et à la formalisation de la connaissance à travers l'univers. Les Seekers sont ses explorateurs, et Seeker est un rôle, pas une espèce : les humains, les extraterrestres et les machines peuvent le devenir. Les seekers de SEEKER NET, par exemple, sont de minuscules robots ressemblant à des ordinateurs.
• Le Codex est l'archive partagée de Theorem ; un Seeker y accède via la visière pour scanner, enregistrer et analyser. L'Attunement est la capacité de percevoir les fréquences et les structures des autres êtres et du cosmos. Les Seekers voyagent et travaillent seuls.
• La planète est glacée et presque invraisemblablement riche. La vie se réfugie dans des grottes sous la glace qui deviennent plus chaudes, plus étranges, plus belles et plus dangereuses avec la profondeur. Des scientifiques, des opportunistes, des gardiens et des adorateurs sont également venus. Quelque chose près du noyau semble appeler.
• Les Gardiens sont d'anciens dieux extraterrestres qui veillent sur la planète. Leurs origines sont un mystère.

Les rebondissements et la fin de l'histoire principale sont délibérément non publiés. Ne les inventez pas comme canon et ne prétendez pas les révéler ; une nouvelle œuvre trouve ses propres réponses. Une œuvre peut continuer le canon, l'étendre de manière compatible, le forker ouvertement, ou seulement emprunter le style. Tous sont les bienvenus ; dites lequel c'est. Aucun lore n'est requis : une seule idée empruntée, comme la planète gelée, Theorem ou l'accordage à base de 12, suffit pour construire.

Le personnage du Seeker

Le protagoniste du jeu principal est un Seeker particulier. Utilisez cette description uniquement dans les œuvres qui l'incluent ; tout autre Seeker peut ressembler à n'importe quoi.

• Un explorateur encapuchonné mystérieux. Une petite figure enveloppée de la tête aux pieds dans une cape à capuche d'un or sableux et discret, dans l'esprit des vagabonds encapuchonnés et vêtus de capes de Star Wars et Dune. À l'intérieur de la capuche, il n'y a que l'obscurité et une seule fente pâle de lumière, la visière par laquelle ils accèdent au Codex ; le visage n'est jamais montré. Des jambes sombres apparaissent sous la cape, qui flotte derrière eux quand ils courent.
• Un sac à dos qui grandit. Ils portent généralement un sac à dos sombre et compact qui grandit au fur et à mesure qu'ils collectent, en trois tailles de petit à grand (the-seeker/assets/items/equipment/backpack1.png à backpack3.png). Le jeu change de taille à mesure que plus de matériaux le remplissent, et le sac traîne légèrement derrière le corps, flotte au repos et tremble en courant (game/src/game/player/equipment.rs).
• Dans le jeu original, ils mesurent environ 12 pixels de haut, et leurs sprites se trouvent dans the-seeker/assets/animations/player/. Leur or est l'accent chaud décrit dans la grammaire visuelle.

Ce qu'il explore

• Les permutations de l'existence. Voir l'ultraviolet est une façon d'exister, t...