ChestObfuscator

Protect your server's loot from ChestESP users — no client mod required.

ChestObfuscator works entirely server-side. It intercepts chunk and block packets before they reach players, so hidden containers show up as stone from a distance and fake containers get injected to confuse ESP mods. The actual world is never touched — it's all packet-level.

---

---

How it works

Container Obfuscation

Containers beyond a configurable radius (default: 6 blocks) are replaced visually with stone for distant players. NBT data is hidden too, so ESP mods can't inspect inventories or loot tables.

Supported containers: Chests, Trapped Chests, Barrels, Shulker Boxes, Ender Chests, Hoppers.

---

Fake Containers

The plugin injects random fake containers underground inside stone areas to make ESP even less reliable.

• Each player gets a different set of fake locations
• Fakes disappear when players get close enough
• Makes it hard for players to compare or trust their ESP layout

Supported fake types: Chest, Barrel, Shulker Box, Ender Chest.

---

Honeypot Detection

The plugin watches for suspicious mining behavior near fake container positions. If a player repeatedly mines toward fake locations within a set time window, they get flagged — a console warning is logged and staff with the right permission receive an alert.

---

Performance

• Fake positions are cached, no repeated scans
• Packet handling is async and non-blocking
• Chunk overrides happen shortly after chunk load
• Designed to have no noticeable TPS impact

---

Commands

Command	Description
/chestobfuscator reload	Reload config
/chestobfuscator stats	View plugin stats
/co reload	Alias
/co stats	Alias

---

Permissions

Permission	Description
chestobfuscator.admin	Access admin commands
chestobfuscator.alert	Receive detection alerts

---

Config

reveal-radius: 6
fake-count-min: 5
fake-count-max: 12
fake-y-min: 20
fake-y-max: 50
fake-reveal-radius: 4
honeypot-enabled: true
honeypot-mine-radius: 3
honeypot-trigger-threshold: 3
honeypot-window-seconds: 600

---

Requirements

Requirement	Version
Paper	1.21.1+
ProtocolLib	5.3.0+
Java	21+

⚠️ ProtocolLib is required for packet interception.

---

Compatibility

Platform	Support
Paper	✅
Spigot	❌
Fabric	🔜 Planned
Forge	❌

---

Planned

• Per-world support
• Configurable fake container types
• Player whitelist system
• Discord webhook alerts
• Fabric version

---

FAQ

Does it affect performance? Not noticeably. Packet overrides are lightweight and data is cached.

Can players detect the fakes? Not easily through ESP. Fakes behave like real blocks until the player gets close enough.

Does it support Spigot? No. This plugin uses Paper-specific APIs.

---

Contact

📧 Email | ☕ Buy Me a Coffee

Developed by Penchi — pure server-side protection, no client mod needed.