Skip to content

Common Issues

Maurice Eisenblätter edited this page Apr 23, 2026 · 16 revisions

Users experience low FPS

In most cases, this issue is caused by the client-side rendering engine struggling to efficiently process highly fragmented terrain. A common way to mitigate this is to reduce the amount of air blocks used for obfuscation.

Lower the weight of cave_air, void_air, and air, or remove them from all randomBlocks sections in your config. There may be multiple sections to update. Air is used to disrupt cave-finding tools, so reducing it may slightly weaken that protection but improves performance.

A less aggressive option is to enable layer-based obfuscation. This provides a smaller FPS improvement but keeps block distribution more stable. Set layerObfuscation to true in each obfuscation config section. More info here

Orebfuscator doesn't hide entities (minecarts)

This is intended since the whole obfuscation engine that Orebfuscator uses is designed for hiding blocks not entities. (Meaning Orebfuscator will never support entity obfuscation)

I don't see any blocks obfuscated

This could have many reasons so here is a short checklist to see if you did anything wrong:

  • Check that the player doesn't have the orebfuscator.bypass permission
  • Check if you have installed the latest version of Orebfuscator and ProtocolLib for your game version
  • Check if there are any warnings in the console about a wrongly configured config
  • Check if you used the correct world names in the config

Still not working, check for existing issues our create a new one here

Clone this wiki locally