Перейти к содержимому
Mineforgian

Replenish++

A QoL auto-replant feature inspired by Hypixel's Replenish enchantment, but without the enchantment restrictions. Toggle it on/off anytime and it works globally across all tools and crops.

Загрузки
88
Подписчики
1
Обновлён
12 июля 2026 г.
Лицензия
AGPL-3.0-only

Опубликован 28 июня 2026 г.

Исходный кодСообщить об ошибке

🚧 In Progress v7.0.0 Performance Overhaul The old architecture hit a hard wall. Having 10–25 farmers at once was tanking server TPS, so I'm completely rebuilding the backend. I’ve already ported the core over to PaperMC, but making sure it's 100% stable and actually scales is going to take some time. By bypassing heavy vanilla loot tables and batching inventory updates, the goal is to handle 100–200+ players farming simultaneously with zero lag. Flying solo on this, so I'm stress-testing everything properly before dropping the release. It'll be out once I know it won't melt your server.

Replenish++ 🌾

Auto-replant QoL plugin for Spigot/Paper, inspired by Hypixel's Replenish mechanic.

Preview

What it does

  • 🌾 Auto-replants Wheat, Carrots, Potatoes, Nether Wart, Cocoa, Beetroots
  • 🌱 Immature crops keep their current growth stage
  • 🎒 Optional seed consumption (on by default)
  • 📦 Optional direct pickup into your inventory (on by default)
  • 🪓 Requires the correct tool (Hoes / Axes)
  • 🧭 Correctly replants Cocoa with the proper facing
  • 🍀 Fortune enchantments works normally
  • 🔊 Fully configurable sounds

Quick install

  1. Drop the JAR into plugins/
  2. Start the server
  3. Edit plugins/Replenish/config.yml if desired
  4. Done.

Default behavior (no config edits)

  • Breaking a mature crop:

    • Replants at age 0
    • Consumes 1 seed from your inventory (or off-hand) if requirePlayerSeed is true
    • Drops go straight to you if directPickup is true

  • Breaking an immature crop:

    • Replants at the same age (no seed needed)

Commands & permissions

Command Description
/replenish status Show current settings
/replenish version Show plugin version
/replenish toggle Enable/disable the plugin
/replenish reload Reload the configuration

Permissions:

  • replenish.status (default: true)
  • replenish.version (default: true)
  • replenish.use (default: op)
  • replenish.toggle (default: op)
  • replenish.reload (default: op)
  • replenish.* (default: op)

Configuration

Common settings

enabled: true
requirePlayerSeed: true
directPickup: true
replantDelayTicks: 1
maxReplantsPerTick: 1024
checkUpdates: true
Full default config.yml
# ============================================
#         REPLENISH CONFIG
# ============================================

# --------------------------
# GENERAL SETTINGS
# --------------------------

config-version: 5              # DON'T TOUCH THIS!!!

enabled: true                  # master switch: false disables all replanting globally
requirePlayerSeed: true        # consume 1 seed from inventory on mature harvest
directPickup: true             # drops go straight to the player
replantDelayTicks: 1           # 1 tick = 50ms

maxReplantsPerTick: 1024      # maximum crops replanted per tick (20 ticks/second)
                              # raise this on beefier servers if replants lag behind
                              # lower it on weaker servers to reduce load

checkUpdates: true             # check GitHub for new releases on server startup

# --------------------------
# CROP TOGGLES (turn on/off)
# --------------------------

crops:
  wheat: true
  carrots: true
  potatoes: true
  nether_wart: true
  cocoa: true
  beetroots: true

# --------------------------
# CHAT MESSAGES (customize these)
# --------------------------
# Placeholders: {crop}, {tool}, {seed}, {count}

messages:
  inventory-full: "&8[&eReplenish&8] &8» &7Your inventory was full, so some items dropped on the ground instead."
  requires-tool: "&8[&eReplenish&8] &8» &7You need a &e{tool} &7to harvest &e{crop}&7."
  need-seed: "&8[&eReplenish&8] &8» &7You need &e{count}x {seed} &7in your inventory to replant this."

# --------------------------
# SOUND EFFECTS (customize or disable)
# --------------------------
# Each of the four feedback sounds can be individually enabled/disabled
# and customized with any Bukkit Sound, volume, and pitch.
#
# sound:  Must match a Bukkit Sound enum name (case-insensitive).
#         Full list: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
#         Invalid names log a warning and fall back to the default.
# volume: 0.0 (silent) to 1.0 (loudest)
# pitch:  0.5 (low) to 2.0 (high); 1.0 = normal
#
# To disable a sound entirely, set enabled: false.

sounds:
  # Played when harvested crops go into your inventory
  pickup:
    enabled: true
    sound: ENTITY_ITEM_PICKUP
    volume: 1.0
    pitch: 1.0

  # Played when your inventory is full and items drop on the ground
  inventory-full:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_BASS
    volume: 1.0
    pitch: 0.5

  # Played when you try to harvest without the required tool
  denied-tool:
    enabled: true
    sound: ENTITY_VILLAGER_NO
    volume: 1.0
    pitch: 0.5

  # Played when you try to harvest but lack a seed to replant
  denied-seed:
    enabled: true
    sound: ENTITY_VILLAGER_NO
    volume: 1.0
    pitch: 0.5

💡 Contributions & Pull Requests

Managing direct PRs gets a bit overwhelming for me, so I keep them disabled for this project to protect my peace. But I'm open to discussion! If you have a features, optimizations, bug fixes, improvements etc., open an issue first. We can chat about it there and see if it fits the project. Otherwise, you are highly encouraged to fork or clone this repo and do whatever you want with it. Vibe-code, rip it apart, and build what you want not what other people expect you to build. Everyone starts somewhere, and you are goated. You matter, so go start now.

License

This project is licensed under the GNU Affero General Public License v3.0.

Ченджлог

6.1.0Релиз26.1.1, 26.1.2, 26.2 · 12 июля 2026 г.

Replenish++ v6.1.0 – “Tuned to Perfection”

Release Date: 2026-07-12

🎵 Fresh Feedback

  • Customizable Sound Effects: Server owners can toggle these sounds on/off and choose from a variety of effects to match their server’s vibe.
  • Colored Console Logs: Important status messages, warnings, and errors now appear in distinct colors, making the console output much easier to scan at a glance.

⚡ Performance

  • Fixed a Stubborn Inventory Scan Bug: The seed-finding cache would sometimes rebuild itself on every single harvest when a player had no seeds in their inventory, causing unnecessary lag.

🛠️ Fixes & Improvements

  • Safer Offhand Handling: Added missing null checks for offhand items, preventing potential errors when a player had nothing in their secondary hand.
  • Gentler Config Updates: When your config file needs a migration, the console messages are now friendlier and clearly show the old → new version, reassuring admins that their custom settings are safe.

📚 Better Documentation

  • Readme Revamp: The readme now covers sounds, messages, and every config option in detail.
  • In-Depth Guide: A dedicated guide explains the plugin mechanics, commands, and usage patterns.
  • Clearer Contributing Rules: Updated bug report template and PR policy so contributors know exactly what’s expected.

Full Changelog: https://github.com/Mitra-88/Replenish/compare/6.0.0...6.1.0

Sea-Lion-Baby-Max-0001-8088
6.0.0Релиз26.1.1, 26.1.2, 26.2 · 8 июля 2026 г.

[6.0.0] – 2026-07-06

🚀 Now runs on everything!

  • From 1.17 to future versions: Replenish works on any Minecraft version from 1.17 up.

⚡ Better Performance

  • Crops replant quicker thanks to pre-cached block states.
  • Cocoa beans now have their own clean logic.
  • Default queue size changed to 1024 as most server won't reach the old limit 4096.

🛠️ Stability & Reliability

  • No More Console Flooding: Added smart warning throttling that groups identical errors together
  • Offhand Slot Fixed: Properly handles offhand items using the official API

💬 Messages & Communication

  • Sharper Chat Messages: All replant feedback messages are now clearer and more grammatically correct.
  • Smarter Version Detection: The /replenish version command now shows if you're running a development build or stable release, plus more detailed Java info.

📦 Configuration Changes

  • Project Website: Added plugin metadata link so users can easily find more info.

🚫 Removed

  • Decorative Flowers Removed: Torchflowers and pitcher plants are now treated as flowers, not replantable crops. Only crops grown from seeds on farmland will be replanted.

Compatibility

  • Requires a Bukkit, Spigot, or Paper server.
  • ✅ 26.2 - Replenish actively develops for and supports this version.
  • ⚠️ 1.17.1, 1.18.2, 1.19.4, 1.20.6, 1.21.11 and 26.1 - these versions are still supported, but are not a priority, and may be dropped in a future release.

Full Changelog: https://github.com/Mitra-88/Replenish/compare/5.4.1...6.0.0

5.4.1Релиз26.2 · 29 июня 2026 г.

Replenish v5.4.1 – "Faster & More Reliable"

Release Date: 2026-06-29

⚡ Better Performance

  • Smoothest Experience Yet: Replenish now runs faster and uses less memory, especially during large harvests. Crops are replanted more quickly with less strain on your server.

🛠️ Stability Fixes

  • No More Crashes: Fixed several issues that could cause the plugin to crash or freeze, especially in busy servers.
  • Fixed Replant Loops: Resolved a rare bug where certain crops would get stuck trying to replant over and over.
  • More Reliable Seed Tracking: The plugin now handles inventory changes better, preventing seeds from being missed when replanting.
  • Safer Reloads: The console now warns you if reloading the config interrupts any pending replanting tasks.

💬 Improved Messages

  • Clearer Error Messages: When a decorative flower can't be replanted, the message now clearly says "placed flower" instead of the confusing "decorative block."

Full Changelog: https://github.com/Mitra-88/Replenish/compare/5.4.0...5.4.1

5.4.0Релиз26.2 · 28 июня 2026 г.

Replenish v5.4.0 – "Smarter Farming"

Release Date: 2026-06-29

🌱 More Crops Supported

  • More Vanilla Crops: Replenish now supports Torchflowers, Pitcher Crops, and Beetroots.
  • Copper Tools: Copper Axes and Copper Hoes are now fully supported.

⚡ Better Performance

  • Runs More Efficiently: Reduced the amount of work Replenish performs behind the scenes, especially during large harvests.
  • Lower Resource Usage: Uses less memory and processes crop replants more efficiently.
  • Smoother on Busy Servers: Optimized several internal systems to keep farming responsive, even with lots of players harvesting at once.

🛠️ Fixes & Improvements

  • Fixed Rare Replant Loops: Resolved an issue that could cause certain crops to repeatedly attempt replanting.
  • Safer Reloads: The console now warns if pending replant tasks are interrupted during a configuration reload.

🔄 Stay Up to Date

  • Automatic Update Checks: Replenish can now notify server owners when a newer version is available.

Full Changelog: https://github.com/Mitra-88/Replenish/compare/5.3.0...5.4.0

Комментарии

Загружаем…