XPMerge

---

XpMerge 1.0.0

Initial Release

The first public release of XpMerge. Built from the ground up for performance and correctness.

Introduced

• Interval-based orb sweeping — configurable tick interval triggers a full sweep of all loaded chunks across every world, collapsing nearby XP orb clusters into one
• Radius-based clustering — orbs within a set block radius of each other are merged, with total XP preserved exactly across the entire cluster
• Folia-native threading — sweep dispatches via GlobalRegionScheduler, with per-region entity access handled by RegionScheduler on the correct owning thread — no unsafe cross-region reads or writes
• Dupe-safe merge logic — orbs are re-validated immediately before removal to handle mid-sweep collection; XP is accumulated as a long and clamped to Integer.MAX_VALUE to prevent overflow
• Multi-world support — all loaded worlds are swept simultaneously each interval
• /xpmerge status — displays current interval, radius, debug mode, and total lifetime orbs merged
• /xpmerge reload — hot-reloads config and restarts the merge task with no server restart required
• xpmerge.admin permission — gates both commands, defaults to OP only
• Debug mode — optional console logging of every merge event with location, cluster size, and XP total; disabled by default

---