Logo
Sculk Vision
ModCC-BY-NC-4.0

Sculk Vision

Visualize chunk performance with beautiful terrain-following overlays. See entity counts, tile entities, and lag sources in real-time. Sculk-themed with particles, waves, and floating holograms. 100% client-side.

656
Downloads
9
Followers
4 months ago
Updated
📦
4
Versions
game-mechanicsoptimizationutilityfabric
Download Latestv2.5View on Modrinth

📖About Sculk Vision

Sculk Vision

Sculk Vision Banner

See the invisible. Hunt the lag.

Fabric API
ModMenu
Client Side

🔮 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 ⚡