MemGuard

模组

· 作者 SeishiroNagi

通过缓存 NBT 字符串、监控内存使用情况并在最佳时机触发垃圾回收,减少大型整合包和服务器中的 RAM 占用。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.4 · 1.21.1 · NeoForge

一键开服(送7天)

MemGuard

为长时间 Minecraft 会话提供轻量级内存行为优化。

MemGuard 是一款面向 Fabric / Forge / NeoForge(Minecraft 1.21.1)的轻量级实用模组,旨在减少可避免的对象分配,并使内存压力更易于观察。

MemGuard 的功能

1. 复用重复的短 NBT 字符串

  • Hook:NbtString.of(...)
  • 通过 LRU 缓存(最多 2048 个条目)复用重复的短值。
  • 这可以减少大型整合包中常见 ID/标签导致的重复对象分配。

2. 记录周期性堆快照

  • 从服务器刻上下文采样堆使用情况。
  • 当配置的使用阈值被超出时,会发出警告日志。
  • 主要用于提升可见性和故障排查,而非直接的性能声明。

3. 追踪纹理图集生命周期(客户端)

  • 在图集上传完成后,MemGuard 会在调试上下文中记录已使用的堆内存值。
  • 这有助于将加载阶段与内存行为进行关联分析。

技术说明

  • 使用 mixin hook 实现针对性行为(NbtCacheMixin、ServerChunkManagerMixin / ChunkCacheMixin、TextureCacheMixin)。
  • 无原生代码,无不安全内存访问。
  • 不使用 System.gc() 强制垃圾回收。

重要准确性说明

  • MemGuard 不保证固定的 FPS/MSPT/MB 提升。
  • 实际影响取决于整合包大小、实体/世界状态、JVM 厂商/标志以及会话时长。
  • 预期收益通常在具有重复 NBT 模式的中/大型整合包中更高。

可复现评估(推荐)

若要针对您的设置评估 MemGuard,请在相同条件下对比基线与启用 MemGuard 的情况:

  1. 相同的 Java 版本、JVM 参数、模组列表、世界种子和配置。
  2. 相同的运行窗口(建议每次运行 30-60 分钟)。
  3. 至少 3 次基线运行 + 3 次 MemGuard 运行。
  4. 收集可比指标:
  • p50/p95 MSPT(使用 spark 或类似工具)
  • 来自日志的堆使用趋势
  • 分配/GC 事件数据(使用 JFR 或类似工具)
  1. 比较分布情况(中位数/p95),而非单次峰值。

安装

Fabric

  1. 安装 Fabric Loader (0.16+)
  2. 安装 Fabric API
  3. 将 MemGuard jar 放入 mods/ 目录

Forge / NeoForge

  1. 安装与您 Minecraft 版本匹配的加载器
  2. 将 MemGuard jar 放入 mods/ 目录

兼容性

  • 设计用于与常见的优化模组共存。
  • 与任何基于 mixin 的模组一样,在生产部署前请测试您的确切整合包。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源