RoguelikeDebugger

⚠️ Ferramenta de desenvolvimento — NÃO é um mod de jogador.

Este pacote não melhora nada na experiência de jogar. Ele existe para investigar as mecânicas

internas do Stolen Realm durante o desenvolvimento de outros mods.

RoguelikeDebugger

Mod BepInEx 5 de investigação para Stolen Realm: faz dump dos dados internos do jogo no LogOutput.log para que as mecânicas possam ser confirmadas no código, não de ouvir falar.

• GUID: com.gumatos.roguelikedebugger
• 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).

O que ele faz

Apenas logs. Nenhuma alteração de gameplay. Ele registra no LogOutput.log:

• Skills — inventário de skills do jogo (nome, descrição, expressões, ações concedidas, efeitos de atributo, gatilhos) e as propriedades das ações (alcance, alvos, número de golpes, cooldown, cargas, status aplicados).
• Status — inventário dos status/buffs/debuffs com os efeitos de atributo e a descrição.
• Efeitos por tipo concreto — os arrays Effects de status e de ação são IEffectInfo (interface vazia): o dump publica o tamanho do array, o tipo concreto de cada elemento e os campos daquele tipo (por reflexão), mais os gatilhos do status. Ver a seção "Efeitos por tipo concreto" abaixo.
• Itens — inventário dos itens (tipo, raridade, descrição opcional, atributos, proporção de armadura, ação de consumível) e dos afixos.
• Powerups — inventário dos powerups do roguelike, uma linha por nível.
• Loot, ouro e experiência — as decisões de roll, os modificadores aplicados e os valores concedidos.

É a fonte dos CSVs de cobertura em docs/cobertura/ dos outros mods do projeto (ex.: o censo que alimenta a revisão de tooltips do BetterTooltips). Sem ele, revisar texto é leitura de prosa; com ele, cada número do tooltip pode ser cruzado com o código.

Por que ele não entra em pacote "para amigos": o dump é enorme e despeja milhares de linhas no log a cada boot, deixando o LogOutput.log ilegível para quem só quer jogar.

O que ele NÃO faz

• Não altera gameplay nem o save — a única saída do mod é texto no LogOutput.log.
• Não melhora a experiência de jogar — é ferramenta de investigação, não mod de jogador.
• Não envia dado nenhum para fora: tudo fica no log local, no seu computador.

Instalar

Este pacote só faz sentido para quem vai desenvolver/investigar.

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

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

Deve ficar:...\plugins\RoguelikeDebugger\RoguelikeDebugger.dll

• Abra o jogo uma vez (o dump sai no boot, não precisa entrar em partida) e leia:...\BepInEx\LogOutput.log

O log é sobrescrito a cada início do jogo.

Como desfazer

Apague a pasta BepInEx\plugins\RoguelikeDebugger\ (ou desabilite o pacote no r2modman) e abra o jogo de novo. O mod não modifica nenhum arquivo do jogo e não deixa resíduo.

Efeitos por tipo concreto (RV-8b-0g)

O campo Effects de status e de ação é IEffectInfo — uma interface vazia (l.322255 do decompilado). O dump antigo lia cada elemento com e as GeneralEffect (Patches/ActionStatusInventoryPatch.cs:84 e Patches/SkillInventoryPatch.cs:367) para publicar o campo Action. Em todo elemento cujo tipo concreto não seja GeneralEffect esse cast devolve null e o dado desaparecia do dump — foi o que deixou 2 entradas do censo de tooltips como indeterminado. A montagem tem duas implementações da interface:

| Tipo concreto | Campos | Onde |

|---|---|---|

| GeneralEffect | Action | l.322250 |

| CharacterVariableEffectInfo | EffectTarget, CharacterVariableAttribute, Amount | l.320295 |

Campos novos (sempre antes de desc=, que continua por último; nenhum valor com | nem aspas dentro):

| Categoria | Campos novos |

|---|---|

| [Status] | nEfeitosTot (Effects.Length), efTipos (índice:tipo{campos} de cada elemento), nAttrEf, attrTipos (os