À propos Spire Codex

Spire Codex est une base de données complète pour Slay the Spire 2, souvent abrégé StS2, construite par rétro-ingénierie des fichiers du jeu. Chaque carte, relique, monstre, potion, événement et pouvoir de ce site a été extrait directement du code source et des données de localisation du jeu.

Le projet est né de la curiosité de comprendre comment StS2 a été construit, puis est devenu une API et un site web complets. L'objectif est de fournir la référence détaillée et consultable que la communauté Spire mérite.

Si vous voulez participer, n'hésitez pas à ouvrir une PR sur GitHub. Ce dépôt est en aval de l'hébergement principal du projet, donc la fusion complète de votre PR peut prendre un peu de temps. Le projet dispose d'une API ouverte gratuite et auto-hébergeable. Et si vous voulez discuter du projet, passez sur le Discord , où je publie des nouvelles et discute du projet.

Un grand merci à tous ceux qui soutiennent le projet, voir la page de remerciements pour les soutiens Ko-fi et les contributeurs de la communauté.

Derrière le Codex

Salut ! Je suis Peter, technologue autodidacte, papa génial, mari cool et bricoleur invétéré. J'ai suivi un parcours atypique vers le génie logiciel et la tech, en construisant des choses de zéro par pure curiosité et passion. Je ne voudrais pas qu'il en soit autrement. J'ai eu pas mal de projets (DPC, une communauté Discord de plus de 10 000 professionnels DevOps et plateforme, et Genshin News, un service de webhooks pour les dernières actualités de Genshin Impact), mais Spire Codex est mon plus grand projet et celui dont je suis le plus fier.

Soutenir Spire Codex

Spire Codex a commencé comme un projet passion, né de l'amour de Slay the Spire et de l'envie de créer des outils de développement utiles et performants pour la communauté du jeu.

Faire tourner des bases de données très sollicitées et une infrastructure d'API rapide coûte de vrais frais de serveur et du temps. Si Spire Codex t'a évité une défaite, t'a aidé à préparer une run ou a fait tourner ton propre projet, pense à laisser un pourboire ou à prendre un abonnement ! Merci pour ton soutien, financier ou non !

Ko-fi Patreon

Contenu

Comment ça marche

Slay the Spire 2 est construit avec Godot 4, mais toute la logique du jeu réside dans une DLL C#/.NET 8. Le pipeline de données :

Extraction du PCK

GDRE Tools extrait le fichier .pck de Godot, les images, les animations Spine et les données de localisation (~9 947 fichiers)

Décompilation de la DLL

ILSpy décompile sts2.dll en ~3 300 fichiers source C# contenant tous les modèles du jeu

Analyse des données

17 parseurs Python extraient des données structurées du code C# décompilé et du JSON de localisation

Rendu Spine

Un moteur de rendu Node.js headless assemble les animations squelettiques en PNG portrait 512×512 (plus de 130 sprites)

API + Frontend

FastAPI expose les données analysées via une API REST de plus de 20 endpoints ; le frontend Next.js la consomme

Fonctionnalités

Pages de détail

Pages dédiées pour les cartes, personnages, reliques, monstres et potions avec toutes les statistiques

Recherche globale

Appuyez sur . n'importe où pour chercher instantanément dans toutes les catégories

Rendu de texte enrichi

Balises BBCode du jeu rendues avec couleurs, animations et icônes en ligne

Dialogues des personnages

Arbres de dialogue des PNJ et répliques des personnages issus de la localisation du jeu

Rendus Spine

Plus de 130 sprites de monstres et personnages rendus à partir d'animations squelettiques

API REST

API complète avec filtrage, recherche et documentation Swagger pour vos propres projets

Suivi des changements

Différences au niveau des champs entre les mises à jour du jeu, toutes catégories confondues

Téléchargement d'images

Parcourez et téléchargez tous les visuels du jeu extraits, par catégorie

Technologies

Backend

Python, FastAPI, Pydantic

Frontend

Next.js, TypeScript, Tailwind

Rendu

Node.js, Playwright, spine-webgl

Infrastructure

Docker, Forgejo CI

Ce projet a un but éducatif. Toutes les données du jeu appartiennent à Mega Crit Games. Il ne doit pas servir à recompiler ni à redistribuer le jeu.