Occlura

About

Occlura helps staff review suspected X-ray mining without automatically punishing players.

It records useful mining data in the background. Staff can inspect detection statistics, follow a player’s previous route, see where valuable ores were mined, or replay a flagged mining session using a player-like NPC.

Everything is staff-only, configurable, and designed for manual review.

Detection

Occlura checks several mining patterns instead of relying on a simple ore counter:

• Frequent disconnected ore discoveries
• Very few blocks mined between valuable veins
• An unusually high valuable-ore yield
• Repeated sharp direction changes between finds

When enough patterns line up, Occlura creates a flag and alerts staff.

A flag is not an automatic ban. It is a reason for staff to take a closer look.

Analyze a Player

Occlura displays the player’s recent route as a clean particle trail. It also places staff-only glowing outlines where the player mined diamond ore or ancient debris.

Dimension-based visuals

• Overworld — natural green, gold, and earth colors
• Nether — fire, crimson, ash, and lava effects
• End — purple void and portal effects

Analysis also works for offline players while their history is still retained.

Use `off` to hide the current analysis. Use `tp` to teleport to the beginning of the trail.

Mining Replays

When a player is flagged, Occlura preserves movement from before the flag and continues recording afterward.

The replay uses Paper’s native mannequin entity and includes:

• The player’s skin
• Position and view direction
• Smooth movement
• Sneaking, swimming, and gliding
• Held items
• Mining swings and block-break effects
• The player’s trail and mined-ore markers

Only the investigating staff member can see the replay NPC and investigation effects.


Replay controls

A small action-bar timer shows the current playback position and whether the replay is paused.

Inspect Mining Statistics

The inspection command displays:

• Tracked blocks
• Valuable blocks
• Separate ore veins
• Blocks mined per vein
• Valuable-block percentage
• Sharp direction changes
• Current detection score
• Supporting evidence

Persistent Logging

Every flag is saved with:

• Player name and UUID
• Flag type
• Timestamp
• Detection score
• Supporting evidence

Flag logs remain available after normal server restarts.

Discord Integration

Occlura can send flags to a Discord channel through an incoming webhook. No Discord bot or additional Minecraft plugin is required.

The role mention is optional.

Webhook requests are asynchronous, respect Discord rate limits, restrict allowed mentions, and never print the secret webhook URL in the server console.

Configurable History

All look-back and retention values are kept in one section:

Particle density, replay sampling, saved-session limits, detection thresholds, and tracked valuable blocks can also be adjusted.

Commands

Permissions

Both permissions default to server operators.

Requirements

• Paper 26.1
• Java 25

Occlura uses Paper-specific APIs. It will not run on Spigot or older Minecraft versions.