Tungsten

Tungsten Benchmark

Tungsten is a comprehensive, precise, and passive observability and benchmarking tool for Minecraft (Fabric).

Unlike optimization mods that attempt to alter game logic, Tungsten focuses entirely on giving you accurate, real-time analytics to help you diagnose exactly *why* your game feels laggy. We strictly observe game state without modifying server packets, ticking, or engine loops, ensuring full compliance with both Modrinth guidelines and strict server rules.

What Does Tungsten Track?

Tungsten provides a clean, smooth in-game HUD overlay (`/tungsten toggle`) alongside an active file-logging suite (`/tungsten log start`) that measures performance across three critical pillars: Hardware, Memory, and Network.

🎮 Frametime & Hardware Analytics

Relying on standard FPS numbers hides micro-stutters. Tungsten intercepts the core render loop to track precise microsecond delays between frames: * Stutter Detection * Stutter Detection: Identifies if your framerate is consistently dropping during intense moments. * Stutter Detection: Accurately counts how many times your game drops below a playable 20fps equivalent (>50ms frame time).

🧠 JVM Memory Monitoring

Minecraft lag is frequently caused by Java Garbage Collection sweeps. * Live Memory Footprint: Watch your real-time Used Memory vs Max Allocated Memory to instantly identify if GC spikes are the exact cause of your recorded frame drops.

🌐 Advanced Network & Server Metrics

Stop wondering if the lag is your PC, your internet, or the server hardware. * Action Routing Delay (RTT): By tracking the delta time between the server's dispatched `WorldTimeUpdate` packets, Tungsten accurately estimates if the host server itself is lagging behind 20.0 TPS. * Action Routing Delay (RTT): Tracks exactly how many chunks your client is downloading per second to help identify choked internet bandwidth. * Action Routing Delay (RTT): Passively evaluates your connection stability, tracking extreme ping variance and highest jitter percentages. * Action Routing Delay (RTT): Hooks into packet confirmations to determine your physical input latency when breaking blocks or hitting entities.

Active Logging

Need to benchmark a new optimization mod or compare two shaderpacks? Run `/tungsten log start`. Tungsten will silently begin graphing every extreme high, explicit low, standard deviation, and stutter that occurs while you play.

Run `/tungsten log stop` to automatically crunch the data and generate an exhaustive `.txt` report inside your `tungsten-benchmarks/` directory, giving you permanent mathematical proof of how smooth your game truly was during that window.

Technical Transparency

*Per Modrinth's Content Rules regarding performance data:* * Data Gathering Mechanics: Tungsten is exclusively a read-only analytics dashboard. It does not contain game-altering engine tweaks to improve your gameplay. * Data Gathering Mechanics: FPS and lows are calculated via a `MinecraftClient.render` mixin capturing true `System.nanoTime()` deltas. Server TPS is mathematically derived client-side via `WorldTimeUpdateS2CPacket` intervals. All data gathered is directly represented without arbitrary modifiers algorithms.