Replenish++ ?
Paper/Purpur 服务器上的自动补种功能。破坏作物后,它会立刻重新种植。
如果你曾在 Hypixel SkyBlock 中玩过 farming(农业),那你一定了解这个概念——那就是 Replenish,那个让种田不再完全令人痛苦的附魔。
功能说明
- 自动重新种植小麦、胡萝卜、马铃薯、下界疣、可可豆和甜菜根
- 未成熟的作物会保持其原有的生长阶段
- 收获成熟作物时从你的物品栏中消耗一颗种子(可关闭此功能)
- 可以将掉落物直接传入你的物品栏而非地面(也可切换)
- 你手中必须持有正确的工具才能触发自动补种。没有锄头就无法补种。可可豆需要斧头。
- 破坏作物时按住潜行键可完全跳过自动补种(可通过
sneakToBypass 配置项切换)
- 可可豆会以正确的朝向重新种植,这之前一直是个让人头疼的问题
- 幸运魔咒正常工作
- 音效完全可配置,或者你可以选择全部静音
- 专为大型农场优化设计,不会造成卡顿。你可以调整每刻(tick)的补种上限。
安装
- 从 Modrinth、Releases(推荐使用 Modrinth)或 Actions 标签页获取 jar 文件(如果你喜欢使用开发版构建)
- 将其放入
plugins/ 文件夹
- 启动服务器
- (可选)自定义
plugins/ReplenishPlusPlus/config.yml,默认设置即可正常使用。
来自 Replenish 6.x? 请先删除旧的 Replenish jar 文件和整个 plugins/Replenish/ 文件夹(包括旧的 config.yml)。该插件已重建并重命名,因此旧数据不会迁移,同时运行两个版本会导致作物被重复补种两次。
默认行为(未修改配置)
成熟作物:
- 作为新种植的作物重新种植(年龄为 0 / 刚种植状态)
- 从你的物品栏或副手槽中消耗 1 颗种子(如果
requirePlayerSeed: true)
- 掉落物直接进入你的物品栏(如果
directPickup: true)
未成熟作物:
- 以相同的年龄重新种植。不需要种子。
- 也不会产生掉落物,否则你可以通过反复破坏年轻作物来无限刷种子。
命令与权限
| 命令 |
功能 |
/replenishplusplus |
主菜单 |
/replenishplusplus help |
详细指南 |
/replenishplusplus status |
当前设置 |
/replenishplusplus version |
插件版本及更新状态 |
/replenishplusplus toggle |
个人开关(开启/关闭) |
/replenishplusplus toggle global |
全局开关(开启/关闭) |
/replenishplusplus pad |
获取传送垫物品 |
/replenishplusplus reload |
重载 config.yml |
/replenishplusplus debug queue |
查看补种队列统计 |
别名:/rpp 和 /replenish 可用于上述所有命令。
权限:
replenishplusplus.use - 所有人
replenishplusplus.status - 所有人
replenishplusplus.version - 所有人
replenishplusplus.toggle - 所有人
replenishplusplus.toggle.global - OP
replenishplusplus.reload - OP
replenishplusplus.debug - OP
replenishplusplus.pad - OP(仍在完善中,但欢迎玩家使用)
replenishplusplus.update - OP
replenishplusplus.* - OP(授予以上所有权限)
关于传送垫的说明: /rpp pad 仍在开发中,因此仅限 OP 使用。不过它已经可以工作了,所以如果你想在你的基地周围放置传送点,可以随时将 replenishplusplus.pad 权限授予你信任的玩家。
配置
你可能会用到的部分:
enabled: true
requirePlayerSeed: true
directPickup: true
sneakToBypass: true
messageStyle: CHAT
replantDelayTicks: 3
maxReplantsPerTick: 1024
maxReplantsQueued: 4096
checkUpdates: true
注意: /rpp toggle global 会从最后一次加载的状态将整个 config.yml 写回。如果你手动编辑了文件,请先运行 /rpp reload,否则切换操作会覆盖你的手动更改。
玩家在聊天中看到的所有内容都位于 plugins/ReplenishPlusPlus/en_us.yml 中,使用 MiniMessage 格式,同样通过 /rpp reload 生效。
完整默认 config.yml
# ==============================================================================
# ReplenishPlusPlus 配置
# ==============================================================================
# 整个插件的主开关。false = 任何人都不会自动补种。
# 玩家仍可以使用 /rpp toggle 仅为自己关闭它。
enabled: true
# true = 收获完全成熟的作物时,会从你的物品栏中消耗 1 颗种子并重新种植。
# false = 作物免费补种,不涉及种子。
requirePlayerSeed: true
# true = 收获掉落物直接进入你的物品栏。
# false = 掉落物像原版一样掉落在地面上。
directPickup: true
# true = 破坏作物时按住潜行键可完全跳过自动补种。
# 作物会正常破坏并掉落,就像没有安装插件一样。
sneakToBypass: true
# 插件如何向玩家发送提示(背包已满、需要种子、工具错误等)。
# CHAT = 普通聊天消息。
# ACTION_BAR = 热键栏上方,减少刷屏。
# NONE = 完全不显示文本(音效仍然播放)。
messageStyle: CHAT
# 破损作物在被补种前的最大延迟时间,单位为刻(ticks)。20 刻 = 1 秒。
# 每次补种会在 1 到该数值之间的随机刻执行,从而均匀分散补种工作,而不是批量处理,
# 这样较大的值也能保持流畅。
# (1 到 10)
replantDelayTicks: 3
单次刻内最大重新种植数量,以防止有人通过一次性收割大型农场导致服务器卡顿。(最小值 256)
maxReplantsPerTick: 1024
同时等待在队列中的最大重新种植数量。如果队列已满,多余的重新种植将被丢弃,而不是堆积起来导致服务器卡顿。(最小值 256)
maxReplantsQueued: 4096
启动时检查 Modrinth 是否有新版本并通知管理员?
如果无法访问 Modrinth,则回退到 GitHub。
仅在启动时读取 - /rpp reload 不会对此项应用更改。
checkUpdates: true
------------------------------------------------------------------------------
作物设置
------------------------------------------------------------------------------
将任意一项设置为 false 以关闭该作物的自动重新种植功能。
crops:
wheat: true
carrots: true
potatoes: true
nether_wart: true
cocoa: true
beetroots: true
------------------------------------------------------------------------------
声音设置
------------------------------------------------------------------------------
声音名称比较宽容——ENTITY_ITEM_PICKUP、entity.item.pickup 和
minecraft:entity.item.pickup 都可以正常工作。未知的名称会记录警告并回退到默认值。完整列表:
volume: 0.0(静音)到 1.0(最大音量)
pitch: 0.5(低)到 2.0(高),1.0 = 正常
设置 enabled: false 可完全禁用某个声音。
sounds:
作物掉入你的背包中。
pickup:
enabled: true
sound: ENTITY_ITEM_PICKUP
volume: 1.0
pitch: 1.0
你的背包已满,剩余物品掉落在地上。
inventory-full:
enabled: true
sound: BLOCK_NOTE_BLOCK_BASS
volume: 1.0
pitch: 0.5
你尝试使用错误的工具进行收割。
denied-tool:
enabled: true
sound: ENTITY_VILLAGER_NO
volume: 1.0
pitch: 0.5
你尝试收割但没有种子用于重新种植。
denied-seed:
enabled: true
sound: ENTITY_VILLAGER_NO
volume: 1.0
pitch: 0.5
重新种植失败,你的种子被退回而不是被种植。
replant-failed:
enabled: true
sound: ENTITY_ITEM_BREAK
volume: 0.5
pitch: 1.0
</details>
## 贡献
本仓库已禁用 PR(Pull Request),并不是我不需要你的帮助,而是对于一个人来说管理它们过于繁重,我也不想对任何人“已读不回”。请改为提交 Issue,无论是功能建议、Bug 报告还是优化方案,我们可以在那里讨论。
## 许可证
本项目采用 [CC BY-NC-SA 4.0](https://github.com/Mitra-88/ReplenishPlusPlus/blob/7.x.x/LICENSE.txt) 许可证:需署名,仅限非商业用途(禁止出售或付费墙),衍生作品必须使用相同的许可证。想要出售或将其用于商业目的?请联系 Mitra-88 获取许可。
Replenish++ ?
Auto-replant for Paper/Purpur. Break a crop, it goes right back in the ground.
If you ever farmed on Hypixel SkyBlock, you already know the idea, it's Replenish, the enchantment that made farming not completely miserable.
What it does
- Replants Wheat, Carrots, Potatoes, Nether Wart, Cocoa, and Beetroots automatically
- Immature crops stay at whatever growth stage they were at
- Eats a seed from your inventory on mature harvest (can turn this off)
- Can pipe drops straight into your inventory instead of the ground (also toggleable)
- You actually need the right tool in hand. No hoe, no replant. Cocoa needs an axe.
- Sneaking while you break bypasses auto-replant entirely (toggleable via
sneakToBypass)
- Cocoa gets replanted facing the right direction, which was annoying to get right
- Fortune works like normal
- Sounds are fully configurable, or you can just mute them all
- Built to not choke on big farms. There's a per-tick replant cap you can tune.
Install
- Grab the jar from Modrinth, Releases (using Modrinth is recommended), or the Actions tab if you like living on dev builds
- Drop it in
plugins/
- Start the server
- (Optional) Customize
plugins/ReplenishPlusPlus/config.yml, the default settings work fine as-is.
Coming from Replenish 6.x? Delete the old Replenish jar and the whole plugins/Replenish/ folder first, old config.yml included. The plugin was rebuilt and renamed, so nothing carries over, and running both versions at once would replant crops twice.
What happens by default (no config changes)
Mature crop:
- Replants as a newly planted crop (age 0 / just planted)
- Takes 1 seed from your inventory/off-hand (if
requirePlayerSeed: true)
- Drops go to you directly (if
directPickup: true)
Immature crop:
- Replants at the same age it was. No seed needed.
- No drops either, otherwise you could farm infinite seeds by re-breaking young crops.
Commands & permissions
| Command |
What it does |
/replenishplusplus |
Main menu |
/replenishplusplus help |
Detailed guide |
/replenishplusplus status |
Current settings |
/replenishplusplus version |
Plugin version & update status |
/replenishplusplus toggle |
On/off switch for yourself |
/replenishplusplus toggle global |
On/off switch for everyone |
/replenishplusplus pad |
Get a Teleport Pad item |
/replenishplusplus reload |
Reload config.yml |
/replenishplusplus debug queue |
View replant queue stats |
Aliases: /rpp and /replenish work for everything above.
Permissions:
replenishplusplus.use - everyone
replenishplusplus.status - everyone
replenishplusplus.version - everyone
replenishplusplus.toggle - everyone
replenishplusplus.toggle.global - op
replenishplusplus.reload - op
replenishplusplus.debug - op
replenishplusplus.pad - op (still WIP, but players are welcome)
replenishplusplus.update - op
replenishplusplus.* - op (grants all of the above)
A note on Teleport Pads: /rpp pad is still a work in progress, which is why it's op-only. It already works though, so if you want warp pads around your base, feel free to give the replenishplusplus.pad permission to players you trust.
Config
The stuff you'll probably touch:
enabled: true
requirePlayerSeed: true
directPickup: true
sneakToBypass: true
messageStyle: CHAT
replantDelayTicks: 3
maxReplantsPerTick: 1024
maxReplantsQueued: 4096
checkUpdates: true
Note: /rpp toggle global writes the whole config.yml back from the last-loaded state. If you edited the file by hand, run /rpp reload first, otherwise toggling saves over your manual changes.
Everything players see in chat lives in plugins/ReplenishPlusPlus/en_us.yml MiniMessage formatting, same /rpp reload applies it.
Full default config.yml
# ==============================================================================
# ReplenishPlusPlus Configuration
# ==============================================================================
# Master switch for the whole plugin. false = nothing replants for anyone.
# Players can still turn it off just for themselves with /rpp toggle.
enabled: true
# true = harvesting a fully grown crop eats 1 seed from your inventory and replants it.
# false = crops replant for free, no seeds involved.
requirePlayerSeed: true
# true = harvest drops go straight into your inventory.
# false = drops fall on the ground like vanilla.
directPickup: true
# true = sneaking while breaking a crop skips auto-replant completely.
# The crop just breaks normally and drops like it would without the plugin.
sneakToBypass: true
# How the plugin talks to players (inventory full, need seed, wrong tool).
# CHAT = normal chat message.
# ACTION_BAR = above the hotbar, less spammy.
# NONE = no text at all (sounds still play).
messageStyle: CHAT
# Max delay before a broken crop gets replanted, in ticks. 20 ticks = 1 second.
# Each replant lands on a random tick between 1 and this number, which spreads
# the replant work evenly instead of batching it, so bigger values stay smooth.
# (1 to 10)
replantDelayTicks: 3
# Max crops replanted in a single tick, so nobody can lag the server by
# harvesting a giant farm all at once. (Minimum 256)
maxReplantsPerTick: 1024
# Max replants waiting in the queue at once. If the queue is full, replants get
# dropped instead of piling up and lagging the server. (Minimum 256)
maxReplantsQueued: 4096
# Check Modrinth for a new version on startup and tell admins?
# Falls back to GitHub if Modrinth can't be reached.
# Only read on startup - /rpp reload won't apply changes to this.
checkUpdates: true
# ------------------------------------------------------------------------------
# Crop Settings
# ------------------------------------------------------------------------------
# Set any of these to false to turn auto-replant off for that crop.
crops:
wheat: true
carrots: true
potatoes: true
nether_wart: true
cocoa: true
beetroots: true
# ------------------------------------------------------------------------------
# Sound Settings
# ------------------------------------------------------------------------------
# Sound names are forgiving - ENTITY_ITEM_PICKUP, entity.item.pickup and
# minecraft:entity.item.pickup all work. An unknown name logs a warning and
# falls back to the default. Full list: https://jd.papermc.io/paper/org/bukkit/Sound.html
# volume: 0.0 (silent) to 1.0 (loudest)
# pitch: 0.5 (low) to 2.0 (high), 1.0 = normal
# Set enabled: false to kill a sound completely.
sounds:
# Crops landed in your inventory.
pickup:
enabled: true
sound: ENTITY_ITEM_PICKUP
volume: 1.0
pitch: 1.0
# Your inventory was full and leftovers dropped on the ground.
inventory-full:
enabled: true
sound: BLOCK_NOTE_BLOCK_BASS
volume: 1.0
pitch: 0.5
# You tried harvesting with the wrong tool.
denied-tool:
enabled: true
sound: ENTITY_VILLAGER_NO
volume: 1.0
pitch: 0.5
# You tried harvesting but had no seed to replant with.
denied-seed:
enabled: true
sound: ENTITY_VILLAGER_NO
volume: 1.0
pitch: 0.5
# A replant failed and your seed got dropped back instead of planted.
replant-failed:
enabled: true
sound: ENTITY_ITEM_BREAK
volume: 0.5
pitch: 1.0
Contributions
PRs are disabled on this repo, not because I don't want your help but because managing them gets overwhelming for one person, and I'd rather not ghost anyone. Open an issue instead, feature ideas, bugs, optimizations, whatever. We'll talk it out there.
License
This project is licensed under the CC BY-NC-SA 4.0: credit required, non-commercial only (no selling or paywalls), forks must use the same license. Want to sell it or use it commercially? Ask Mitra-88 for permission.
评论 0
登录后参与评分
还没有评论,来抢沙发吧