RoguelikeSkillTreeVisualizer

Status: IMPLEMENTADO (RSTV-2 + fase de diagnóstico). O botão e a árvore somente leitura estão prontos e o mod ainda não foi conferido em jogo pelo autor.

• GUID: com.gumatos.roguelikeskilltreevisualizer
• Versão: 0.1.0
• Compatível com: Stolen Realm v1.3.1 (versão mais recente do jogo em 30/09/2026).
• Dependências: nenhuma além do BepInEx 5 (que o r2modman já instala no perfil).

Este mod já é um pacote Thunderstore: a pasta tem o manifest.json, o icon.png (256×256, que o Thunderstore exige), o README.md, o CHANGELOG.md e o código:

Seguindo o padrão dos outros mods do repositório: uma pasta na raiz, com o .csproj, o Plugin.cs e o alvo DeployToBepInEx (não existe src/, decisão registrada na PKG-1).

Alvo de compatibilidade: Stolen Realm v1.3.1 (versão mais recente do jogo em 30/09/2026) — é a versão que o manifest.json deste pacote declara.

Para quem vai usar

O que o botão faz

• Aparece como um botão quadrado Skills, colado à direita do Choose Powerups, na mesma linha (o Choose Powerups encolhe o necessário e a linha não cresce; o Accept Party não muda).
• Abre a árvore de skills do personagem certo: o último que VOCÊ adicionou à party, resolvido no clique (o nível e o equipamento mostrados são os de agora, sem cache).
• Dentro da árvore dá para navegar, dar zoom, trocar de aba e ler os tooltips com os números do seu personagem. As skills já aprendidas aparecem acesas; o resto cinza/CannotObtain.
• O botão fica desabilitado quando a sua party está vazia e só aparece em modo Roguelike (segue o Choose Powerups).

O que o botão NÃO faz

• Não gasta ponto de skill — o rodapé mostra 0 points available.
• Não aprende nem remove skill — clicar num nó é bloqueado (read-only) e o Respec Build fica escondido.
• Não altera o Accept Party, a Current Party, os Powerups, o GameMode nem as regras do Roguelike. Nenhum arquivo do jogo é modificado.
• Não mistura jogadores — cada jogador usa os seus próprios personagens; o que o outro adiciona à party não muda o que você vê.

O mod não reimplementa as Skill Trees: ele resolve o personagem certo e entrega a instância real para o sistema nativo. Não há compra de skill, gasto de ponto nem qualquer escrita.

Instalar

Pelo r2modman (recomendado): instale este pacote no perfil do Stolen Realm — o r2modman coloca a DLL em BepInEx\plugins\RoguelikeSkillTreeVisualizer\.

Manual:

1. Instale o BepInEx 5 x64 no jogo (ou dê "Start modded" uma vez no r2modman, que cria a pasta).
2. Copie a pasta RoguelikeSkillTreeVisualizer para:

   %APPDATA%\r2modmanPlus-local\StolenRealm\profiles\Default\BepInEx\plugins\
   

   Deve ficar: ...\plugins\RoguelikeSkillTreeVisualizer\RoguelikeSkillTreeVisualizer.dll
3. Abra o jogo. No LogOutput.log deve aparecer:

   Roguelike Skill Tree Visualizer 0.1.0 carregado (RSTV-2: botao ao lado do Choose Powerups + skill tree read-only).
   RSTV: patches Harmony aplicados (8/8 ganchos, 8 metodos do jogo).
   

   Se vier 7/8 (ou menos), o log diz qual gancho não entrou — veja Diagnóstico abaixo.
4. Vá em Roguelike → Select Party: o botão Skills fica colado à direita do Choose Powerups.

Só funciona no modo Roguelike e o botão só aparece na tela Select Party. Não é preciso entrar em partida.

Config (opcional)

BepInEx/config/com.gumatos.roguelikeskilltreevisualizer.cfg:

O padrão é o comportamento de sempre: quem não abrir o arquivo de config não vê diferença nenhuma.

Desinstalar

1. Feche o jogo.
2. Apague a pasta do mod em BepInEx/plugins/RoguelikeSkillTreeVisualizer/ (no perfil do r2modman ou na instalação manual). Nada é criado fora dela.
3. Opcional: apague BepInEx/config/com.gumatos.roguelikeskilltreevisualizer.cfg.

Desinstalar não deixa resíduo no jogo e não afeta save.

Diagnóstico — como saber o que aconteceu

O mod não falha em silêncio: cada gancho é aplicado e logado individualmente e cada caminho de falha escreve o motivo. No LogOutput.log:

O que o mod faz (técnico)

Adiciona um visualizador de Skill Trees na tela Roguelike → Select Party: um botão quadrado à direita do Choose Powerups que abre a interface de Skill Trees nativa do jogo (a mesma do Campaign → Change Skills), em modo somente leitura, com o contexto real do personagem — Level, equipamento, atributos e estado das skills atuais.

Regras que já estão decididas

Ícone

icon.png (256×256) é o ícone de pacote do Thunderstore — arte de verdade do autor (redimensionada de uma arte 1254×1254), não um ícone genérico gerado pelo script do empacotador. É PNG válido (RGBA) e passa na checagem de 256×256 do tools/pack-thunderstore.py.

Pendente: o arquivo original de 1254×1254 não está versionado neste repositório (dos outros mods os originais ficaram em scratch/icons-orig/, mas o do RSTV não está lá). Se precisar reexportar ou cortar outra versão, a arte-fonte tem de ser pedida de novo ao autor — nada de gerar um PNG falso no lugar.

Especificação e aceite

A especificação completa (77 itens: investigação obrigatória, estratégia de injeção, rastreio de personagem, testes por caso) e os critérios de aceite estão registrados no quadro interno do projeto (não versionado).

Roteiro de conferência em jogo (RSTV-2)

1. Compilar e instalar: dotnet build RoguelikeSkillTreeVisualizer/RoguelikeSkillTreeVisualizer.csproj (sem a propriedade DeployToBepInEx=false ele copia a DLL para o perfil do r2modman).
2. Abrir o jogo modded e ir em Roguelike → Select Party. No LogOutput.log devem aparecer RSTV: patches Harmony aplicados (8/8 ganchos, 8 metodos do jogo) e RSTV-2: botao 'Skills' injetado ... largura da linha N -> N px (as duas larguras devem bater). Se o botão não aparecer, o log já diz o motivo (RSTV DIAG: ..., com a tela, o botão nativo e a party local) — não precisa adivinhar.
3. Adicionar 2 personagens meus à party (clique nos tiles) → o log diz qual virou o alvo; clicar num terceiro e removê-lo → o alvo volta para o último que ficou.
4. Clicar no botão quadrado Skills (colado à direita do Choose Powerups). Esperado: RSTV-2: skill tree read-only aberta para '<nome>' (nivel N, M skills, 0 pontos) e a árvore nativa por cima da tela de party, com as skills aprendidas acesas e o resto cinza/CannotObtain.
5. Na árvore: passar o mouse nos nós (tooltip com os números do personagem real), trocar de aba, tentar clicar num nó → RSTV-2: clique na arvore BLOQUEADO (read-only). O botão Respec Build não aparece; o rodapé mostra 0 points available.
6. Fechar (X ou Esc) → RSTV-2: modo somente leitura encerrado (nada foi gravado no personagem). Conferir que Accept Party, a Current Party e os Powerups continuam intactos.
7. Repetir abrindo/fechando 3× e depois aceitar a party — a árvore não pode aparecer presa atrás nem empurrar a UI.
8. Opcional (config): com AtivarBotao = false no .cfg, a tela abre normal e sem botão nenhum; o log diz RSTV DIAG: botao 'Skills' DESABILITADO nesta sessao.

Riscos conhecidos (não verificáveis sem abrir o jogo)

• O sprite/âncora/LayoutGroup da linha vivem no prefab (resources.assets, 1,7 GB, não aberto): o mod mede em runtime, compensa a largura e loga o modo de layout usado. Se o log mostrar childForceExpandWidth, a linha não cresce mas os botões vizinhos se redistribuem.
• Z-order: a Skill Tree é instanciada sob outro ramo do canvas. O mod compara os índices de irmão e, se a árvore estiver atrás da tela de party, move o ramo para o fim e restaura ao fechar (logado).
• GameLogic.CurrentlySelectedCharacter é ajustado para o personagem alvo (é de onde SkillTreeManager e o Tooltip leem o contexto). Isso também marca aquele personagem como IsPartyLeader e libera o lock da câmera — o mesmo que o jogo faz ao selecionar um personagem no mundo.
• Fechamento de emergência: se a higienização do commit falhar, o mod não deixa o original rodar e fecha a janela por conta própria (zero escrita) em vez de arriscar a gravação. Só acontece num caminho de exceção, mas vale conferir que a tela de party volta ao normal depois (o log diz RSTV: falha ao higienizar AcceptSkillChanges ...).
• Segundo caminho de gravação (achado na auditoria estática): SkillTreeManager.ResetSkillPoints() (l.173274) é público, sem parâmetro e chama Character.ResetSkills(), que zera todas as skills do personagem e enfileira o save dele (l.37474) — sem passar pelo AcceptSkillChanges. O mod agora o bloqueia em read-only (gancho 8). O que fica para medir em jogo: qual botão do prefab chama esse método (o campo resetButton, l.172057, não está ligado em código) e se existe algum botão que chame CheckSkillDependancies(Character) (l.172328), que também grava (l.172344/172352) mas não tem nenhum chamador no assembly — esse não foi bloqueado de propósito (bloqueá-lo às cegas poderia atrapalhar um caminho legítimo do jogo).
• Interceptor de Esc é um slot único (UIWindowManager.CancelInterceptor, l.215982). O InventoryManager.OnEnable (l.125301) também o ocupa: se a mochila puder ser aberta por cima da árvore, o Esc deixa de fechar a árvore e ela só fecha no botão de fechar da janela (e, quando a tela de party fechar, pela guarda do host). Medir em jogo se isso é alcançável no Select Party.
• Largura da linha com childForceExpandWidth: o mod hoje não compensa a largura nesse modo ("o próprio grupo acomoda o filho"). Isso só vale se a linha tiver largura fixa; se ela for dimensionada pelo conteúdo (um ContentSizeFitter acima), ela cresce com o clone e o log mostra largura da linha A -> B com A ≠ B. É exatamente o que a linha do log serve para flagrar no primeiro teste em jogo.

Correções da auditoria estática (contra o decompilado, sem rodar o jogo)

• Gancho 8: SkillTreeManager.ResetSkillPoints bloqueado em read-only (segundo ponto de gravação).
• A árvore agora fecha sozinha se a tela Select Party fechar por fora (aceitar a party muda o GUIState e o jogo fecha a tela em l.118416/l.133307/l.215520 sem fechar o SkillTreeManager): antes ela ficaria desenhada por cima do mapa, com o interceptor de Esc instalado.