? Maykesh 的服务器可观测性框架(Freemium • Beta)
专为 Fabric 1.21 服务器构建的正式可观测性与遥测框架。
此 Freemium 模块对完整的 Minecraft 服务器运行时进行仪器化监控,并为开发者提供结构化的遥测数据,用于构建优化工具、诊断工具、调试实用程序或速率限制系统。它提供了统一的资源归因、模块化收集器和中央遥测总线,以实现深入的服务器内省——且完全不改变游戏玩法。
⚠️ 当前构建状态(Freemium‑Beta)
此构建为 Freemium‑Beta,包含:
- 基础指标,
- 核心收集器,
- 遥测总线,
- 命令,
- 配置系统,
- 暂无 GUI。
Freemium‑Release 版本(预计时间:约 3 天)将引入一个基本的、极简的功能性 GUI,旨在用于简单的收集器切换和基本指标查看。
Premium 和 Ultra‑Premium 版本将具备更高级、更有序且功能显著更强的 UI,旨在用于深度分析和生产级可观测性。
? 外部链接
在 CurseForge 上可供下载:
CurseForge 评论 / 反馈:
⚠️ 许可与再分发
本项目依据 CC BY‑NC‑SA 4.0 许可协议授权。
如果此模组被编辑、修改、扩展或重新分发,衍生作品必须:
- 免费提供,
- 发布在 Github 上,
- 保持开源,
- 同时署名 Maykesh 和 PhaseZero Labs,
- 包含指向原始 Modrinth 项目页面的链接,
- 不得用于商业用途,
- 遵守许可协议的所有其他条款。
任何衍生版本必须明确声明其为分支版本,并直接链接到此原始 Modrinth 页面。
⚠️ 推荐须知
此 freemium 版本非常适合开发、测试、诊断和轻量级可观测性场景。
不建议高级服务器管理员使用,
也不建议需要全规模分析、生产级导出器或深入运行时工具的高级玩家使用。
Premium Edition(包含强大的 UI、扩展的导出器和更深入的分析工具)计划于 1–4 周内发布。
高级用户应等待 Premium 版本以获得最佳体验。
? 为何使用此框架?
- ? 完整的运行时仪器化监控 — 观察.tick 循环、实体更新、区块活动、数据包流、异步任务、调度器队列、世界生成事件等。
- ? 模块化收集器系统 — 16 个收集器,每个均可通过配置文件或命令独立切换。
- ? 结构化遥测输出 — 通过 JSON 文件或内存缓冲区导出统一指标。
- ? 遥测总线 API — 其他模组可以订阅实时事件,以构建自定义工具和集成。
- ? 基于命令的管理 — 在游戏中直接启用、禁用、重载、测试和检查收集器。
- ?️ 零游戏玩法变更 — 纯诊断性质;无机制改动、无平衡调整、无面向玩家的影响。
- ? 仅限 Fabric 1.21 — 专门为 1.21 运行时及其更新的 API 设计。
- ? Freemium 层级 — 包含核心收集器、遥测、命令和配置系统。
Premium 功能(高级 UI、扩展的导出器、更深入的分析工具)不包含在此版本中。
✨ 功能
? 核心可观测性
- Tick 循环仪器化监控 — 监控 tick 持续时间和子系统成本。
- 实体更新 — 跟踪更新负载和行为指标。
- 区块加载 — 观察加载/卸载操作和内存压力。
- 数据包发送/接收 — 检查入站/出站数据包的频率。
- 方块与红石更新 — 识别更新密集区域。
- 世界生成事件 — 跟踪世界生成队列活动。
- 事件总线活动 — 检测模组/插件的事件泛滥。
- 线程池与异步任务 — 监控后台工作负载。
- 调度器队列 — 检查延迟任务和计划任务。
- 寻路与库存操作 — 将成本归因于高影响系统。
- 命令执行 — 分析命令处理过程。
- 异常检测 — 检测尖峰、洪水和失控循环。
?️ 配置与控制
- 热重载 — 无需重启服务器即可应用配置更改。
- 权限系统 — 完全可配置的 OP 等级要求。
- 配置文件
config/runtime-profiler.json
config/runtime-profiler-permissions.json
? 命令界面
/profiler help — 显示所有命令和收集器
/profiler list — 查看收集器状态
/profiler enable <collector> — 启用收集器
/profiler disable <collector> — 禁用收集器
/profiler toggle <collector> — 切换收集器
/profiler reload — 重载配置
/profiler metrics — 显示统一资源指标
/profiler test collectors — 运行诊断测试
? 适用对象
- 正在构建优化工具的开发者
- 诊断和调试环境
- 速率限制和反垃圾邮件系统
- 监控仪表板和数据分析管道
- 早期阶段开发和测试
不建议高级服务器管理员或高级玩家使用。
推荐使用 Premium Edition(1–4 周内发布)。
? 需求
- Minecraft 1.21
- Fabric Loader 0.15.11+
- Fabric API 0.100.8+1.21
- Java 21
- 仅限 Fabric — 不支持 Quilt、Forge 或 NeoForge
? 关于 PhaseZero Labs
由 Maykesh 在 PhaseZero Labs (pz.labs) 旗下开发,
该组织结合人类专业知识与 AI 辅助工具,以加速复杂 Minecraft 模组的开发、测试和优化工作流。
? Maykesh’s Server Observability Framework (Freemium • Beta)
A formal observability and telemetry framework built exclusively for Fabric 1.21 servers.
This freemium 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.
⚠️ Current Build Status (Freemium‑Beta)
This build is Freemium‑Beta, providing:
- basic metrics,
- core collectors,
- telemetry bus,
- commands,
- config systems,
- NO GUI yet.
The Freemium‑Release build (ETA: ~3 days) will introduce a basic, minimal, functional GUI designed for simple collector toggling and basic metric viewing.
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.
? External Links
Available for download on CurseForge:
CurseForge Comments / Feedback:
⚠️ 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 Modrinth 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 Modrinth page.
⚠️ Recommendation Notice
This freemium version is ideal for development, testing, diagnostics, and lightweight observability.
It is not recommended for advanced server owners
and not recommended for advanced players who require full‑scale analysis, production‑grade exporters, or deep runtime tooling.
A Premium Edition — featuring a powerful UI, extended exporters, and deeper analysis tools — is scheduled for release within 1–4 weeks.
Advanced users should wait for the premium version for the best experience.
? 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, and config systems included.
Premium features (advanced UI, extended exporters, deeper analysis tooling) are not included in this version.
✨ Features
? Core Observability
- Tick Loop Instrumentation — Monitor tick duration and subsystem cost.
- Entity Updates — Track update load and behaviour metrics.
- Chunk Loading — Observe load/unload operations and memory pressure.
- Packet Send/Receive — Inspect inbound/outbound packet frequencies.
- Block & Redstone Updates — Identify update-heavy areas.
- World Generation Events — Track worldgen queue activity.
- Event Bus Activity — Detect mod/plugin event spam.
- Thread Pools & Async Tasks — Monitor background workloads.
- Scheduler Queues — Inspect delayed and scheduled tasks.
- Pathfinding & Inventory Ops — Attribute cost to high-impact systems.
- Command Execution — Profile command processing.
- Anomaly Detection — Detect spikes, floods, and runaway loops.
?️ Configuration & Control
- Hot Reloading — Apply config changes without restarting the server.
- Permission System — Fully configurable OP level requirements.
- Config Files
config/runtime-profiler.json
config/runtime-profiler-permissions.json
? Command Interface
/profiler help — Show all commands and collectors
/profiler list — View collector status
/profiler enable <collector> — Enable a collector
/profiler disable <collector> — Disable a collector
/profiler toggle <collector> — Toggle a collector
/profiler reload — Reload configuration
/profiler metrics — Display unified resource metrics
/profiler test collectors — Run diagnostic tests
? 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
Not recommended for advanced server owners or advanced players.
Premium Edition recommended (1–4 weeks).
? 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧