TrueClumps

TrueClumps

A Paper plugin for high-throughput mob farms. It packs clusters of small XP orbs into vanilla tiers (up to 73 XP per orb) so farm output is collected fast, without entity lag or despawn loss.

The problem

Players pick up one XP orb every 2 ticks, so at most 10 orbs per second. High-yield farms produce far more than that. The excess orbs sit around as entities, and many despawn after 5 minutes before the player can ever collect them.

Paper's own orb merging does not fix this. It stacks orbs into a higher count property instead of a higher XP value, and each count still triggers the 2-tick pickup delay. Collecting a merged orb takes just as long as collecting the orbs one by one.

TrueClumps replaces a batch of small orbs with real higher-tier vanilla orbs (1, 3, 7, 17, 37, 73 XP). Total XP is preserved exactly, and the farm output is picked up in seconds.

How it works

1. Orbs below `merge.below` XP (default 11) that drop within `radius` blocks (default 8) of each other are collected into a wave.
2. The wave flushes when no new orbs arrive for `window-ticks` (default 4) or when it reaches `max-wave-orbs` (default 64).
3. The wave's total XP is split into the smallest possible set of vanilla tiers and spawned as new orbs.
4. Output orbs are tagged (`trueclumps:packed`) so they are never repacked, and Paper's native orb merging is cancelled to keep them in single-count form.

Works out of the box, no config edit needed.

Configuration

Default `config.yml`:


# Ticks of silence before a wave is repacked.  
window-ticks: 4

# Max distance from a wave center for a new orb to join it.  
radius: 8.0

# Maximum orbs collected in a single wave before forcing a flush.  
max-wave-orbs: 64

merge:  
# Only orbs worth up to this much XP participate in merging.  
below: 11  
# Largest result orb va
max-tier: 73

# Enable console debug logging when orbs are packed.  
debug: false