PickupPop
A lightweight, client-side pickup-notification mod for Minecraft 1.21.1 (Fabric). Every time you collect items, experience or a recovered arrow, a compact list pops up, merges repeat pickups into a single line, then slides and fades away.
Why this exists
Pick-up notifications are genuinely useful — but most implementations do more work than they need to on paths that run every frame. PickupPop keeps the behaviour people actually like and removes the fat:
- O(1) pickup merging instead of scanning the visible list for every pickup.
- Cached text + measured width, rebuilt only when a merged count changes — no per-frame text measuring.
- No extra fullscreen framebuffer for icon fades (the single most expensive per-frame operation in similar mods).
- No extra dependencies. Fabric Loader, Fabric API and Yarn only.
Features
- Item pickup notifications with icons, readable names and accurate quantities.
- Experience-orb notifications (orb count or total XP value).
- Recovered-arrow notifications.
- Merging modes:
ALWAYS,NEVER,EXCLUDE_NAMED(renamed stacks stay separate). - Configurable duration, screen corner, offsets, scale, text color, sprite/amount display and entry background.
- Fade and slide-out animations.
- Hard cap on visible entries and automatic cleanup on disconnect, respawn and world change.
- Full JSON configuration in
config/pickuppop.jsonthat survives restarts.
Requirements
- Minecraft Java Edition 1.21.1
- Fabric Loader 0.16.14+
- Fabric API
- Java 21
Client-side only — no server installation needed. Works on vanilla servers.
Installation
- Install Fabric Loader and Fabric API for Minecraft 1.21.1.
- Drop the PickupPop JAR into your
modsfolder. - Launch the game.
Configuration
config/pickuppop.json is created on first launch with these defaults:
| Option | Default |
|---|---|
includeItems / includeExperience / includeArrows |
true |
combineEntries |
EXCLUDE_NAMED |
displayTime |
80 ticks |
moveOut / moveTime / fadeAway |
true / 20 / true |
position |
TOP_LEFT (left edge, capped at half the screen height) |
scale / maxHeight |
4 / 0.5 |
maxEntries |
20 |
Relationship to other mods
PickupPop is an independent, clean-room adaptation inspired by Pick Up Notifier by Fuzs (https://www.curseforge.com/minecraft/mc-mods/pick-up-notifier), which is licensed under the Mozilla Public License 2.0. No upstream source file was copied; behaviour ideas only. PickupPop is not affiliated with or endorsed by the upstream authors.
Source code (MPL-2.0): https://github.com/Sekai0NI0itamio/PickupPop
Notes
Performance work is documented in the repository with unit tests and CI benchmarks. In-game frame-rate impact is not claimed without measurement.

