關於 Spire Codex

Spire Codex 是 Slay the Spire 2（常簡稱 StS2）的綜合資料庫，透過逆向工程遊戲檔案構建。本站的每張卡牌、遺物、怪物、藥水、事件和能力都直接提取自遊戲原始碼和在地化資料。

這個專案源於對 StS2 如何構建的好奇，後來發展成完整的 API 和網站。目標是為 Spire 社群提供其應得的詳盡、可搜尋的參考資料。

如果你想參與，歡迎在這裡提交 PR： GitHub。這個儲存庫是專案託管處的下游，所以你的 PR 可能需要一些時間才能完全合併。該專案提供開放 API ，可免費使用並可自行託管。如果你想聊聊這個專案，歡迎來 Discord ，我在那裡發布更新並討論專案。

非常感謝支持本專案的每一位，請見致謝頁面查看 Ko-fi 支持者和社群貢獻者。

Codex 幕後

嗨！我是 Peter，一名自學成才的技術人、超酷的爸爸、很棒的丈夫，也是一個停不下來的折騰愛好者。我走了一條非傳統的路進入軟體工程與科技業，純粹出於好奇與熱愛，從零開始把東西做出來。我不會想換一種方式。我做過不少專案（DPC，一個擁有一萬多名 DevOps 與平台工程師的 Discord 社群；以及 Genshin News，一個推送原神最新消息的 Webhook 服務），但 Spire Codex 是我做過最大、也最讓我自豪的專案。

支持 Spire Codex

Spire Codex 起源於一個興趣專案，源自對 Slay the Spire 的熱愛，以及為遊戲社群打造實用、高效能開發者工具的願望。

運行高流量的資料庫和快速的 API 基礎設施需要實實在在的伺服器費用和大量時間。如果 Spire Codex 曾幫你避免翻車、幫你規劃一局，或支撐了你自己的專案，歡迎打賞或加入會員！無論是否有經濟上的支持，都感謝你的支持！

Ko-fi Patreon

內容一覽

運作原理

Slay the Spire 2 基於 Godot 4 構建，但所有遊戲邏輯都在一個 C#/.NET 8 DLL 中。資料流程：

PCK 提取

GDRE Tools 提取 Godot 的 .pck 檔案、圖片、Spine 動畫和在地化資料（約 9,947 個檔案）

DLL 反編譯

ILSpy 將 sts2.dll 反編譯為約 3,300 個包含全部遊戲模型的 C# 原始檔

資料解析

17 個 Python 解析器從反編譯的 C# 原始碼和在地化 JSON 中提取結構化資料

Spine 渲染

無頭 Node.js 渲染器將骨骼動畫合成為 512×512 的肖像 PNG（130 多個精靈）

API + 前端

FastAPI 以 20 多個端點的 REST API 提供解析後的資料；Next.js 前端負責消費

功能

詳情頁

卡牌、角色、遺物、怪物和藥水的可點擊詳情頁，附完整數據

全域搜尋

在任意位置按 . 即可即時搜尋所有類別

富文字渲染

遊戲 BBCode 標籤以顏色、動畫和內嵌圖示渲染

角色對話

來自遊戲在地化資料的 NPC 對話樹和角色台詞

Spine 渲染圖

從骨骼動畫渲染的 130 多個怪物和角色精靈圖

REST API

帶篩選、搜尋和 Swagger 文件的完整 API，供你自己的專案使用

更新日誌追蹤

所有類別中遊戲更新之間的欄位級差異

圖片下載

按類別瀏覽和下載所有提取的遊戲美術

技術堆疊

後端

Python, FastAPI, Pydantic

前端

Next.js, TypeScript, Tailwind

渲染

Node.js, Playwright, spine-webgl

基礎設施

Docker, Forgejo CI

本專案僅用於教育目的。所有遊戲資料歸 Mega Crit Games 所有。不得用於重新編譯或再散布遊戲。