🔍 LootPulse

Português (BR) | English

Português (BR)

Pressione F para escanear todos os valuables no raio — revela os brackets de descoberta nativos do jogo e adiciona ícones no mapa.

✨ O que faz

Com um único aperto de tecla, o LootPulse localiza todos os objetos valiosos no raio configurado, ativa os brackets amarelos de descoberta do jogo em cada item e os adiciona ao mapa. Nenhum valuable fica escondido.

🎯 Recursos

• 🔍 Scan por tecla — pressione F (configurável) para ativar o pulso imediatamente
• 📍 Brackets de descoberta — usa a animação nativa do jogo em cada valuable encontrado
• 🗺️ Ícones no mapa — todos os valuables escaneados aparecem no mapa automaticamente
• 📏 Raio configurável — ajuste o alcance de 5 a 200 metros
• ⏱️ Cooldown configurável — evita spam de scan (0–60 segundos)
• 🛡️ Resiliente a updates — APIs críticas resolvidas via reflexão e Harmony; fallbacks automáticos

👥 Multiplayer

Cada jogador precisa instalar o mod para ver os efeitos na sua tela.

• Só o host tem o mod — apenas o host vê brackets e mapa
• Todos têm o mod — cada jogador usa seu próprio scanner
• Ninguém tem o mod — nenhuma alteração

🕹️ Como usar

1. Entre em uma run ativa (fase gerada — não no menu ou lobby)
2. Pressione F
3. Todos os valuables no raio de 30m recebem brackets amarelos de descoberta
4. Ícones aparecem no mapa automaticamente

📦 Instalação

Via r2modman (recomendado):

1. Instale o BepInExPack
2. Procure e instale o LootPulse aqui no Thunderstore
3. (Opcional) Instale o REPOConfig para editar configurações dentro do jogo
4. Clique em Start modded

Manual:

1. Instale o BepInExPack
2. Copie plugins/HiarlyScripter-LootPulse/ para BepInEx/plugins/

⚙️ Configurações

Edite BepInEx/config/com.hiarlyscripter.repo.lootpulse.cfg ou use o REPOConfig dentro do jogo:

⚠️ Compatibilidade

Não instale junto com o BetterItemScanner. O BetterItemScanner está quebrado na build atual do R.E.P.O. e usa a mesma tecla F. Conflito garantido.

🔧 Diagnóstico

Se pressionar F não fizer nada, verifique BepInEx/LogOutput.log. O log deve conter:

[LootPulse] Harmony tick patch installed: GameDirector.Update
[LootPulse] Harmony game loop active: GameDirector.Update

Ao pressionar F dentro de uma run:

[LootPulse] Scan key detected: F | source=GameDirector.Update
[LootPulse] Scan executed | origin=... | range=30m | api=SemiFunc | found=X
[LootPulse] Result | brackets=X/X | map=X/X | errors=0

🗓️ Histórico resumido

🔮 Backlog futuro (sem data definida)

Ideias para versões futuras — sem compromisso de prazo:

• Filtro de valuables já descobertos
• AddMapIconsOnlyOnce, MaxItemsPerScan
• Auto-pulso / modo toggle
• Efeitos visuais por valor, feedback sonoro
• Whitelist/blacklist por categoria

English

Press F to scan all valuables within range — reveals the game's native discovery brackets and adds map icons.

✨ What it does

With a single keypress, LootPulse locates all valuable objects within the configured range, triggers the game's native yellow discovery brackets on each item, and adds them to the map. No valuable stays hidden.

🎯 Features

• 🔍 Key-triggered scan — press F (configurable) to pulse immediately
• 📍 Discovery brackets — uses the game's native animation on each valuable found
• 🗺️ Map icons — all scanned valuables appear on the map automatically
• 📏 Configurable range — set the scan radius from 5 to 200 meters
• ⏱️ Configurable cooldown — prevents scan spam (0–60 seconds)
• 🛡️ Resilient to updates — critical APIs resolved via reflection and Harmony; automatic fallbacks

👥 Multiplayer

Each player needs to install the mod to see the effects on their screen.

• Only host has the mod — only host sees brackets and map
• Everyone has the mod — each player uses their own scanner
• Nobody has the mod — no changes

🕹️ How to use

1. Enter an active run (generated level — not the menu or lobby)
2. Press F
3. All valuables within 30m radius receive yellow discovery brackets
4. Icons appear on the map automatically

📦 Installation

Via r2modman (recommended):

1. Install BepInExPack
2. Search and install LootPulse from Thunderstore
3. (Optional) Install REPOConfig to edit settings in-game
4. Click Start modded

Manual:

1. Install BepInExPack
2. Copy plugins/HiarlyScripter-LootPulse/ to BepInEx/plugins/

⚙️ Configuration

Edit BepInEx/config/com.hiarlyscripter.repo.lootpulse.cfg or use REPOConfig in-game:

⚠️ Compatibility

Do not install alongside BetterItemScanner. BetterItemScanner is broken on the current R.E.P.O. build and uses the same F key. Conflict is guaranteed.

🔧 Troubleshooting

If pressing F does nothing, check BepInEx/LogOutput.log. It should contain:

[LootPulse] Harmony tick patch installed: GameDirector.Update
[LootPulse] Harmony game loop active: GameDirector.Update

When pressing F inside a run:

[LootPulse] Scan key detected: F | source=GameDirector.Update
[LootPulse] Scan executed | origin=... | range=30m | api=SemiFunc | found=X
[LootPulse] Result | brackets=X/X | map=X/X | errors=0

🗓️ Changelog summary

🔮 Future backlog (no timeline)

Ideas for future versions — not implemented yet, no timeline commitment:

• Filter already-discovered valuables
• AddMapIconsOnlyOnce, MaxItemsPerScan
• Auto-pulse / toggle mode
• Visual effects by value, sound feedback
• Whitelist/blacklist by category

Mod by HiarlyScripter · Tested on R.E.P.O. v0.4.4.3 · BepInEx 5.4.23.5

Changelog — LootPulse

v1.0.7 — 2026-06-08

Compatibilidade: R.E.P.O. v0.4.4.3 · BepInEx 5.4.23.5

Changed

• README updated to bilingual PT-BR + EN (no code or gameplay changes)

v1.0.6 — 2026-06-04

Compatibilidade: R.E.P.O. v0.4.4.3 · BepInEx 5.4.23.5

Fixed

• Execution loop: scan tick now driven by a Harmony postfix on GameDirector.Update, bypassing MonoBehaviour Update lifecycle issues in R.E.P.O. v0.4.4.3
• Internal DLL version synced from 1.0.0 to 1.0.6

Improved

• Startup diagnostics: build marker, assembly location, assembly file timestamp, config dump at load
• Scan diagnostics: key detected log (with tick source), blocked reason, scan result per call (brackets / map icons / errors)
• Harmony fallback chain: GameDirector.Update → PlayerAvatar.Update → PlayerController.Update — clear error if no method found
• Watchdog: warns if Harmony patch installs but no game loop tick is observed within 60 seconds
• All logs in English
• No gameplay feature changes

v1.0.5 — 2026-06-02

Compatibilidade: R.E.P.O. Build 23250495 (v0.4.3.2) · BepInEx 5.4.23.5

Alterado

• Changelog atualizado com histórico completo de versões

v1.0.4 — 2026-06-02

Compatibilidade: R.E.P.O. Build 23250495 (v0.4.3.2) · BepInEx 5.4.23.5

Alterado

• Ícone atualizado: scanner com anéis dourados e nome "Loot Pulse" centralizado

v1.0.3 — 2026-06-02

Compatibilidade: R.E.P.O. Build 23250495 (v0.4.3.2) · BepInEx 5.4.23.5

Alterado

• Ícone atualizado (primeira versão com design do scanner da galeria)

v1.0.2 — 2026-05-25

Compatibilidade: R.E.P.O. Build 23250495 (v0.4.3.2) · BepInEx 5.4.23.5

Alterado

• Ícone corrigido para design do scanner dourado
• Primeira publicação no Nexus Mods

v1.0.0 — 2026-05-24

Compatibilidade: R.E.P.O. Build 23250495 (v0.4.3.2) · BepInEx 5.4.23.5

Adicionado

• Scanner de valuables via tecla configurável (padrão: F)
• Brackets visuais de descoberta nativos do jogo
• Ícones no mapa para valuables escaneados
• Config: ScanKey, ScanRange, CooldownSeconds, EnableVisualBrackets, EnableMapIcons, RequireLevelOrRun, VerboseLogging
• Fallbacks via reflexão para APIs críticas