RestockRadar | Supply Chest Alerts [1.18.2-26.2]

Keep the spawn food barrel, event reward chest and shop supply chest supplied. Look at a container, choose an item and set its minimum. RestockRadar privately alerts administrators when that item runs low and when it has been restocked.

Try it in one command
Look at a single chest or barrel within six blocks:
Below 64 bread: LOW. Back to 64 or more: RESTOCKED. Staying low is quiet by default. The plugin never moves or creates items.

Features

• Named monitors for single chests, single trapped chests and barrels.
• Monitor different materials in the same container.
• One low alert per episode, followed by one recovery alert; optional reminders and cooldown.
• Loaded-chunk checks with a configurable per-tick work limit; no forced chunk loads.
• Unavailable containers show UNKNOWN instead of producing false zero-stock alerts.
• Administrator-only commands, coordinates and notifications.
• Saved monitors, validated reloads, atomic data replacement and configurable messages.
• No database, external plugin, telemetry or network service.

Installation

1. Stop your server. Place restockradar-1.0.0.jar in plugins/ and start it.
2. Join as an operator, or grant restockradar.admin to trusted staff.
3. Look at a supported container and run the example command above.
4. Run /rr status spawn_food to see the last observed stock and its age.
5. Customize plugins/RestockRadar/config.yml and apply with /rr reload.

Default polling is 100 ticks (about five seconds at 20 TPS); lag and the work budget can increase the delay.

Commands and permissions
Full command: /restockradar. Only add requires a player; other commands support the console. IDs use 1-32 letters, digits, underscores or hyphens and are saved lowercase. Minimum: 1-1,000,000. Use Bukkit material names such as BREAD; tab completion helps. To change a monitor, remove it and register it again. Duplicate container/material pairs are rejected.

Admin grants the notify child permission. Explicitly negate notify for staff who should manage monitors without chat alerts. Console alerts have a separate config toggle. Grant access only to trusted staff; this utility does not integrate with claims or shop ownership.

Configuration
Cooldown zero means disabled. Reminder zero means disabled; otherwise use 10-86400 seconds. The Documentation tab and bundled guides describe ranges and customizable message templates. Invalid configuration reloads keep the previous live settings.

Behavior to know

• Exactly the threshold is healthy. An initially healthy container sends no recovery alert. Restarting resets alert memory; a still-low container may alert again.
• Only online eligible staff receive chat alerts. There is no offline queue or login recap. Use /rr list when joining.
• Status is the last observation; check queues work without forcing a repeated alert.
• Double chests are unsupported. A registered chest that becomes double is paused until it is single again.
• Unloaded worlds/chunks, changed or missing containers, unopened loot containers and read errors show UNKNOWN. Unknown does not produce low/recovery events. Open generated loot containers normally before registration.
• Matching uses Material only. Named/enchanted variants count together; nested shulker/bundle contents are not counted.
• Monitors track world UUID, coordinates and container type. Moving a container needs re-registration; replacement with the same type at the same position resumes monitoring.
• Stop the server before manually editing monitors.yml. External changes during a run block add/remove saves until review and restart. Malformed monitor data is preserved and disables startup. Atomic filesystem replacement is required.
• No automatic restocking, economy integration, proxy or Folia support.

Multi-version compatibility and verification
Target range: Spigot/Paper 1.18.2-26.2. Compiled against Spigot 1.18.2, Java 17 bytecode. Use the Java version required by your server. Stable Bukkit APIs make a packet library unnecessary for these features.

43 module tests pass. Source compilation also passes against Spigot 1.19.4, 1.20.4, 1.20.6, 1.21.11, 26.1.2 and 26.2. The release JAR passes automated MockBukkit loading, lifecycle, reload and permission checks in 1.18.2, 1.21.11 and 26.2 API environments. These are simulated-server tests, not a live Minecraft gameplay or performance test, and do not verify every intermediate build. The Tested Major MC Versions field is left empty to avoid implying live-server verification.

Documentation, source and feedback
Open the JAR as a ZIP to find English and Chinese guides plus VERIFICATION.md in META-INF/docs/. Inspect or build the included standalone Maven source and tests in META-INF/source/ (mvn clean verify; JDK 17+).

Use Discussion for reproducible bugs and storage-workflow suggestions. Include the exact server build, Java version, plugin version, reproduction steps and relevant errors. Remove passwords and private information. All features are available without a rating or review.

1.0.0: Initial release. Developed with AI assistance; source is included for inspection. Author: AtBar. License: MIT. Open source contributions and practical feedback are welcome.