The Seeker Codex は何をしますか？
The Seeker はオープンソースのクリエイティブブランドです：好奇心、変容、数学、そして宇宙的恐怖をテーマにしたSF宇宙で、その幹となるのは無料の2Dメトロイドヴァニアゲームです。そのコード、アート、音楽、伝承は、商用利用を含め、誰でも自由に使用できます。コレクティブルは公開ブロックチェーン上に存在し、その所有者は共有世界のゲームマスターとなり、まるで『ハンガー・ゲーム』のゲームメーカーがアリーナを再形成するように、他の全員がプレイしている間に世界を変えることができます。所有者がチェーン上で行うことは、それを読み取るすべての作品を変える可能性がありますが、誰でも何かを所有せずにプレイし、創作することができます。
このスキルを使えば、熟練の開発者からプログラミング言語をインストールしたことのない人まで、誰でもその宇宙で新しいものを作り、既存のものを利用・変更し、貢献することができます。
作業の進め方：
- ソースを読む（セクション1）。リポジトリが真実の源泉です。このファイルはそれらの地図です。
- 人物と目標を理解する（セクション2）。次に、それをうまく届けられる最もシンプルな経路を選ぶ（セクション3）。
- 作品にSeekerの特徴を与える（セクション4と5）。
- コレクションを作品を深める場所に取り入れる（セクション6）。
- 最小の完全なバージョンを構築し、それを見たり聞いたりしてから、拡張する。
- 適切に仕上げる： クレジット、ライセンス、そして共有方法（セクション9から12）。
1. まずソースを読む
すべては github.com/TheSeekerGame にあります。任意のファイルは https://raw.githubusercontent.com/TheSeekerGame/<repository>/main/<path> で読めます。
| リポジトリ | 内容 |
|---|---|
the-seeker | ゲーム、そのデザインビジョンと伝承、すべてのアートとオーディオアセット、およびドキュメント |
collections | Planetary Guardians と SEEKER NET：すべてのアートレイヤー、それらを組み立てる正確なルール、公開APIからライブ状態を読み取る方法 |
seeker-audio | すべての音符が48Hzの倍音であるブラウザ上の音楽スタジオ SEEKER。ライブ版は theseekergame.github.io/seeker-audio |
community-games | この宇宙で作られたゲーム、1フォルダに1つ、読み取り可能なソース付き。ライブ版は theseekergame.github.io/community-games |
theseekergame.github.io | 公開されたドキュメントとAPIリファレンス。the-seekerから生成されています。読むだけで、編集はしないでください |
作業を始める前に、どんな作業でも必ずこれらを読んでください：
| ファイル | 理由 |
|---|---|
the-seeker/README.md | ゲームの概要と実行方法 |
the-seeker/docs/design/idea.md | クリエイティブな基盤の詳細：テーマ、哲学、数学、ビジュアル言語、オープンユニバース、そして共有世界シグナルとしてのコレクション。移動している場合は、docs/ の下にある「The Seeker — a universe of permutations」というタイトルのページを探してください |
the-seeker/docs/design/lore.md | 宇宙の設定、そして意図的に未解決のままにされている疑問 |
the-seeker/docs/design/open-brand.md | 何がオープンで、どのライセンスの下で、ホルダーがどのようにゲームマスターとして機能するか、そしてすべてのコレクション |
the-seeker/docs/design/art-direction.md | アートのルール |
the-seeker/LICENSE.md | ライセンスと帰属表示行 |
collections/README.md、collections/guardians/README.md、collections/SEEKER_NET/README.md | コレクタブル、および任意のクライアントがライブ状態を読み取る方法 |
作業がそれらに触れる場合もこれらを読んでください。 それ以外はスキップしても構いません：サウンドのないプロジェクトは seeker-audio を必要とせず、ゲームのコードに触れないものは AGENTS.md を必要としません。
| 作業 | 読むもの |
|---|---|
| ゲームのコード、MOD、またはコントリビューション | the-seeker/AGENTS.md（AIエージェント用の指示ファイル：ソースマップとすべての変更が守るルール）、the-seeker/CONTRIBUTING.md、docs/architecture/、docs/authoring/ |
| ゲームデザインとメカニクス | docs/design/mechanics/（README.mdから始める）、docs/design/audience.md |
| 音楽、サウンド、タイミング | docs/authoring/music.md、docs/authoring/SeekerTuning48hz.tun、docs/architecture/timing-and-audio.md、seeker-audio/README.md |
| スプライトとアニメーション | docs/authoring/animations.md、docs/authoring/animation-reference.md、docs/authoring/assets.md |
| 洞窟、地形、背景 | docs/architecture/level-generation.md |
| コントラクトレベルのSEEKER NET | collections/SEEKER_NET/contracts/README.md と contracts/src/ |
| ゲーム、おもちゃ、またはインタラクティブ作品 | 似ている community-games のゲーム。アイデアとコンテキストのため（セクション3） |
読み方：
- シェルを使用する場合： 必要なものをクローンします。例：
git clone --depth 1 https://github.com/TheSeekerGame/collections.git。the-seekerの場合は、最初にgit lfs installを実行してください（セクション7）。そうしないと、アートがプレースホルダーとして到着します。 - Webアクセスのみの場合： raw URLを取得します。ゲームの画像、オーディオ、フォント、レベルプロジェクトは Git LFS に保存されています：
raw.githubusercontent.comはそれらに対して約130バイトのテキストポインタを返し、https://media.githubusercontent.com/media/TheSeekerGame/the-seeker/main/<path>が実際のファイルを返します。collectionsにLFSは使用されていません。フォルダを一覧表示するにはhttps://api.github.com/repos/TheSeekerGame/<repository>/contents/<path>を使用します。 - Webアクセスがない場合： このファイルから作業し、その旨を相手に伝え、必要なものを貼り付けてもらうよう依頼します。
ソースは進化します。 以前の読み取りに頼るのではなく、各プロジェクトの開始時に新たに読んでください。このファイルと矛盾がある場合は、ソースに従い、その違いを相手に伝えてください。コア部分（テーマ、アートスタイル、調律、コレクションのオンチェーンルール）はめったに変更されません。パス、機能、数字はより頻繁に変更されます。このファイルのエンドポイント、サイズ、コードは2026年10月に確認されました。ゲーム内では、コードとアセットが現在の動作を定義し、デザインページは意図を記録します。idea.md とコレクションのREADMEがコレクタブルについて異なる場合、READMEが最新です。
2. 相手と協力する
簡単に把握すること：彼らが何を作りたいのか、なぜなのか、誰のためなのか、どこで実行・存在するべきか（ブラウザ、電話、デスクトップ、印刷物、ショップ）、どの程度経験があるのか、どのコンピュータを使用しているか、何がインストールされているか、締切や予算はあるか。計画を変更する質問のみをしてください。リクエストが未定の場合は、1～2文で具体的なコンセプトを提案し、始めてください。
これらすべてに初めての人のために：
- 平易な言葉を使い、用語が最初に現れたときに説明する。
- 推測する代わりに確認する。シェルがある場合は
git --version、python3 --version、またはnode --versionを実行します。そうでなければ、相手に確認してください。 - 何もインストールする必要がない結果を優先する：ダブルクリックで開くWebページ、リンク、画像、PDF。
- 一歩ずつ進める。各コマンドの前に、その機能を説明する。相手のオペレーティングシステムに合わせた正確なテキストをコピーできるように提供し、次のステップに進む前に各ステップが機能したことを確認する。
- ソフトウェアのインストール、アカウントの作成、費用の支出、または何かの公開前に相手に確認する。彼らが決める。
- 作業は明確に名前を付けた1つのフォルダにまとめ、その場所を相手に伝える。
- 結果を早期に見せる：ページを開き、画像を見せ、音を再生する。
- ファイルを書き込めない場合は、各ファイルを1つのブロック全体として提供し、保存方法を説明する：プレーンテキストエディタ（Windowsのメモ帳、Macの場合は「フォーマット」→「標準テキストにする」を行った後のテキストエディット）で、名前を
.htmlで終わらせる。
経験者向け： 彼らのツールとペースに合わせ、説明は省略します。
常に 完全で質の高い最小バージョンを構築し、それを拡張し、確認できたことと確認できなかったことを明確に述べてください：静止画像はアニメーションが機能することを証明せず、テストが通っても音や感触がどうかを証明しません。
3. 経路を選ぶ
| 彼らが望むもの | 始めるもの | 必要となるもの |
|---|---|---|
| The Seeker をプレイする | ソースからビルドする（セクション7） | Git、Git LFS、Rust。ダウンロードに約500MB、ディスクに数GB必要 |
| Seeker調律での音楽 | SEEKER：✦ 驚き、編集、リンクを共有（曲全体を含む）、ステムをエクスポート | ブラウザ |
| ブラウザゲーム、おもちゃ、またはインタラクティブ作品（2D） | 1つの自己完結型HTMLファイル：キャンバスとプレーンなJavaScript。明確に役立つ場合のみCDNからライブラリを使用 | ブラウザ |
| ブラウザでの3D体験 | three.jsを使用した1つのHTMLファイル | ブラウザ |
| デスクトップ、モバイル、コンソール向けの大規模2Dまたは3Dゲーム | Godot（無料、親しみやすく、あらゆるプラットフォームにエクスポート可能）、メインゲームと同じBevyとRust、または the-seeker のフォーク | エンジン |
| マルチプレイヤー | ターンベースまたは非同期プレイ用の共有可能なリンク（サーバー不要。SEEKERの曲リンクが方法を示しています）。リアルタイムプレイにはリレーまたはホストが必要（WebRTC P2P、またはホスティングサービス）。相手と選択してください。チェーンデータは各クライアントが直接読み取ります | 状況による |
| ピクセルアート、スプライト、アイコン | コードで描く（キャンバス、またはPythonとPillow）、またはPiskel（ブラウザ内）、Aseprite、LibreSprite | ブラウザまたはエディタ |
| 3Dモデル、リグ、フィギュア | Blender（無料）。2Dアートを参照として使用。ゲーム用にglTF、印刷用にSTLまたは3MFをエクスポート | Blender |
| イラスト、ポスター、カード、コミック、ZINE | 整数スケールのピクセルアートまたはベクターSVG。印刷用にPDF | ブラウザ |
| アニメーション、トレーラー、プロモーションクリップ | コードでレンダリングするかゲームからキャプチャしたフレームを、ffmpegで組み立て。SEEKERステムからの音楽 | ffmpeg（オプション） |
| マーチャンダイズ | 相手が選んだPOD（Print-on-Demand）ショップ用の印刷対応ファイル（セクション5） | ブラウザ |
| Webサイト | 静的HTMLとCSS。GitHub Pages、itch.ioなどにホスト | ブラウザ |
| テーブルトップゲーム | 印刷可能なルールとカード（HTMLからPDFへ）。おそらくチェーンを読み取るコンパニオンWebページも | ブラウザ |
| ツール、ボット、ダッシュボード | 最初はWebページ。無人で実行する必要がある場合のみスクリプト | 状況による |
| ゲームへの変更またはコントリビューション | セクション7、8、11 | Git、Rust |
類似ゲームを見る。 community-games のゲームは、作品が似ている場合に読む価値があります：どのように見え、動き、構築されているかがアイデアとコンテキストを与えます。例えば Soundings は、three.js で作られた3Dアイスフィッシングゲームで、ピクセルルック、Seeker と SEEKER NET のシーカーを3Dキャラクターとして、ライブチェーン読み取り、48Hz調律の音楽を備えています。それらのコードは MIT OR Apache-2.0 なので、クレジットすれば（セクション9）、便利なものは何でも再利用できます。
どこでも開ける形式（HTML、PNG、SVG、PDF、WAVまたはFLAC、glTF）、依存関係が少ないもの、小規模なWebプロジェクトではビルドステップがないものを優先します。ディスクから直接開かれた単一のHTMLファイルは、このファイルに記載されているすべての公開APIとアートホストを呼び出せます。これらは任意のページからのリクエストを許可しているためです。唯一の例外は Magic Eden ord ミラーで、これはネイティブプログラムのみを提供します。いくつかのブラウザ機能はローカルサーバーを必要とします：例えば、オーディオワークレットは file:// からは実行されません。python3 -m http.server 8000 で http://localhost:8000 のフォルダを提供します。PythonはMacのAppleのコマンドラインツールに付属しています（セクション7）。Windowsの場合は python.org からインストールします。
4. 世界とその精神
lore.md と idea.md が完全な記述です。以下は、それらを読めない場合のためのエッセンスです。
宇宙
- Theorem は、宇宙全体の知識を発見し形式化することに専念する巨大な組織です。Seeker はその探検者であり、Seeker は役割であり種族ではありません：人間、エイリアン、機械も同様に Seeker になります。例えば SEEKER NET のシーカーは、小さなコンピュータのようなロボットです。
- The Codex は Theorem の共有アーカイブです。Seeker はバイザーを通じてそれにアクセスし、スキャン、記録、分析を行います。Attunement とは、他の存在や宇宙の周波数や構造を感知する能力です。Seeker は孤独に旅し、働きます。
- 惑星 は氷に覆われており、ほとんど信じがたいほど豊かです。生命は氷の下の洞窟に避難しており、深くなるにつれて暖かく、奇妙で、美しく、そして危険になります。科学者、チャンスを狙う者、管理者、崇拝者もやって来ました。核の近くに何かが呼んでいるようです。
- Guardians は、惑星を見守る古代エイリアンの半神です。その起源は謎です。
メインストーリーのひねりと結末は意図的に未公開です。それらを正史として創作したり、明かすと主張したりしないでください。新しい作品は独自の答えを見つけます。作品は正史を継続することも、互換性を持って拡張することも、それを公然と分岐させることも、スタイルを借りるだけでも構いません。すべて歓迎します。どれであるかを明言してください。伝承は必須ではありません。凍った惑星、Theorem、12ベースの調律など、1つのアイデアを借りるだけでも構築には十分です。
The Seeker キャラクター
メインゲームの主人公は特定の一人の Seeker です。この説明は、その主人公を含む作品でのみ使用してください。他の Seeker はどのように見えても構いません。
- 神秘的なフード付き探検者。 頭からつま先まで、くすんだ砂金色のフード付きマントに包まれた小さな人物で、『スター・ウォーズ』や『デューン』のフードとマントをまとった放浪者の精神に基づいています。フードの中は暗闇だけで、Codex にアクセスするためのバイザーである、淡い光のスリットが1つあるだけです。顔は決して表示されません。マントの下に暗い脚が見え、走ると後ろになびきます。
- 成長するバックパック。 彼らは通常、暗くコンパクトなバックパックを背負っており、収集するにつれて3つのサイズ（小、中、大）（
the-seeker/assets/items/equipment/backpack1.pngからbackpack3.png）に成長します。ゲームはより多くの素材でバックパックが満たされるにつれてサイズを交換し、バックパックは体からわずかに遅れ、停止時は浮き、走行時は揺れます（game/src/game/player/equipment.rs）。 - 元のゲームでは 約12ピクセルの高さで、スプライトは
the-seeker/assets/animations/player/にあります。金色は、『ビジュアル文法』で説明される暖色のアクセントです。
探求するもの
- 存在の順列。 紫外線を見ることは一つの存在の仕方であり、t
...（翻訳のために省略）