Sculk Vision

See the invisible. Hunt the lag.

---

🔮 What is Sculk Vision?

Sculk Vision transforms the invisible world of chunk data into a stunning visual overlay. Inspired by the mysterious Sculk from the Deep Dark, this mod reveals the computational heartbeat of every chunk around you.

Press F6 and watch as colored overlays materialize on the terrain, showing you exactly where entities are clustering, where tile entities are accumulating, and where the Warden lurks.

---

✨ Features

🎨 Terrain-Following Overlays

Unlike other diagnostic tools that display flat boxes in the sky, Sculk Vision's overlays hug the terrain. Every hill, valley, and cliff is respected - the colored surface sits directly on top of the blocks, creating a beautiful topographic visualization.

🚦 Intuitive Color Coding

Color	Status	Meaning
🟢	Perfect	< 50 entities, < 10 tile entities
🟡	Warning	50-150 entities
🟠	Dangerous	150-300 entities
🔴	Critical	> 300 entities or > 50 tile entities
🟣	Loading	Chunk is being generated
🔵	Sculk	Warden detected or Sculk Catalyst active

📊 Floating Holograms

Each chunk displays a hovering hologram with:

• Entity count - Total entities in the chunk
• Tile entity count - Hoppers, chests, furnaces, etc.
• Estimated MSPT - Approximate tick time contribution
• Status indicator - Visual confirmation of chunk state

🌊 Sculk Waves

Critical chunks emit pulsating cyan waves that ripple outward, making lag sources visible from a distance. The Deep Dark aesthetic isn't just for show - it's functional.

✨ Sculk Particles

Watch as Sculk Soul particles rise from critical chunks and End Rod particles drift down over Sculk-active areas. Performance meets atmosphere.

📸 Screen Shake

Get too close to a critical chunk? Feel the lag. Subtle camera shake intensifies as you approach overloaded areas, giving you physical feedback about problem zones.

---

🎮 Controls

Key	Action
F6	Toggle Sculk Vision ON/OFF
F7	Enable for 10 seconds only

---

⚙️ Configuration

Full Mod Menu integration with adjustable settings:

• ✅ Toggle screen shake
• ✅ Toggle particles
• ✅ Toggle holograms
• ✅ Adjust overlay height offset
• ✅ Customize warning threshold (0-200 entities)
• ✅ Customize critical threshold (0-500 entities)

Configuration is saved to config/sculkvision.json

---

🎯 Use Cases

Server Administrators

Identify entity-dense chunks causing TPS drops without external tools.

Modpack Developers

Detect problematic mod interactions on a per-chunk basis.

Redstone Engineers

Find tile entity hotspots in complex contraptions.

Mob Farm Builders

Visualize entity accumulation in real-time to optimize kill chambers.

Performance Enthusiasts

Quantitative MSPT analysis for comparing hardware configurations.

---

📋 Technical Details

How It Works

1. Heightmap Sampling - 25 points sampled per chunk (5x5 grid) for smooth terrain following
2. Entity Counting - All entities within chunk bounds are tallied
3. Async Updates - Analysis runs in background thread every 8 ticks
4. Frustum Culling - Only visible chunks within render distance are processed

MSPT Estimation Formula

MSPT ≈ (entities × 0.05) + (tile_entities × 0.15) + (sculk_active ? 0.5 : 0)

Note: This is an approximation. Actual server tick times vary based on entity AI complexity and mod interactions.

Performance Impact

• Minimal overhead - Async analysis, efficient rendering
• View distance aware - Limited to 16 chunks maximum
• Smart culling - Distant chunks are simplified

---

📦 Requirements

• Minecraft 1.21.4
• Fabric Loader ≥ 0.16.0
• Fabric API (required)
• Mod Menu (optional, for configuration)

---

🔧 Compatibility

Mod	Status
Sodium	✅ Compatible
Iris Shaders	✅ Compatible
Lithium	✅ Compatible
ModernFix	✅ Compatible
Bobby	✅ Compatible

100% Client-Side - Safe for all servers, including vanilla and modded.

---

🐛 Found a Bug?

Report issues on GitHub

---

📜 License

CC-BY-NC 4.0

---

Peer into the computational abyss.
Let the Sculk reveal what was hidden.

⚡ SCULK VISION ⚡