Info Spire Codex

Spire Codex è un database completo per Slay the Spire 2, abbreviato StS2, costruito tramite reverse engineering dei file di gioco. Ogni carta, reliquia, mostro, pozione, evento e potere su questo sito è stato estratto direttamente dal codice sorgente e dai dati di localizzazione del gioco.

Il progetto è nato dalla curiosità di capire come fosse costruito StS2 ed è cresciuto fino a diventare un'API e un sito completi. L'obiettivo è offrire il riferimento dettagliato e consultabile che la community di Spire merita.

Se vuoi contribuire, apri pure una PR su GitHub. Questo repository è a valle di dove è ospitato il progetto, quindi potrebbe volerci un po' prima che la tua PR venga completamente unita. Il progetto ha una API aperta gratuita e self-hostable. E se vuoi parlare del progetto, vieni sul Discord , dove pubblico aggiornamenti e parlo del progetto.

Un grande grazie a chi sostiene il progetto, vedi la pagina dei ringraziamenti per i sostenitori su Ko-fi e i collaboratori della community.

Dietro il Codex

Ciao! Sono Peter, tecnologo autodidatta, papà fantastico, marito simpatico e smanettone cronico. Sono arrivato all'ingegneria del software e alla tecnologia per una strada non convenzionale, costruendo cose da zero per pura curiosità e passione. Non vorrei che fosse andata diversamente. Ho avuto parecchi progetti (DPC, una community Discord con oltre 10.000 professionisti DevOps e platform, e Genshin News, un servizio webhook per le ultime notizie di Genshin Impact), ma Spire Codex è il mio progetto più grande e quello di cui vado più fiero.

Sostenere Spire Codex

Spire Codex è nato come progetto di passione, dall'amore per Slay the Spire e dal desiderio di creare strumenti per sviluppatori utili e performanti per la community dei giocatori.

Gestire database ad alto traffico e un'infrastruttura API veloce comporta costi reali di server e di tempo. Se Spire Codex ti ha salvato da una sconfitta, ti ha aiutato a pianificare una run o ha alimentato un tuo progetto, considera di lasciare una mancia o di abbonarti! Grazie per il tuo supporto, economico o no!

Ko-fi Patreon

Cosa contiene

Come funziona

Slay the Spire 2 è costruito con Godot 4, ma tutta la logica di gioco vive in una DLL C#/.NET 8. La pipeline dei dati:

Estrazione del PCK

GDRE Tools estrae il file .pck di Godot, immagini, animazioni Spine e dati di localizzazione (~9.947 file)

Decompilazione della DLL

ILSpy decompila sts2.dll in ~3.300 file sorgente C# contenenti tutti i modelli di gioco

Parsing dei dati

17 parser Python estraggono dati strutturati dal sorgente C# decompilato e dal JSON di localizzazione

Rendering Spine

Un renderer headless in Node.js assembla le animazioni scheletriche in PNG ritratto 512×512 (oltre 130 sprite)

API + Frontend

FastAPI espone i dati elaborati come API REST con oltre 20 endpoint; il frontend Next.js la consuma

Funzionalità

Pagine di dettaglio

Pagine dedicate per carte, personaggi, reliquie, mostri e pozioni con tutte le statistiche

Ricerca globale

Premi . ovunque per cercare all'istante in tutte le categorie

Rendering del testo formattato

Tag BBCode del gioco resi con colori, animazioni e icone in linea

Dialoghi dei personaggi

Alberi di dialogo dei PNG e citazioni dei personaggi dalla localizzazione del gioco

Render Spine

Oltre 130 sprite di mostri e personaggi renderizzati da animazioni scheletriche

API REST

API completa con filtri, ricerca e documentazione Swagger per i tuoi progetti

Tracciamento delle modifiche

Differenze a livello di campo tra gli aggiornamenti del gioco in tutte le categorie

Download delle immagini

Sfoglia e scarica tutta l'arte di gioco estratta per categoria

Stack tecnologico

Backend

Python, FastAPI, Pydantic

Frontend

Next.js, TypeScript, Tailwind

Rendering

Node.js, Playwright, spine-webgl

Infrastruttura

Docker, Forgejo CI

Questo progetto ha scopi didattici. Tutti i dati di gioco appartengono a Mega Crit Games. Non deve essere usato per ricompilare o ridistribuire il gioco.