DelightItemStacker — Enterprise-Grade Item Stacking Engine
DelightItemStacker is a high-performance, production-ready item stacking system engineered specifically for modern Paper 1.21+ servers. Built with scalability and gameplay integrity in mind, it delivers a seamless, DonutSMP-style stacking experience while aggressively reducing entity load and preserving server TPS under heavy conditions.
Core Systems
Intelligent Stack Merging
- Proximity-based merging using optimized spatial checks
- Strict item matching (type, meta, NBT-safe where applicable)
- Zero-risk merge logic — no duplication, no corruption
- Designed to operate efficiently even under high entity density
Controlled Stack Architecture
- Hard-capped stack size (default: 64 per entity)
- Automatic overflow splitting into additional stacks
- Prevents illegal stack sizes and client desync issues
- Maintains vanilla consistency while extending capability
Independent Despawn Lifecycle
- Each stack tracks its own despawn timer (default: 3 minutes)
- Merge logic preserves the oldest timestamp
- Eliminates timer abuse and item lifespan resets
- Built-in anti-hoarding safeguards
Precision Pickup Handling
- Full stack values are preserved on pickup
- Smart distribution into player inventory (respects slot limits)
- No overflow loss, no ghost items, no duplication
- Handles edge cases (full inventory, partial fits) cleanly
Dynamic Stack Visualization
- Real-time item display formatting:
- Diamond x32
- Cobblestone x64
- Clean, minimal, and fully configurable UI text
- Supports color codes and formatting styles
Performance Engineering
- Radius-based merge scheduler (NOT tick-based spam)
- Batched processing to minimize CPU overhead
- Significantly reduces entity counts in high-traffic areas
- Designed for:
- Large SMP servers
- Economy-heavy gameplay
- High concurrency environments
Anti-Lag & Integrity Layer
- Built-in lifecycle cleanup (despawn-aware clearing)
- Prevents infinite stacking exploits
- Fully synchronized merge + pickup pipeline
- Hardened against:
- Duplication glitches
- Stack corruption
- Timer manipulation
Administrative Toolkit
- /itemstackerrestack
→ Reprocess and optimize all ground items instantly - /itemstackerclearall
→ Hard-clear all dropped entities (lag emergency tool) - /itemstackerinfo
→ Inspect stack internals (amount, remaining time, metadata)
Deep Configuration
Highly modular configuration system:
- Merge radius tuning
- Despawn duration control
- Maximum stack size override
- Custom display formatting
- World-based enable/disable
- Item blacklist support
- Performance tuning options
Ideal Use Cases
- Survival SMP networks
- DonutSMP-style servers
- Economy-driven gameplay environments
- High-performance or large-scale communities
Why DelightItemStacker?
Unlike basic stackers, DelightItemStacker is engineered as a system, not a script:
- Deterministic behavior (no randomness, no bugs)
- Scales cleanly with player count
- Maintains vanilla feel while enhancing efficiency
- Built for long-term server stabilit
