📊 Maykesh’s Server Observability Framework

Freemium • Release • PhaseZero Labs

The Freemium Release build is now live and uploaded.
This version introduces the new minimal GUI, collector toggles, sticky keybinding config menu, and baseline metric visualisation, completing the freemium feature set.

A formal observability and telemetry framework built exclusively for Fabric 1.21 servers.
This module instruments the full Minecraft server runtime and exposes structured telemetry for developers building optimisation tools, diagnostics, debugging utilities, or rate‑limiting systems. It provides unified resource attribution, modular collectors, and a central telemetry bus for deep server introspection — all without altering gameplay.

🟩 Build Status — Freemium Release

This build is now Freemium‑Release, providing:

• basic metrics
• core collectors
• telemetry bus
• commands
• config systems
• minimal GUI (new)
• sticky keybinding config menu (new)

The GUI is intentionally simple, raw, and debug‑style — designed to highlight the difference between Freemium and Premium.

Premium and Ultra‑Premium editions will feature a more advanced, more organised, and significantly more capable UI designed for deep analysis and production‑grade observability.

🖼️ Freemium GUI (Release)

Freemium UI Screenshots

PRESS F3

PRESS F3 + 2

PRESS F3 + 3

• Raw debug font
• No grouping or hierarchy
• No animations or transitions
• Minimal collector toggles
• Zero‑overhead rendering path

🎛️ Sticky Keybinding Config Menu

Freemium introduces a persistent configuration entry:

• Controls → Keybinds → Phase Zero Labs
• Entry: “Open Profiler Config”
• Default key: O
• Always visible
• Always accessible
• Opens the freemium configuration screen
• Premium replaces this with the full dashboard

This menu is intentionally simple — designed to feel like a lightweight debug tool rather than a full product.

🔗 External Links

Also available at:
https://modrinth.com/mod/maykeshs-server-observability-framework-mod

⚠️ Licensing & Redistribution

This project is licensed under CC BY‑NC‑SA 4.0.

If this mod is edited, modified, extended, or redistributed, the resulting work:

• must be provided for free
• must be published on GitHub
• must remain open‑source
• must credit both Maykesh and PhaseZero Labs
• must include a link back to the original CurseForge project page
• must NOT be used commercially
• must follow all other terms of the license

Any derivative version must clearly state that it is a fork and must link directly to this original CurseForge page.

🚀 Why Use This Framework?

• 📡 Full Runtime Instrumentation — Observe tick loops, entity updates, chunk activity, packet flow, async tasks, scheduler queues, worldgen events, and more.
• 🧩 Modular Collector System — 16 collectors, each independently toggleable through config or commands.
• 📁 Structured Telemetry Output — Export unified metrics via JSON files or in‑memory buffers.
• 🔌 Telemetry Bus API — Other mods can subscribe to real‑time events for custom tooling and integrations.
• 🧭 Command-Based Management — Enable, disable, reload, test, and inspect collectors directly in-game.
• 🛡️ Zero Gameplay Changes — Purely diagnostic; no mechanics, no balance changes, no player-facing impact.
• 🎯 Fabric 1.21 Only — Designed specifically for the 1.21 runtime and its updated APIs.
• 💠 Freemium Tier — Core collectors, telemetry, commands, config systems, and minimal GUI included.

📌 Recommended For

• Developers building optimisation tools
• Diagnostics and debugging environments
• Rate‑limiting and anti‑spam systems
• Monitoring dashboards and analytics pipelines
• Early-stage development and testing

Premium Edition recommended for advanced server owners and advanced players.

📜 Requirements

• Minecraft 1.21
• Fabric Loader 0.15.11+
• Fabric API 0.100.8+1.21
• Java 21
• Fabric Only — No Quilt, No Forge, No NeoForge

🧪 About PhaseZero Labs

Developed by Maykesh under PhaseZero Labs (pz.labs),
an organisation combining human expertise with AI‑assisted tooling to accelerate development, testing, and optimisation workflows for complex Minecraft mods.