MsptMap v1.1.0

MsptMap v1.1.0

新增

• 小地图热力图：同一套区块热力色可以叠加到 Xaero 小地图上（默认关闭，在设置中开启）
• Minecraft 1.21.10：新增独立构建（但 1.21.9 从此版本开始不支持，建议玩家升级至 1.21.10 游玩）

改进

• 弱加载区块（加载等级 32 及以上）默认显示为浅灰，不再占用热力色；可开启选项，让其中产生过可测耗时的区块仍按热力色显示
• 告警列表与地图使用同一套热力配色
• 降低多数支持版本的 Fabric API 下限，兼容更旧的 Fabric API 构建

修复

• 修复 Fabric Loader 0.20.0 与 Xaero 世界地图同时使用时的启动崩溃
• 修复 1.21.9+ 上实体计时读取维度失败的问题（1.21.9 起实体所在维度的方法名变更）

下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v1.1.0+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v1.1.0+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v1.1.0+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v1.1.0+1.21.4.jar
1.21.6–1.21.8	MsptMap-Fabric-v1.1.0+1.21.8.jar
1.21.10	MsptMap-Fabric-v1.1.0+1.21.10.jar
1.21.11	MsptMap-Fabric-v1.1.0+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v1.1.0+26.1.2.jar
26.2	MsptMap-Fabric-v1.1.0+26.2.jar
26.3	MsptMap-Fabric-v1.1.0+26.3.jar

Note

已在 Fabric Loader 0.20.0 下实机验证 1.20.1、1.21.4、1.21.8、1.21.10 与 26.x 构建。

MsptMap v1.0.1

Fixed

• Fixed a NoSuchMethodError crash when scanning on 1.21.9 and 1.21.10 servers

Improved

• Weak-loaded chunks (load level 32 and above) are now always shown in light grey by default and no longer take part in heat colouring; a new option colours the ones that spent time within the sampling window
• The overview panel folds load sources beyond the first three into a fourth row, and the panel or the expanded list becomes scrollable when taller than the screen
• Alert rows now use the same layout and colour ramp as the overview and hover details; their colour uses the same default red point as the overview TOP5

---

修复

• 修复 1.21.9 与 1.21.10 服务端扫描时的 NoSuchMethodError 崩溃

改进

• 弱加载区块（加载等级 32 及以上）默认一律淡灰、不再参与热力着色；新增「弱加载区块计时时染色」选项（默认关）
• 总览面板把前三条之外的加载源折叠到最后一行，展开后列出完整来源；面板或列表高于屏幕时右缘出现滚动条，滚轮翻动
• 告警行与总览、悬停详情使用同一套排版与热力色，红点取单区块默认阈值，与总览 TOP5 一致

Downloads / 下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v1.0.1+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v1.0.1+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v1.0.1+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v1.0.1+1.21.4.jar
1.21.6–1.21.10	MsptMap-Fabric-v1.0.1+1.21.10.jar
1.21.11	MsptMap-Fabric-v1.0.1+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v1.0.1+26.1.2.jar
26.2	MsptMap-Fabric-v1.0.1+26.2.jar
26.3	MsptMap-Fabric-v1.0.1+26.3.jar

注：本次更新中部分版本未经实机测试，可能会遇到 bug；如遇问题可更换至上个版本，并欢迎通过 issue 反馈，十分感谢。
Note: Some versions in this update have not been tested on actual devices and may encounter bugs; if you experience any issues, you can switch back to the previous version, and feedback via issues is warmly welcome. Thank you very much.

MsptMap v1.0.0

New

• Scan overview panel: totals across the three dimensions, load sources and the five costliest chunks, with click-to-locate on the map
• Optional monitoring (/msptmap monitor, off by default): auto-scans on overload and alerts the chosen audience
• Operator commands: scan, access <ops|all> and monitor. Operators only by default; /msptmap access all opens it to every player
• Added English localisation, following the game language automatically
• The settings screen is split into scan / colours / hover subpages

Improved

• Hover details and the overview use tiered styling
• Chunks holding a load ticket are outlined, and the tooltip names the ticket with its @x,z

---

新增

• 扫描总览面板：三维度合计、加载源与最重五个区块等等，并可点击后在地图自动定位
• 常态化监控（/msptmap monitor，默认关）：超载时自动扫描并告警指定受众
• 操作员命令：scan、access <ops|all> 与 monitor。默认仅 OP，/msptmap access all 开放给所有玩家
• 新增英语适配，随游戏语言自动切换
• 设置界面拆为扫描 / 颜色 / 悬停三个子页

改进

• 悬停详情与总览采用分层配色
• 持有加载票的区块描边，提示中给出票据名与 @x,z
• 计时类别更加丰富，计时更加精准，计时开销更小

Downloads / 下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v1.0.0+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v1.0.0+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v1.0.0+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v1.0.0+1.21.4.jar
1.21.6–1.21.10	MsptMap-Fabric-v1.0.0+1.21.10.jar
1.21.11	MsptMap-Fabric-v1.0.0+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v1.0.0+26.1.2.jar
26.2	MsptMap-Fabric-v1.0.0+26.2.jar
26.3	MsptMap-Fabric-v1.0.0+26.3.jar

注：本次更新中部分版本未经实机测试，可能会遇到 bug；如遇问题可更换至上个版本，并欢迎通过 issue 反馈，十分感谢。
Note: Some versions in this update have not been tested on actual devices and may encounter bugs; if you experience any issues, you can switch back to the previous version, and feedback via issues is warmly welcome. Thank you very much.

MsptMap v1.0.0-beta.1

New

• Scan overview panel: totals across the three dimensions, load sources and the five costliest chunks, with click-to-locate on the map
• Optional monitoring (/msptmap monitor, off by default): auto-scans on overload and alerts the chosen audience
• Operator commands: scan, access <ops|all> and monitor. Operators only by default; /msptmap access all opens it to every player
• Added English localisation, following the game language automatically
• The settings screen is split into scan / colours / hover subpages

Improved

• Hover details and the overview use tiered styling
• Chunks holding a load ticket are outlined, and the tooltip names the ticket with its @x,z

---

新增

• 扫描总览面板：三维度合计、加载源与最重五个区块等等，并可点击后在地图自动定位
• 常态化监控（/msptmap monitor，默认关）：超载时自动扫描并告警指定受众
• 操作员命令：scan、access <ops|all> 与 monitor。默认仅 OP，/msptmap access all 开放给所有玩家
• 新增英语适配，随游戏语言自动切换
• 设置界面拆为扫描 / 颜色 / 悬停三个子页

改进

• 悬停详情与总览采用分层配色
• 持有加载票的区块描边，提示中给出票据名与 @x,z

Downloads / 下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v1.0.0-beta.1+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v1.0.0-beta.1+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v1.0.0-beta.1+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v1.0.0-beta.1+1.21.4.jar
1.21.6–1.21.10	MsptMap-Fabric-v1.0.0-beta.1+1.21.10.jar
1.21.11	MsptMap-Fabric-v1.0.0-beta.1+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v1.0.0-beta.1+26.1.2.jar
26.2	MsptMap-Fabric-v1.0.0-beta.1+26.2.jar
26.3	MsptMap-Fabric-v1.0.0-beta.1+26.3.jar

注：本次更新中除 26.2 版本，其余版本均未经实机测试，可能会遇到 bug；如遇问题可更换至上个版本，并欢迎通过 issue 反馈，十分感谢。

Note: only the 26.2 build has been tested in-game. The other builds are untested and may contain bugs; roll back to the previous release if needed, and please report problems via an issue.

MsptMap v0.3.1

Changes

• Fixed the chunk details not showing on hover when other mods such as Xaero Head Tracker are installed
• Fixed the console scan getting stuck when the server pauses while empty (no players online)
• Fixed a client crash on scan data of an unexpected size; it now reports a failure instead
• The scan progress ring now fills up to 100%
• Scans now have a 2-second cooldown between runs
• Hover details now use the same number format on every system
• Compatibility: unsupported mod versions no longer crash the game on startup; optional dependencies fall back gracefully
• Various performance and stability improvements: faster scanning, cached hover details, less per-frame work
• Documentation, code and repository cleanup

---

改动

• 修复与 Xaero Head Tracker 等其他模组同装时，鼠标悬停区块看不到详情的问题
• 修复服务器长时间无人、自动暂停后，控制台扫描一直卡住的问题
• 修复扫描数据大小异常时客户端崩溃的问题，现改为提示失败
• 扫描进度环现在会填满 100%
• 两次扫描之间新增 2 秒冷却
• 悬停详情的数字格式在所有系统上保持一致
• 兼容性：不支持的模组版本不再导致启动崩溃；缺少可选依赖时自动降级
• 若干性能与稳定性优化：扫描更快、悬停详情缓存、每帧开销更低
• 文档、代码与仓库整理

Downloads / 下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v0.3.1+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v0.3.1+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v0.3.1+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v0.3.1+1.21.4.jar
1.21.6–1.21.10	MsptMap-Fabric-v0.3.1+1.21.10.jar
1.21.11	MsptMap-Fabric-v0.3.1+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v0.3.1+26.1.2.jar
26.2	MsptMap-Fabric-v0.3.1+26.2.jar
26.3	MsptMap-Fabric-v0.3.1+26.3.jar

注：此次更新中除26.2版本，其余版本均未经实机测试，可能会遇到bug，如遇到问题，可以更换至上个版本（如有问题希望可以通过issue反馈，十分感谢）

MsptMap v0.3.0

Minecraft 1.20–1.21.11 support added. The hover details now name the load ticket behind each chunk's levels, client and server versions no longer need to match, and the mod includes a new project icon.

Changes

• Minecraft 1.20–1.21.11 support added; 1.20.5, 1.20.6, 1.21.5 are not supported for the time being
• Hover details show the load ticket behind the load and compute levels; 1.21.4 and earlier have no queryable ticket table and show levels only
• Client and server versions no longer need to match: the scan still runs when they differ, with a chat note that the result may be inaccurate; an incompatible packet reports a failure instead of disconnecting the player
• New project icon, shown in the Mod Menu list
• Default scan duration changed from 5 to 2 seconds
• Jar names now follow the <mod version>+<highest supported Minecraft version> convention, e.g. MsptMap-Fabric-v0.3.0+1.20.2.jar

---

新增 Minecraft 1.20–1.21.11 支持。悬停详情显示各区块等级背后的加载票；客户端与服务端版本不一致时改为尽力运行；并新增模组图标。

改动

• 新增 Minecraft 1.20–1.21.11 支持；1.20.5、1.20.6、1.21.5 暂不支持
• 悬停详情显示加载等级与计算等级背后的加载票；1.21.4 及以前的游戏没有可查询的票表，只显示等级
• 客户端与服务端版本不一致时不再拒绝，尽力运行：照常出结果，并提示结果可能不准；数据包不兼容时提示失败，不会掉线
• 新增模组图标，Mod Menu 模组列表可见
• 默认扫描秒数由 5 秒改为 2 秒
• jar 命名改为 MsptMap-Fabric-v<版本>+<最高支持版本>.jar 格式，如 MsptMap-Fabric-v0.3.0+1.20.2.jar

Downloads / 下载

Minecraft	Jar
1.20–1.20.2	MsptMap-Fabric-v0.3.0+1.20.2.jar
1.20.3–1.20.4	MsptMap-Fabric-v0.3.0+1.20.4.jar
1.21–1.21.1	MsptMap-Fabric-v0.3.0+1.21.1.jar
1.21.2–1.21.4	MsptMap-Fabric-v0.3.0+1.21.4.jar
1.21.6–1.21.10	MsptMap-Fabric-v0.3.0+1.21.10.jar
1.21.11	MsptMap-Fabric-v0.3.0+1.21.11.jar
26.1–26.1.2	MsptMap-Fabric-v0.3.0+26.1.2.jar
26.2	MsptMap-Fabric-v0.3.0+26.2.jar
26.3	MsptMap-Fabric-v0.3.0+26.3.jar

Note: 0.2.2 and earlier use different packet IDs and do not interoperate with this release; update the client and the server together.
注：0.2.2 及更早版本与本版的协议包 ID 不同，不互通；升级时请同时更新客户端与服务端。

MsptMap v0.2.2

Minecraft 26.1 and 26.3 support added. Extends sampling to seven timing categories, and adds per-chunk entity counts, a settings screen and scan progress reporting.

Changes

• Minecraft 26.1 and 26.3 support added
• Sampling extended from five to seven categories: block updates and block events are now measured alongside random ticks, scheduled ticks, block entities, entities and mob spawning
• Per-chunk entity count added to the hover details
• Settings screen added, reachable from Mod Menu or via /msptmap config: scan duration, red threshold, opacity, relative colour mode, weak-chunk display and hover-detail lines. Changes take effect immediately and are stored in config/msptmap-client.properties
• Progress ring rendered on the border of the scan button, with progress supplied by the server; scan status is reported in chat
• Default red threshold set to 1.5 mspt; all units are expressed as mspt
• Version compatibility enforced between client and server: a mismatch produces a chat message and does not disconnect the player

Fixes

• Single-player: the sampling window is now counted in game ticks
• Hover details no longer overlap Xaero's own tooltip while the cursor is over a widget
• Heatmap and progress ring are cleared on disconnect

Downloads

• Minecraft 26.1 / 26.1.1 / 26.1.2 — MsptMap-Fabric-26.1.2-v0.2.2.jar
• Minecraft 26.2 — MsptMap-Fabric-26.2-v0.2.2.jar
• Minecraft 26.3 — MsptMap-Fabric-26.3-v0.2.2.jar

---

新增26.1与26.3版本支持。采样类别扩展至七类，新增每区块实体数、设置界面与扫描进度报告。

改动

• 新增26.1与26.3版本支持
• 采样类别由五类扩展至七类：在随机刻、计划刻、方块实体、实体和刷怪之外，新增方块更新与方块事件
• 悬停详情新增每区块实体数
• 新增设置界面，可从模组菜单进入或经 /msptmap config 打开：扫描秒数、红色阈值、不透明度、采用相对模式、显示弱加载区块、悬停详情各行。改动即时生效，存于 config/msptmap-client.properties
• 新增扫描进度圈，绘制于扫描按钮边框，进度由服务端推送；扫描状态在聊天栏报告
• 默认红色阈值调整为 1.5 mspt，所有单位统一为 mspt
• 强制客户端与服务端版本一致：不一致时于聊天栏提示，不会断开连接

修复

• 单人档：采样窗口改按游戏刻计算
• 鼠标位于控件上时，悬停详情不再与 Xaero 自身的提示框重叠
• 掉线时清空热力图与进度圈

下载

• Minecraft 26.1 / 26.1.1 / 26.1.2 —— MsptMap-Fabric-26.1.2-v0.2.2.jar
• Minecraft 26.2 —— MsptMap-Fabric-26.2-v0.2.2.jar
• Minecraft 26.3 —— MsptMap-Fabric-26.3-v0.2.2.jar

MsptMap v0.1.0

First public release.

Features

• Per-chunk MSPT heatmap on Xaero's World Map (green → yellow → red)
• Server-side sampling of five kinds of tick work: random ticks, scheduled ticks, block entities, entities and mob spawning; the results are sent to the client that started the scan
• Start a scan with the button at the top-left corner of the map (or /msptmap scan [seconds]); ✕ clears the heatmap
• Hover a chunk for details: coordinates, load level, compute level, time per category
• Weakly-loaded chunks are painted pale grey

Installation

• Requires Minecraft 26.2, Fabric Loader 0.19.3+ and Fabric API
• Install on both the server and the client (in single-player both sides run on the same machine, so one copy is enough)
• Xaero's World Map is also required on the client
• Optional Mods: Carpet (permission check via the commandMsptMap rule), Mod Menu (settings entry)

---

首个公开版本。

功能

• 在 Xaero 的世界地图上按区块显示 MSPT 热力图（绿 → 黄 → 红）
• 服务端采样五类工作耗时：随机刻、计划刻、方块实体、实体、刷怪；结果发给发起扫描的客户端
• 地图左上角按钮开始扫描（或 /msptmap scan [秒数]），✕ 清空热力图
• 悬停区块看详情：坐标、加载等级、计算等级、各类耗时
• 弱加载区块显示淡灰底

安装

• 需要 Minecraft 26.2、Fabric Loader ≥ 0.19.3 和 Fabric API
• 服务端和客户端都要装（单人档两边同机，装一份即可）
• 客户端还需要 Xaero 的世界地图
• 可选联动模组：Carpet（用 commandMsptMap 规则判权限）、Mod Menu（设置入口）