// FarmCraft - FarmCraft

💡FarmCraft

你是否想过创建可以随时间推移而视觉化生长的自定义作物？有了 FarmCraft，现在你可以了！如果与 FoodLol 或 UltimateFoods 结合使用，你甚至可以创建可种植、可食用的自定义食物！FarmCraft 的种子和普通种子一样，需要耕地（即土壤/农田）才能种植。

🎮要求与依赖

• DecentHolograms (可选，用于显示全息信息)

✨主要功能

• 可自定义的种子物品：你可以修改原版种子的信息以匹配你的需求，也可以使用完全自定义材质的物品，让它看起来像一个真正的新种子。
• 可配置的生长条件：自定义种植种子所需的光照强度、水源半径和玩家经验等级。
• 可自定义的生长时间：每种作物都可以设置独立的生长时间（以秒为单位）。
• 可自定义的生长阶段：
• 你可以在生长过程的特定百分比节点，自定义作物顶部的材质，以视觉化地展示生长变化。
• 你还可以自定义作物在特定生长阶段被破坏时的掉落物。
• 全息信息显示：右键点击作物可以查看一个全息信息，显示种植者、当前生长百分比以及当前阶段破坏作物的潜在掉落物。
• 可自定义的作物基底：自定义每个作物的基底方块，实现视觉多样性。
• 跨插件兼容性：可以指定与其他插件（如 UltimateFoods）物品相同的物品，从而创建完全可食用的自定义作物。
• 自定义头颅材质：无需自定义资源包，即可为物品使用完全自定义的颅骨材质。
• 支持颜色渐变文本：在 RGB 和 LCH 色彩空间中使用颜色渐变（格式说明见下文）。
• 可自定义的基底方块：不再强制使用树叶作为基底，可以自由选择。
• 苦力怕爆炸自动支持：作物能正确处理苦力怕爆炸事件。
• 支持自定义持久化数据：通过 YML 物品创建，支持与其他创建自定义食物或饮料的插件进行兼容。
• 可自定义的插件消息：通过 messages.yml 文件，服务器可以自定义插件的所有提示信息。
• 耕地保持：种植作物后，耕地不会退化成泥土，会保持耕地状态。

🔧命令与权限

• /farmcraft seedfix
• 权限：无
• 说明：此命令用于将背包中所有同种种子合并为一组。由于种子最初被设计为自定义材质的工具（默认只能单组堆叠），此命令现已过时，因为自定义材质不再需要工具类型。

• /farmcraft list
• 权限：farmcraft.admin
• 说明：列出所有当前已加载的作物配置。

• /farmcraft reload
• 权限：farmcraft.admin
• 说明：重载插件配置。

• /farmcraft give <crop> (player) (amount)
• 权限：farmcraft.admin
• 说明：给予指定玩家指定数量的某种作物种子。
• 参数：

- `<crop>`: 作物名称（必填）。

- `(player)`: 玩家名（可选，默认为命令执行者）。

- `(amount)`: 数量（可选）。

• /farmcraft purge <crop>
• 权限：farmcraft.admin
• 说明：从世界中移除所有指定的作物。

⭐配置基础

每种作物的配置都从以下基本结构开始

Grow_Time:
Seed:
Harvests:

你还可以根据需要添加以下可选配置

Required_Light:
Require_Water_Radius:
Required_XP:
Leaf_Block_Material:

参数说明：

• Grow_Time：作物完全生长所需的时间（秒）。
• Seed：用于种植该作物的物品。物品配置详见下文。
• Harvests：收获阶段的配置。详见下文。
• Required_Light：0-15 的数字，表示作物生长位置所需的光照等级。
• Require_Water_Radius：搜索水源方块的最远距离（半径）。
• Required_XP：玩家种植时必须拥有的经验值数量。
• Leaf_Block_Material：作物基底方块的材质。仅为美观，建议选择易于破坏的材质以实现更真实的“作物”行为。

⭐物品配置详解

粗体为必填项，非粗体为可选项。

id: DIRT # 物品ID (必填)
amount: 1 # 数量
name: "Dirt" # 显示名称
lore: # 描述文本
  - "Lore Line 1"
  - "Lore Line 2"
enchantments: # 附魔列表
  - "aquaaffinity:1"
  - "sharpness:5"
  # 完整的附魔列表请查阅：
  # https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
tags: # 特殊标签
  - "textureskull:SKINVALUE" # 自定义头颅材质值
  - "playerskull:\PLAYERNAME" # 玩家头颅
  - "vanilladurability:256" # 原版耐久度
  - "unbreakable:true" # 不可破坏
  - "custommodeldata:1234567" # 自定义模型数据
  - "enchantglow:true" # 附魔光效
flags: # 物品标志（隐藏属性）
  - "HIDE_ATTRIBUTES"
  - "HIDE_ENCHANTS"
attributes: # 属性修饰符
  - "ATTRIBUTE:VALUE:OPERATION"
  - "ATTRIBUTE:VALUE:OPERATION:SLOT"
  # 属性名称：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/Attribute.html
  # 操作类型：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/attribute/AttributeModifier.Operation.html
  # 装备槽位：https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/EquipmentSlot.html
custompersistentdata: # 自定义持久化数据（用于跨插件兼容）
  - "namespace:key:value"

⭐收获阶段 (Harvests) 配置

Harvests 代表作物生长周期的各个阶段。每个阶段以一个随机标识符（例如 1）开始。

Harvests:
  1:

每个收获阶段**必须**包含以下配置

percent: # 生长百分比 (1-100)
headtexture: # 此阶段作物顶部的材质

重要：你必须包含一个 0% 和一个 100% 的生长阶段配置。 此外，你还可以选择性地添加任意数量的物品作为此阶段的掉落物，物品配置方式同上。

关于 headtexture：

• 你可以从 https://minecraft-heads.com 等网站获取自定义头颅的材质值。
• 若想配合资源包使用完全自定义的材质，你需要了解 Minecraft 1.14+ 的自定义模型数据机制。可参考此教程：https://www.planetminecraft.com/for...ring/new-1-14-custom-item-models-tuto-578834/，并将其原理应用到配置中。

❓颜色渐变使用说明

从 1.20.4.a.3 版本开始，插件支持在 RGB 和 LCH 色彩空间中使用颜色渐变文本。

使用方法：

• 标记渐变开始：使用 &>LCH#000000，其中 000000 代表左侧颜色的十六进制代码。
• 输入文本：无需空格，直接在开始标记后输入你的文本。
• 标记渐变结束：使用 &<LCH#000000，其中 000000 代表右侧颜色的十六进制代码。

示例：

• &>LCH#ff0000测试消息&<LCH#0000ff
• 这将显示一个从红色渐变到蓝色的文本。
• 如果你想使用 RGB 色彩空间，只需将两个标记中的 "LCH" 替换为 "RGB" 即可，例如：&>RGB#ff0000...&<RGB#0000ff。

🔧更新日志摘要

• [1.3]：修复了作物头部错位、树叶消失问题；添加右键点击支持（可配置聊天信息或全息显示）；添加重载命令；修复了命令帮助格式。
• [1.4]：添加了可配置的种子掉落。
• [1.5]：添加了对自定义颅骨材质的支持。
• [1.20.1.a.1]：更新以支持 Minecraft 1.20。
• [1.20.4.a.3]：添加了 RGB 和 LCH 色彩空间的文本颜色渐变支持。
• [1.21.0.b.1]：添加了可自定义的基底方块；添加了苦力怕爆炸自动支持；添加了通过 YML 配置自定义持久化数据的支持，增强了插件兼容性。
• [1.21.0.d.1]：添加了 messages.yml，允许自定义插件消息。
• [1.21.0.d.2]：修复了耕地退化问题，种植后耕地将保持耕地状态。

💡支持与捐赠

我只是一个试图养活自己的大学生，开发插件只是我的爱好。你完全没有必要给我钱。但是，如果你真心喜欢/使用我的作品，或者愿意帮助我支付昂贵的书籍和课程费用，我将不胜感激。

• 捐赠链接：https://paypal.me/AaronSkeels