Changelog

All notable changes to Cave Roamer are documented here.

1.1.0 (2026-09-06)

Added

• Echolocation (passive) — sneaking while holding a pickaxe, sword or axe with 20+ roamer energy gives entities within 15 blocks a wall-penetrating glowing outline, colored by broad category only: red = hostile, green = animal, blue = player. Costs 1 energy per second.
• Ore Residual Warmth — empty-hand right-click on a spot where ore was mined in the last 5 minutes (3 energy): the nearest remaining vein is locked onto the compass HUD dial in warm gold for 30 seconds, with an action-bar bearing and distance readout.
• Wall Cling (passive) — below Y 40, sneak + jump against a natural stone wall (stone, deepslate, tuff, cobblestone families) to climb it like a spider. Costs 2 energy per second; artificial blocks are rejected.
• Shadow Breath (H key) — 5 energy to activate, 3 per second, up to 20 seconds, 5 second cooldown. All hunger exhaustion is exactly halved while active (sprinting included). Black fog creeps in from the screen edges with a slow heartbeat.
• Cave Echo (passive) — the first time you descend into a new underground chunk, a one-line reading appears on the action bar: safety, monster density, nearby diamonds/emeralds, or nearby lava.
• Underground Notes (new item: book + compass + ender pearl) — right-click to open a survey book that logs coordinates, depth and in-game time with optional text notes (up to 32 marks). With 3+ marks it sketches an ASCII overhead map. Notes live in the item component, so dropping the book shares the whole survey.
• New keybind: H for Shadow Breath (rebindable under Options → Controls → Cave Roamer).

Changed

• Glow Domain now actually lights up the surroundings: a soft, particle-free night-vision brightness synchronized with the domain duration (previously it only played particles and blocked spawns). A real Night Vision potion is no longer cancelled by the domain expiring.
• The roamer energy bar now sits above the full vanilla status-bar stack and dynamically dodges armor rows and air bubbles — it no longer overlaps hearts, hunger or armor icons.

Fixed

• Crash (UnsupportedOperationException) on mining an ore type for the first time after relogging, caused by an immutable set in the discovery tracker; this also silently blocked the +30 first-discovery reward. Existing save data is fully compatible.

1.0.0 (2026-09-02)

Initial release for Minecraft 26.2 (NeoForge 26.2.0.75, Java 25).

• Roamer Energy — purple bar above the XP bar, capped at 100; regenerates underground only (doubled below Y −50), +5 per monster kill, +30 for each ore type mined for the first time.
• Glow Domain (G key) — 15 energy, 45 s (55 s below Y 0), 12-block radius: soft glow plus no hostile mob spawning inside.
• Geode Compass — right-click to point at the nearest natural ore vein (3+ connected blocks) within 25 blocks; color-coded pointer; ignores player-placed ores; 30 s cooldown (20 s below Y −30); 4 energy / 35 blocks while Glow Domain is active.
• Abyssal Satchel — 27-slot pocket inventory (leather + ender pearl + 3 iron ingots) that auto-presses whitelisted raw materials 9 → 1 and restores them on take-out; rejects tools, weapons and enchanted gear; vacuums nearby drops while selected (1 energy each).