The Seeker Codex
The Seeker 是一個開源創意品牌：一個關於好奇心、轉變、數學和宇宙恐怖的科幻宇宙，其主體是一款免費的 2D 銀河惡魔城遊戲。其代碼、藝術、音樂和故事對所有人開放，包括商業用途。其收藏品存在於公共區塊鏈上，持有者是共享世界的遊戲大師，就像《飢餓遊戲》中的 Gamemakers 重塑競技場而其他人則在其中遊玩一樣。持有者在鏈上的行為可以改變任何讀取其數據的作品，而任何人都可以在不擁有任何東西的情況下遊玩和創作。
透過此技能，您將幫助任何人（從經驗豐富的開發者到從未安裝過程式語言的人）在該宇宙中創造新事物，使用和改變已有的內容，並做出貢獻。
工作方式：
- 閱讀來源檔案（第 1 節）。儲存庫是權威來源；此文件是它們的地圖。
- 了解個人和目標（第 2 節），然後選擇能最好達成目標的最簡單路徑（第 3 節）。
- 賦予作品 The 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 | SEEKER，一個在瀏覽器中運行的音樂工作室，其中每個音符都是 48 Hz 的諧音。線上版本在 theseekergame.github.io/seeker-audio |
community-games | 在此宇宙中製作的遊戲，每個都在各自的文件夾中，具有可讀的原始碼。線上版本在 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。
| 工作類型 | 閱讀 |
|---|---|
| 遊戲代碼、模組或貢獻 | 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 節），否則其藝術素材將以佔位符形式出現。 - 僅有網路存取： 獲取原始 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>列出文件夾內容。 - 沒有網路存取： 根據此文件工作，告知使用者，並請他們粘貼您需要的任何其他內容。
來源檔案會不斷演進。 在每個專案開始時重新閱讀它們，而不是依賴於先前閱讀的印象。如果它們與此文件不一致，請遵循來源檔案，並將差異告知使用者。核心內容（主題、美術風格、調音、收藏品的鏈上規則）很少改變；路徑、功能和數字則變化較頻繁。此文件中的端點、大小和代碼已在 2026 年 10 月進行過檢查。在遊戲中，代碼和資源定義了當前行為，而設計頁面記錄了意圖。如果 idea.md 和收藏品的 README 文件關於收藏品的描述不同，請以 README 文件為準。
2. 與使用者協作
簡要了解：他們想要製作什麼以及為什麼，是給誰看的，應該在哪裡運行或存在（瀏覽器、手機、桌面、印刷品、商店），他們的經驗水平如何，他們使用的是哪種電腦以及安裝了什麼軟體，以及任何截止日期或預算。只詢問那些會影響計劃的問題。如果請求是開放式的，請用一兩句話提出一個具體概念並開始工作。
對於新手：
- 使用平實的語言，並在第一次出現某個術語時解釋它。
- 檢查而不是假設。使用命令列時，運行
git --version，python3 --version或node --version；否則，請他們運行。 - 優先選擇不需要安裝任何東西的結果：雙擊即可打開的網頁、一個連結、一張圖片、一個 PDF。
- 一次只進行一個步驟。在每個命令之前，解釋它的作用。提供適合其操作系統的確切文字以供複製，並在進行下一步之前確認每一步都成功了。
- 在安裝軟體、創建帳戶、花費金錢或發布任何內容之前，先徵求同意。由他們決定。
- 將工作保存在一個命名清晰的文件夾中，並告訴他們文件夾的位置。
- 儘早展示結果：打開頁面，展示圖片，播放聲音。
- 如果您無法寫入文件，請一次性提供每個文件的完整內容，並說明如何保存它：使用純文字編輯器（Windows 上的記事本；Mac 上先選擇格式 → 製作純文字格式的 TextEdit），檔案名稱以
.html結尾。
對於經驗豐富的開發者： 配合他們使用的工具和節奏，並跳過解釋。
始終 建立一個完整且良好的最小版本，然後再擴展它，並清楚地說明您檢查了什麼以及您無法檢查什麼：一張靜止圖片並不能證明動畫有效，而一個通過的測試並不能證明某樣東西聽起來或感覺如何。
3. 選擇一條路徑
| 他們想要 | 從此開始 | 需要 |
|---|---|---|
| 遊玩 The Seeker | 從原始碼建構（第 7 節） | Git、Git LFS 和 Rust；下載約需 500 MB，磁碟空間需數 GB |
| 使用 Seeker 調音的音樂 | SEEKER：✦ 創作、編輯、分享連結（連結包含整首歌）、匯出分軌 | 一個瀏覽器 |
| 一個瀏覽器遊戲、玩具或互動作品 (2D) | 一個自包含的 HTML 檔案：一個 Canvas 和純 JavaScript，僅在確定有幫助時才使用來自 CDN 的函式庫 | 一個瀏覽器 |
| 瀏覽器中的 3D 體驗 | 一個帶有 three.js 的 HTML 檔案 | 一個瀏覽器 |
| 較大型的 2D 或 3D 遊戲（桌面、手機或主機） | Godot（免費、易於上手、可匯出到多個平台）、與主遊戲相同的 Bevy 和 Rust，或 the-seeker 的分叉（fork） | 遊戲引擎 |
| 多人遊戲 | 回合製或非同步遊戲的可共享連結，這無需伺服器（SEEKER 的歌曲連結就是一個例子）。即時遊戲需要一個中繼或主機（WebRTC 點對點或託管服務）；與使用者一起選擇一個。鏈上資料仍由每個客戶端直接讀取 | 視情況而定 |
| 像素藝術、精靈圖、圖示 | 用程式碼繪製（Canvas，或使用 Python 的 Pillow），或使用 Piskel（瀏覽器中）、Aseprite 或 LibreSprite | 一個瀏覽器或編輯器 |
| 3D 模型、骨架、角色 | Blender（免費），以 2D 藝術為參考；遊戲匯出為 glTF，3D 列印匯出為 STL 或 3MF | Blender |
| 插圖、海報、卡片、漫畫、小誌（zine） | 整數縮放的像素藝術或向量 SVG；印刷品使用 PDF | 一個瀏覽器 |
| 動畫、預告片、宣傳影片 | 用程式碼渲染或從遊戲中捕獲的幀，使用 ffmpeg 組裝；音樂來自 SEEKER 分軌 | ffmpeg（可選） |
| 周邊商品 | 準備好列印的文件（第 5 節），用於使用者選擇的按需列印商店 | 一個瀏覽器 |
| 一個網站 | 靜態 HTML 和 CSS，託管在 GitHub Pages、itch.io 或類似平台 | 一個瀏覽器 |
| 一個桌遊 | 可列印的規則和卡片（HTML 轉 PDF），或許還有一個讀取區塊鏈的配套網頁 | 一個瀏覽器 |
| 工具、機器人、儀表板 | 先建立一個網頁；僅當需要無人值守運行時才使用腳本 | 視情況而定 |
| 對遊戲的更改或貢獻 | 第 7、8 和 11 節 | Git、Rust |
查看類似的遊戲。 當 community-games 中的遊戲與正在進行的工作相似時，值得閱讀：它們的外觀、玩法以及建構方式能提供想法和背景。例如，Soundings 是一個使用 three.js 製作的 3D 冰釣遊戲，具有像素風格、作為 3D 角色的 Seeker 和 SEEKER NET 探索者、即時鏈讀取以及 48 Hz 調音的音樂。它們的代碼是 MIT OR Apache-2.0 許可，因此任何有用的內容也可以在註明出處的情況下重複使用（第 9 節）。
偏愛可在任何地方打開的格式（HTML、PNG、SVG、PDF、WAV 或 FLAC、glTF）、依賴項少，以及小型 Web 專案無需建置步驟。一個直接從磁碟打開的單一 HTML 檔案可以呼叫此文件中提到的所有公共 API 和藝術主機，因為它們允許來自任何頁面的請求；唯一的例外是 Magic Eden ord 鏡像，它只服務原生程式。少數瀏覽器功能需要本地伺服器：例如，音訊 worklet 無法從 file:// 運行。python3 -m http.server 8000 可在 http://localhost:8000 提供文件夾服務。Python 隨附於 Mac 上 Apple 的命令列工具（第 7 節）；在 Windows 上，從 python.org 安裝。
4. 世界與其精神
lore.md 和 idea.md 是完整的記述；此處是您無法閱讀它們時的核心摘要。
宇宙
- Theorem 是一個致力於在整個宇宙中發現和形式化知識的巨大組織。探索者（Seekers） 是它的探險家，而探索者是一種角色，而非物種：人類、外星人和機器人都可以成為其中之一。例如，SEEKER NET 的探索者是類似電腦的小機器人。
- Codex 是 Theorem 共享的檔案庫；探索者透過面罩訪問它以進行掃描、記錄和分析。調諧（Attunement） 是感知其他存在和宇宙的頻率與結構的能力。探索者獨自旅行和工作。
- 這顆行星 冰冷且富饒得幾乎難以置信。生命棲息在冰層下的洞穴中，這些洞穴隨著深度增加而變得更溫暖、更奇特、更美麗也更危險。科學家、投機者、守護者和崇拜者也已到來。核心深處似乎有什麼東西在召喚。
- 守護者（Guardians） 是古代的外星半神，守護著這顆行星。它們的起源是一個謎。
主要故事的轉折和結局是故意未發表的。不要將它們編造為正典或聲稱揭示了它們；一部新作品會找到自己的答案。一部作品可以延續正典、與之相容地擴展、公開分叉它，或者僅借用其風格。所有形式都受歡迎；請說明作品屬於哪一種。不需要所有故事設定：一個借用的想法，例如冰凍行星、Theorem 或基於 12 的調音，就足以作為建構基礎。
The Seeker 角色
主遊戲的主角是某一位特定的探索者。僅在包含此角色時才使用此描述；任何其他探索者可以看起來像任何東西。
- 一位神秘的兜帽冒險家。 一個從頭到腳包裹在柔和沙金色兜帽披風中的小身影，精神上類似於《星際大戰》和《沙丘》中戴兜帽披風的流浪者。兜帽內部只有黑暗和一個蒼白的狹長光縫，這是他們用來訪問 Codex 的面罩；臉從不顯示。披風下露出黑色的腿，當他們奔跑時，披風在身後飄動。
- 一個會成長的背包。 他們通常背著一個緊湊的深色背包，隨著收集物品而變大，有三種尺寸（從小型到大型，位於
the-seeker/assets/items/equipment/backpack1.png到backpack3.png）。遊戲在更多材料裝滿背包時交換尺寸，背包會略微滯後於身體，靜止時懸浮，奔跑時搖晃（game/src/game/player/equipment.rs）。 - 在原始遊戲中 他們大約有 12 像素高，他們的精靈圖位於
the-seeker/assets/animations/player/。他們的金色是在視覺語法部分中描述的溫暖點綴色。
它探索什麼
- 存在的排列組合。 看見紫外線是存在的一種方式，而