Sobre Spire Codex

Spire Codex é um banco de dados completo de Slay the Spire 2, abreviado como StS2, criado por engenharia reversa dos arquivos do jogo. Cada carta, relíquia, monstro, poção, evento e poder deste site foi extraído diretamente do código-fonte e dos dados de localização do jogo.

O projeto começou da curiosidade sobre como StS2 foi construído e cresceu até virar uma API e um site completos. O objetivo é oferecer a referência detalhada e pesquisável que a comunidade de Spire merece.

Se quiser participar, fique à vontade para abrir um PR no GitHub. Este repositório fica a jusante de onde o projeto é hospedado, então pode demorar um pouco até seu PR ser totalmente mesclado. O projeto tem uma API aberta gratuita e que pode ser hospedada por você mesmo. E se quiser conversar sobre o projeto, apareça no Discord , onde publico novidades e converso sobre o projeto.

Muito obrigado a todos que apoiam o projeto; veja a página de agradecimentos com os apoiadores do Ko-fi e colaboradores da comunidade.

Por trás do Codex

Oi! Eu sou o Peter, tecnólogo autodidata, pai maneiro, marido legal e mexedor crônico. Entrei na engenharia de software e na tecnologia por um caminho fora do comum, construindo coisas do zero por pura curiosidade e paixão. Eu não faria de outro jeito. Já tive vários projetos (DPC, uma comunidade no Discord com mais de 10 mil profissionais de DevOps e plataforma, e Genshin News, um serviço de webhook com as últimas notícias de Genshin Impact), mas o Spire Codex é o meu maior projeto e o que mais me orgulha.

Apoiando o Spire Codex

O Spire Codex começou como um projeto de paixão, nascido do amor por Slay the Spire e da vontade de criar ferramentas úteis e rápidas para desenvolvedores da comunidade gamer.

Manter bancos de dados com muito tráfego e uma infraestrutura de API rápida tem custos reais de servidor e de tempo. Se o Spire Codex te salvou de uma derrota, te ajudou a planejar uma run ou alimentou seu próprio projeto, considere deixar uma gorjeta ou virar membro! Obrigado pelo apoio, seja financeiro ou não!

Ko-fi Patreon

O que tem aqui

Como funciona

Slay the Spire 2 é feito com Godot 4, mas toda a lógica do jogo fica em uma DLL C#/.NET 8. O pipeline de dados:

Extração do PCK

O GDRE Tools extrai o arquivo .pck do Godot, imagens, animações Spine e dados de localização (~9.947 arquivos)

Descompilação da DLL

O ILSpy descompila sts2.dll em ~3.300 arquivos-fonte C# contendo todos os modelos do jogo

Análise de dados

17 parsers em Python extraem dados estruturados do código C# descompilado e do JSON de localização

Renderização Spine

Um renderizador headless em Node.js monta animações esqueléticas em PNGs de retrato 512×512 (mais de 130 sprites)

API + Frontend

O FastAPI serve os dados analisados como uma API REST com mais de 20 endpoints; o frontend em Next.js a consome

Recursos

Páginas de detalhes

Páginas dedicadas para cartas, personagens, relíquias, monstros e poções com todas as estatísticas

Busca global

Pressione . em qualquer lugar para buscar em todas as categorias na hora

Renderização de texto formatado

Tags BBCode do jogo renderizadas com cores, animações e ícones embutidos

Diálogos dos personagens

Árvores de conversa de NPCs e falas de personagens da localização do jogo

Renders Spine

Mais de 130 sprites de monstros e personagens renderizados a partir de animações esqueléticas

API REST

API completa com filtragem, busca e documentação Swagger para seus próprios projetos

Registro de alterações

Diferenças em nível de campo entre atualizações do jogo em todas as categorias

Download de imagens

Navegue e baixe toda a arte do jogo extraída por categoria

Tecnologias

Backend

Python, FastAPI, Pydantic

Frontend

Next.js, TypeScript, Tailwind

Renderização

Node.js, Playwright, spine-webgl

Infraestrutura

Docker, Forgejo CI

Este projeto tem fins educacionais. Todos os dados do jogo pertencem à Mega Crit Games. Não deve ser usado para recompilar ou redistribuir o jogo.