Modern Ground Items Stacker icon

Modern Ground Items Stacker -----

Smart ground-item stacking with HUD counts, deterministic piles, drop-shield pickup.



TFBMCItemStack — Ground Item Stacking for The Final Block
[​IMG]
Clean, modern ground-item piles with live counts. One pile per type. Deterministic spacing. Drop-shield pickup. Plug-and-play.

Overview
  • Built for “The Final Block” to keep long-term worlds tidy and readable.
  • Works out of the box on Spigot/Paper 1.21.8 (other forks fine via fallbacks).
  • Always shows the true amount on the ground (beyond 64) and gives that exact amount on pickup/hoppers.
  • No commands. No permissions. No config. Drop the jar in /plugins and restart.

Features
  • Live HUD counts above piles using TextDisplay (when available) with color tiers and compact numbers (64, 256, 1.2k, 3.4M). Vanilla nameplate fallback guarantees visibility on every fork.
  • One pile per item type. Identical items hard-merge into a single oldest anchor—no duplicate piles of the same thing.
  • Deterministic separation. Different item types auto-space to stable ring slots around the anchor; piles don’t overlap or flicker.
  • Drop-Shield pickup. After you drop items, an action-bar countdown prevents re-picking your own drops; timer refreshes on new drops; shielded items gently repel from the dropper.
  • Smart consolidation. Adaptive radius scales with pile size; reconsolidates after physics, player drops, block drops, hopper pulls, and chunk load. Deterministic anchor avoids tug-of-war.
  • Hopper support. Hoppers and hopper minecarts pull the real amount from ground piles; totals decrement accurately (all leftovers are summed).
  • Accurate player pickup. Inventory fill uses all leftovers—players get exactly what fits; the remainder stays on the ground and the HUD updates.
  • Visual polish. Subtle glow pulse on merges; themed particles per family (natural / mineral / magical).
  • Safety & cleanup. Anti-dupe merge path, extended lifetime for big piles, HUDs cleaned on despawn/remove, stale pointers auto-cleared.
  • Performance-friendly. Short, bounded merge passes; minimal allocations; no ticking tasks per item.

How it works (short)
Items that land near each other are partitioned by type. Each type collapses into a single “true” anchor showing a live count. Other types are nudged to deterministic ring positions so piles stay separate. On pickup/hopper pull, the exact amount is granted and the pile’s count decreases; when it hits zero, the HUD is removed.

Player Experience
  • Drop items → a clean pile with xamount above it (always visible).
  • Throw more of the same item → it always merges into that pile (no second pile).
  • Different items → form their own piles nearby, neatly spaced.
  • The Drop-Shield countdown prevents re-picking your own drops until it ends (timer refreshes on new drops).
  • Pick up anything → smooth animation + batched action-bar toasts like “+1.2k Stone, +384 Oak Log”.

Admin Notes
  • Zero setup. Drop the jar and restart.
  • Commands: none. Permissions: none. Config: none.
  • Compatible: Spigot/Paper 1.21.8 (common forks supported via fallbacks).
  • Piles beyond 512 items auto-extend lifetime to avoid despawns during long sessions.

Why this plugin?
A simple, clean, organized alternative to vanilla drops—purpose-built for The Final Block, but polished for any server that wants tidy ground items, accurate totals, and zero command/config overhead.
Resource Information
Author:
----------
Total Downloads: 7
First Release: Sep 25, 2025
Last Update: Sep 25, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings