Cave Roamer 

A survival companion that makes you feel at home in the dark — it doesn't hand you artifacts, it hands you wits.

Cave Roamer rewards going deep. Explore caves to charge your Roamer Energy, then spend it on skills that light the darkness, sniff out ore veins, compress your loot and keep you alive on long expeditions. The deeper you go, the stronger you get.

Roamer Energy

• A purple bar above the XP bar, capped at 100
• Regenerates slowly while underground (below Y 40) — never on the surface
• +5 per monster kill, +30 the first time you mine each ore type (with a golden particle burst)
• Regeneration doubles below Y −50
• Every active skill spends it; if you can't afford a skill, the bar flashes red

The Skills

Glow Domain — press G

15 energy · 45 seconds · 12-block radius

• A soft blue-white glow fills the area around you (gentle night-vision brightness plus drifting firefly particles)
• Hostile mobs cannot spawn inside the radius while it is active
• Lasts 10 seconds longer when you are below Y 0
• Great for an emergency safe pocket when you get swarmed

Geode Compass — right-click while held

8 energy · 30 s cooldown

• Points at the nearest natural ore vein (3+ connected blocks) within 25 blocks
• The pointer color tells the ore family: white iron/copper/coal/quartz · yellow gold · blue diamond/emerald · red redstone/lapis · purple ancient debris
• Ores placed by players are never detected — no cheating
• An on-screen dial shows direction and distance
• While Glow Domain is active: only 4 energy and a 35-block range; below Y −30 the cooldown drops to 20 s

Abyssal Satchel — craft it

Leather + ender pearl + 3 iron ingots

• A private 27-slot inventory stored inside the item itself
• Raw materials auto-press 9 → 1 while inside and restore on take-out: cobblestone, bones, rotten flesh (custom compressed items) plus vanilla storage blocks (iron, gold, diamond, coal, redstone, lapis, emerald, quartz, glowstone, copper)
• Tools, weapons and enchanted gear are rejected — raw materials only
• While selected in your hotbar it vacuums nearby drops into itself (1 energy per item, with a blue particle trail)

Echolocation — passive

Sneak while holding a pickaxe, sword or axe · needs 20+ energy · 1/s

• Entities within 15 blocks get a wall-penetrating outline: red hostile, green animal, blue player
• You see something red behind the wall — never what it is
• Stop meeting skeletons around corners

Ore Residual Warmth — empty-hand right-click

3 energy

• Right-click a spot where ore was mined in the last 5 minutes: a faint golden particle trail points toward the nearest remaining vein
• Cold stone? Nothing was mined here — and nothing is charged

Wall Cling — passive

Below Y 40 · sneak + jump against a wall · 2/s

• Climb vertical stone, deepslate or cobblestone walls like a spider
• Natural stone only — planks and bricks don't work
• Fell into a ravine? Just climb back out

Shadow Breath — press H

5 energy to start · 3/s · up to 20 s · 5 s cooldown

• All hunger exhaustion is exactly halved while active — sprinting included
• Black fog creeps in from the screen edges with a slow heartbeat
• For long expeditions and lean food supplies

Cave Echo — passive

• The first time you descend into a new underground chunk, a one-line reading appears on screen:
  • "This area seems safe…"
  • "A low roar echoes here…"
  • "The walls shimmer faintly…" (diamonds or emeralds nearby)
  • "A whiff of sulfur in the air…" (lava nearby)

Underground Notes — craft it

Book + compass + ender pearl

• Right-click to open a survey book that logs your coordinates, depth and the in-game time, with an optional text note
• With 3+ marks it automatically sketches an ASCII overhead map of your waypoints
• Notes live inside the item — drop the book to hand your whole survey to a teammate

Crafting

• Geode Compass — 4 iron ingots + redstone + amethyst shard (shapeless)
• Abyssal Satchel — 3 iron ingots on top, leather + ender pearl below (shaped)
• Underground Notes — book + compass + ender pearl (shapeless)

Controls

• G — Glow Domain
• H — Shadow Breath
• Sneak + hold a tool — Echolocation
• Sneak + jump against a stone wall — Wall Cling
• All keys are rebindable under Options → Controls → Cave Roamer

Requirements

• Minecraft 26.2
• NeoForge 26.2.0.75 or newer (26.2.x)
• Java 25
• Works in single player and on servers — install on both sides

Balance Notes

Cave Roamer is deliberately not a power fantasy:

• Every skill costs energy, and energy only flows underground — go explore
• Glow Domain prevents spawns; it does not kill what already spawned
• The compass only finds naturally generated veins
• The satchel only compresses raw materials
• Surface camping earns you nothing

License & Modpacks

MIT licensed. Use it in any modpack — no permission needed. Bug reports and ideas are welcome!

洞穴漫游者 (Cave Roamer)

一款让你在黑暗中"如鱼得水"的生存辅助模组——不给你神器，但给你智慧。

洞穴漫游者奖励"往深处走"。探索洞穴来充能你的漫游值，再把它花在照亮黑暗、嗅探矿脉、压缩战利品和支撑长途探险的技能上。越深越强。

漫游值

• 经验条上方的紫色能量条，上限 100
• 地下（Y<40）缓慢恢复——地面永远不恢复
• 击杀怪物 +5；首次挖到每种矿石 +30（伴随金色粒子爆发）
• Y<-50 时恢复速度翻倍
• 所有主动技能都消耗漫游值；能量不足时能量条红闪提示

技能一览

辉光领域 — 按 G

15 漫游值 · 持续 45 秒 · 半径 12 格

• 柔和的蓝白色光芒笼罩周围（温和的夜视亮度 + 飘动的萤火虫粒子）
• 持续期间范围内敌对生物无法生成
• Y<0 时额外延长 10 秒
• 被怪群围住时的紧急避难所

地质罗盘 — 手持右键

8 漫游值 · 冷却 30 秒

• 指向 25 格内最近的天然矿脉（至少 3 块相连）
• 指针颜色分辨矿种：白=铁/铜/煤/石英 · 黄=金 · 蓝=钻石/绿宝石 · 红=红石/青金石 · 紫=远古残骸
• 玩家自己放置的矿石永远不会被检测——防作弊
• 屏幕上有方位盘显示方向与距离
• 辉光领域联动：只要 4 点、范围 35 格；Y<-30 时冷却缩短到 20 秒

深渊行囊 — 合成获得

皮革 + 末影珍珠 + 3 铁锭

• 存在于物品内部的独立 27 格空间
• 白名单原材料放入自动压块（9→1），取出自动还原：圆石/骨头/腐肉（自定义压缩物品）+ 原版存储方块（铁/金/钻石/煤/红石/青金石/绿宝石/石英/萤石/铜）
• 工具、武器、附魔物品拒收——只收原材料
• 在快捷栏选中时自动吸取脚边掉落物（每个 1 点漫游值，带蓝色粒子拖尾）

回声定位 — 被动

潜行 + 手持镐/剑/斧 · 需 20+ 漫游值 · 每秒 1 点

• 15 格内实体发出可穿墙的轮廓光晕：红=敌对、绿=动物、蓝=玩家
• 你只能看到"墙后有个红色的东西"，看不到它是什么
• 别再在转角撞见骷髅了

矿物余温 — 空手右键

3 漫游值

• 右键 5 分钟内被挖走矿石的位置：淡金色粒子轨迹指向最近的剩余矿脉
• 冰冷的山岩=最近没开采过，也不会扣费

岩壁攀附 — 被动

Y<40 · 贴墙按住 Shift+空格 · 每秒 2 点

• 像蜘蛛一样攀爬石头/深板岩/圆石构成的垂直墙壁
• 只限天然石壁——木板和砖块无效
• 掉进深坑？直接爬上来

暗影呼吸 — 按 H

启动 5 点 · 每秒 3 点 · 最多 20 秒 · 冷却 5 秒

• 期间所有饥饿消耗精确减半——包括疾跑
• 黑色雾气从屏幕边缘涌入，伴随缓慢的心跳声
• 长途探险和食物紧缺时的救命稻草

洞穴回响 — 被动

• 首次下探到新区块的地下时，屏幕浮现一行环境判读：
  • "这个区域似乎很安全……"
  • "这里回荡着低沉的咆哮……"
  • "墙壁闪烁着微光……"（附近有钻石或绿宝石）
  • "空气中有硫磺味……"（附近有岩浆湖）

地下笔记 — 合成获得

书 + 指南针 + 末影珍珠

• 右键打开测绘手册：记录坐标、深度和游戏内时间，可附加文字备注
• 标记 3 个以上地点自动生成字符俯视图
• 数据存在物品里——把书丢给队友，整套测绘记录一并移交

合成配方

• 地质罗盘 — 4 铁锭 + 红石 + 紫水晶碎片（无序）
• 深渊行囊 — 上排 3 铁锭，下排皮革 + 末影珍珠（有序）
• 地下笔记 — 书 + 指南针 + 末影珍珠（无序）

按键

• G — 辉光领域
• H — 暗影呼吸
• 潜行 + 手持工具 — 回声定位
• 贴石墙潜行+跳跃 — 岩壁攀附
• 所有按键可在 选项 → 按键设置 → 洞穴漫游者 中修改

环境要求

• Minecraft 26.2
• NeoForge 26.2.0.75 或更新（26.2.x）
• Java 25
• 单人/服务器均可——两端都装

平衡性说明

洞穴漫游者刻意不做数值神器：

• 所有技能都要漫游值，而漫游值只在地下流动——去探索吧
• 辉光领域阻止刷怪，不清除已有怪物
• 罗盘只找天然矿脉
• 行囊只压缩原材料
• 蹲家挂机一无所获

许可与整合包

MIT 许可。任意整合包可自由收录，无需额外授权。Bug 反馈与创意欢迎提出！