ForestPlant AUTO-REPLANTING CROPS & SAPLINGS - ForestPlant

厌倦了手动补种农作物和树苗吗？想要一个可自定义的轻量级插件吗？ForestPlant 正是你所需要的！

本插件能自动补种农作物和树苗，包括甘蔗、仙人掌和竹子。它支持按玩家组进行详细配置，兼容各类领地保护系统，并且消息完全可翻译。

💡主要特性

• 自动补种：自动补种农作物和树苗，支持甘蔗、仙人掌、竹子及紫颂植物。
• 工具限制：可配置仅允许特定工具触发补种。
• 生长阶段控制：可设定仅补种完全成熟的农作物。
• 保护系统兼容：通过模拟玩家放置行为，兼容各类领地保护插件。
• 权限绕过：可在配置文件中启用权限绕过功能。
• 分组配置：大多数选项可按玩家组进行自定义。
• 多语言支持：所有消息均可翻译。

🎮安装与配置

安装步骤

• 将 ForestPlant.jar 放入服务器的 plugins 文件夹。
• 重启服务器。
• 编辑 plugins/ForestPlant 目录下的配置文件（详见下方配置说明）。
• 重启服务器 或 使用 /fplant reload all 命令重载插件。

配置文件概览

config.yml 主要选项：

• lang：设置语言文件，默认为 en（对应 messages_en.yml）。
• enabledByDefault：是否默认启用插件功能（不影响权限检查）。
• playerSaplingDropDelay：玩家丢弃树苗后尝试补种的延迟时间（秒）。
• liveSaplingDropChance：树叶 decay 时掉落“活性树苗”的几率（百分比）。
• liveSaplingDropCheckTime：检查“活性树苗”是否落地的持续时间（秒）。
• groups：玩家组配置区。请勿删除默认的 default 组。

分组配置项 (groups.<group_name>)：

• canUse：该组玩家是否能使用插件功能。
• replantPlayerSaplingDrops：是否补种玩家丢弃的树苗。
• disabledSaplingsWorlds / disabledCropsWorlds：禁用树苗/农作物补种的世界列表。
• bypassSaplingsPermissions：是否绕过保护系统权限检查。
• saplings：可补种的树苗列表。使用 NONE 表示不补种任何树苗。
• fullyGrownCropsOnly：是否仅补种完全成熟的农作物。
• allowedCropsTools：允许用于收割农作物的工具列表。使用 ALL 允许所有工具（包括空手），使用 NONE 禁用该组的农作物补种。
• crops：可补种的农作物列表。使用 NONE 表示不补种任何农作物。

🔧命令与权限

可用命令

• /fplant

- 切换该玩家的自动补种功能开关。

• /fplant reload [msg|all]

- 重载消息文件 (`msg`) 或整个插件 (`all`)。

权限节点

• forestplant.reload

- 允许使用 `/fplant reload` 命令。

• forestplant.group.<group_name>

- 将玩家分配到指定的配置组（组名见 `config.yml`）。

- **注意：** `default` 组会自动授予所有玩家。

❓常见问题与支持

使用条件

• 未经许可，不得反编译代码。
• 未经许可，不得重新分发或上传本插件及其文件。
• 不得向他人提供本插件的下载。
• 您可以在您所有的服务器上使用本插件。

获取支持

如有任何疑问、建议或需要支持，请通过 Discord 联系我们！

• 请注意： 请勿在评论区域报告漏洞或寻求技术支持！Discord 是我们提供支持最快的方式，我们很乐意帮助你。

简介

ForestPlant 是一款功能强大的 Minecraft 插件，它允许玩家通过种植特定的树木来高效地获取资源。插件提供了多种可配置的树木类型，每种树都能在生长时掉落自定义的物品，极大地丰富了生存和资源收集的玩法。

💡功能特性

• 自定义树木：种植多种预配置的树木，如橡树、云杉、丛林树等。
• 自动资源生成：树木生长成熟时，会自动掉落预设的物品。
• 高度可配置：通过配置文件轻松调整每种树木掉落的物品、数量、概率以及生长所需条件。
• 支持物品：掉落物支持原版物品、自定义物品（需配合 ItemsAdder 等插件）以及货币（Vault）。
• 生长条件：可设置树木生长所需的特定环境，如下方方块类型、光照等级、所需空间及所需工具。
• 事件与权限：支持设置种植/破坏权限，并可触发自定义事件以便与其他插件联动。

🎮命令与权限

命令

• /forestplant 或 /fp：打开插件主菜单。
• /forestplant give <player> <tree> [amount]：给予指定玩家特定类型的树苗。
• /forestplant reload：重载插件配置文件。

权限

• forestplant.use：允许使用 /forestplant 命令打开菜单。（默认：true）
• forestplant.admin：允许使用所有管理命令，如给予和重载。（默认：op）
• forestplant.tree.<tree_name>：允许玩家种植特定类型的树木。（例如：forestplant.tree.oak）

🔧配置指南

插件的核心配置位于 plugins/ForestPlant/trees.yml 文件中。你可以在此定义和管理所有树木类型。

创建一棵新树

• 在 trees.yml 中复制一份现有树木的配置作为模板。
• 修改 name 字段作为树木的唯一标识符。
• 配置 display_name（在菜单中显示的名称）和 lore（描述）。
• 在 drops 部分定义树木成熟时掉落的物品列表。

掉落物配置示例

drops:
  - type: "ITEM" # 类型：ITEM, COMMAND, MONEY
    id: "DIAMOND" # 物品ID（对于原版物品）
    amount: 1
    chance: 50 # 掉落概率（百分比）

• type: "COMMAND"：可以执行控制台命令，使用 {player} 占位符代表玩家名。
• type: "MONEY"：需要 Vault 支持，给予玩家游戏内货币。

生长条件配置

在 growth_requirements 部分可以设置：

• block_below：树苗下方必须为的方块类型。
• light_level：所需的最低光照等级。
• required_space：树木生长所需的垂直空间高度。
• required_tool：收获（破坏）树木所需的工具（可选）。

✨安装与依赖

安装步骤

• 将 ForestPlant.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需求编辑 plugins/ForestPlant/trees.yml 配置文件。
• 使用 /forestplant reload 命令或重启服务器以应用配置更改。

可选依赖

• Vault：如需使用 MONEY 类型的掉落物，必须安装。
• ItemsAdder 或 Oraxen：如需掉落自定义物品，必须安装其一。
• PlaceholderAPI：用于在物品名称和描述中使用占位符。

❓常见问题

• 树木不生长/不掉落物品？

- 检查树木的 `growth_requirements` 配置（如下方方块、光照、空间）是否满足。

- 检查服务器日志是否有错误信息。

- 确保你拥有种植该树木的权限（`forestplant.tree.<tree_name>`）。

• 如何让树木掉落自定义物品？

- 安装 ItemsAdder 或 Oraxen 并创建你的自定义物品。

- 在掉落物配置中将 `type` 设为 `"ITEM"`，并将 `id` 设置为该自定义物品的内部ID。

• 支持哪些 Minecraft 版本？

- 插件支持 Spigot/Paper 1.16.x 至 1.20.x 版本。请使用与你的服务器版本相匹配的插件版本。

• 如何获得树苗？

- 拥有 `forestplant.admin` 权限的玩家可以使用 `/forestplant give <player> <tree>` 命令。

- 可以通过配置将树苗添加到创造模式物品栏或商店插件中。

- 可以设置破坏已生长的 ForestPlant 树木时返还树苗。

如需更多帮助，请访问插件的官方 Wiki 页面。