manbocull

Improve your Minecraft FPS via various culling methods

Manbo Cull


English Description

What is this

A performance mod that ports modern optimization techniques to Minecraft 1.12.2: stop rendering what you can't see, do pixel-art resolution scaling right, and defer bursty work instead of lagging. Every optimization is a toggleable option, split into an Optimization page (barely affects gameplay) and a Performance page (bigger impact, bigger gains), with a 1–5 level master knob and a one-click "reset to defaults".This mod requires MixinBooter

Features

  • HZB Occlusion Culling: builds a depth pyramid from the previous frame and skips chunks, entities and tile entities fully hidden behind terrain (results applied with one frame of latency).
  • Enclosed Plant Culling: grass/flowers/crops fully enclosed by opaque blocks generate no geometry at all.
  • Grass & Flower Density Culling: full density within 32 blocks; a checkerboard 2-of-4 pattern from 32–64 blocks; 1-of-4 beyond that. Subtractive only — flower colors, orientations and crop stages are preserved; deterministic jitter on the boundary; auto-rebuilds as you walk closer.
  • Underground Chunk Culling: skips whole underground sections behind a continuous solid cover.
  • Entity Cap with species weighting (crowded species get trimmed first).
  • Particle Optimization: per-type limits (nearest-first, outer-shell-first), distance merging, per-cell quotas.
  • Fluid Animation Culling: full-speed animation within 10 blocks, 25% speed in the distance, frozen off-screen (per-block sampling with smooth falloff).
  • Slow Lighting: debounces bursty light updates (explosions, flowing water) into one stable batch.
  • Entity Tick Scheduling: when entities exceed budget, the farthest ones tick last.
  • Chest Render Budget: renders only the nearest N (default 64) chests / ender chests / shulkers.
  • Sound Limiting: caps repeated sound plays in a short window.
  • Shadow Culling: distant mobs no longer render shadows.
  • Pixel-perfect Resolution Scaling: render-scale independent of the HUD, with distance blur + FSR1 upscaling/sharpening; blocky visuals stay crisp unless truly far away.
  • Experimental Fast Atlas: merges animated texture uploads into strips to cut per-frame texture uploads.

Compatibility

  • OptiFine coexistence mode: automatically steps back when OptiFine is detected (no framebuffer takeover, no HZB, no texture-animation gating — each individually re-enableable), fixing the black-screen-on-join issue.
  • FoamFix: detected and respected.
  • Full in-game config GUI (Mods → Manbo Cull → Config), with Chinese and English languages.

Ported from

BruteForceRenderingCulling (LGPL-3.0):https://www.curseforge.com/minecraft/mc-mods/brute-force-rendering-culling, 

RenderScale (MIT):https://www.curseforge.com/minecraft/mc-mods/renderscale, 

EntityCulling, FoamFix.

AI-assisted development

中文介绍

这是什么

一个把现代优化模组的核心思路移植到 1.12.2 的渲染优化模组:让 GPU 少画看不见的东西、把像素风的分辨率缩放做对、把高频的重复劳动攒起来再做。所有优化都做成可开关的选项,分成「优化」(几乎不影响体验)和「性能」(影响较大但提升也大)两页,并带 1~5 级总旋钮与一键恢复默认。本模组需要MixinBooter

功能一览

  • HZB 遮挡剔除:利用上一帧深度生成金字塔,剔除被地形完全挡住的区块、实体与方块实体(结果延迟一帧生效)。
  • 草花等片状植物剔除:六个方向都被不透明方块埋死的草/花/作物不再生成几何体。
  • 草地/花草密度剔除:32 格内完整渲染;32~64 格 2×2 留对角 2 棵;更远 2×2 留 1 棵(只删不增,花色/朝向原样保留,边界确定性抖动,走近自动补全重建)。
  • 地下区块剔除:按「连续实心覆盖」判定整段不可能被看到的地下区块。
  • 实体数量上限:带物种权重(同一个物种挤在一起优先合并数量)。
  • 粒子优化:每种粒子设上限(近的优先、球簇外层优先)、远距离合并、每格均分配额。
  • 流体动画剔除:10 格内全速动画、远处降到 25% 速度,视野外冻结(近场逐格采样,函数过渡)。
  • 缓慢光照:同一区块短时间高频光照刷新(爆炸/水流)先攒后算,不再一炸就卡。
  • 实体 tick 调度:实体数量超预算时,离玩家远的先排后面。
  • 箱子渲染预算:只渲染离玩家最近的 N 个(默认 64)箱子/末影箱/潜影盒。
  • 音效限流:短时间大量音效时设播放次数上限。
  • 实体阴影剔除:远处生物不再画阴影。
  • 像素风保真缩放:独立于 HUD 的渲染分辨率缩放 + 距离模糊 + FSR1 上采样/锐化,像素世界的方块保持紧凑清晰,只有真的很远才模糊。
  • 实验性快速材质:把图集动画上传合并成条带,减少每帧纹理上传次数。

兼容性

  • OptiFine 共存模式:检测到高清修复时自动退让(不接管帧缓冲、不做深度剔除、不拦贴图动画,均可单独打开),修复同装黑屏问题。
  • FoamFix:检测并让路。
  • 配置页为图形化界面(Mods → 曼波剔除 Manbo Cull → Config),支持中英文。

原理移植来源

BruteForceRenderingCulling(LGPL-3.0)、RenderScale(MIT)、EntityCulling、FoamFix。

本mod有使用AI进行辅助


manbocull Team

profile avatar
  • 1
    Projects
  • 25
    Downloads