💦 洒水器

/CustomCrops/contents/sprinklers/__SPRINKLER__.yml

让我们以 sprinkler_1 为例来配置洒水器的设置

你的洒水器的唯一标识符： 首先，给你的洒水器命名一个唯一标识符，例如 sprinkler_1。这使得以后引用和自定义变得容易。

指定洒水器的类型： type 参数定义洒水器为 FURNITURE，将其与基于方块的类型区分开来，并允许在放置时有更多的灵活性。

# 洒水器的类型（BLOCK 或 FURNITURE）
type: FURNITURE

选择喷洒模式并设置范围： 决定你的洒水器如何喷洒！working-mode 允许你设置喷洒模式：

• 1 为方形模式

• 2 为菱形模式（当前选择）

• 3 为圆形模式 这为你的浇水策略增加了创意！

# 喷洒模式：
# 1 = 方形, 2 = 菱形, 3 = 圆形
working-mode: 2

range 参数指定洒水器的覆盖范围。在此示例中，1 的范围覆盖一个紧凑的区域：

# 洒水器的工作范围：
# □■□
# ■▼■
# □■□
range: 1

模式1

模式2

模式3

设置储水容量： storage 参数决定了你的洒水器可以容纳多少水——在这个例子中是 4。这限制了洒水器在需要补水之前可以运行的时间。

# 最大储水容量
storage: 4

决定无限或有限的水供应： 将 infinite 设置为 false，洒水器有一个有限的水供应。如果你想要一个无限的洒水器，将其改为 true！

# 表示洒水器是否有无限的水供应
infinite: false

控制每次操作的水消耗： water 和 sprinkling 参数决定每次喷洒循环中添加到种植盆的水量和消耗的水量，这里都设置为 1 以实现平衡的浇水。

# 每次喷洒操作添加到种植盆的水量
water: 1
# 每次喷洒操作消耗的水量
sprinkling: 1

洒水器的视觉表示： 使用 3D-item 和 3D-item-with-water 定义洒水器在干燥和有水状态下的外观。这个视觉提示通过反映洒水器的状态增强了游戏体验。

# 洒水器的3D模型标识符
3D-item: sprinkler_1 # 无水状态
3D-item-with-water: sprinkler_1 # 有水状态

可选的2D模型： 2D-item 是一个可选参数，适用于那些喜欢更简单的视觉表示或在某些场景中使用2D视图的人。

# 可选的2D物品模型标识符
2D-item: sprinkler_1_item

种植种植盆的白名单： 通过将种植盆添加到 pot-whitelist 确保你的洒水器仅在指定的种植盆中工作。示例允许默认的种植盆类型。

# 洒水器可以工作的种植种植盆的列表
pot-whitelist:
  - default

定义补水方法： 在 fill-method 下，你可以创意地定义洒水器的补水方式。例如，使用 WATER_BUCKET 返回一个空的 BUCKET，并添加 3 单位的水，而使用 POTION 返回一个 GLASS_BOTTLE 并添加 1 单位的水。

# 洒水器补水的方法
fill-method:
  # 自定义补水方法1配置
  method_1:
    # 用于补水的物品
    item: WATER_BUCKET
    # 补水后返回的物品（可选）
    return: BUCKET
    # 此方法添加的水量
    amount: 3
  # 自定义补水方法2配置
  method_2:
    item: POTION
    return: GLASS_BOTTLE
    amount: 1

自定义水位显示： water-bar 部分允许你使用符号创建独特的水位表示。调整这些字符以匹配你的游戏风格或偏好。

# 水位显示条的配置
water-bar:
  left: '뀂'   # 水位条的左端
  full: '뀁뀃' # 表示水位满的段
  empty: '뀁뀄' # 表示水位空的段
  right: '뀁뀅' # 水位条的右端

设置事件： 在 events 下，你可以配置洒水器如何响应不同的玩家操作。可用事件：break/place/interact/work/add_water/full/reach_limit

# 各种互动和动作的事件设置
events:
  place:
    # 放置洒水器时执行的动作
    swing_hand_action:
      type: swing-hand
      value: true
    # 放置洒水器时触发的音效
    sound_action:
      type: sound
      value:
        source: player
        key: minecraft:block.bone_block.place
        volume: 1
        pitch: 1
  interact:
    # 互动时执行的条件动作
    force_work_action:
      type: conditional
      value:
        conditions:
          requirement_1:
            type: sneak
            value: true
        actions:
          action_1:
            type: force-tick
    # 互动时显示的全息图动作
    hologram_action:
      type: hologram
      value:
        text: '<font:customcrops:default>{water_bar}</font>'
        duration: 40
        x: 0.5
        y: -0.3
        z: 0.5
        visible-to-all: false
  work:
    # 洒水器工作时显示的视觉效果
    fake_item_action:
      type: fake-item
      value:
        item: water_effect
        duration: 100
        x: 0.5
        y: 0.4
        z: 0.5
        visible-to-all: true
  add_water:
    # 添加水时显示的粒子效果
    particle_action:
      type: particle
      value:
        particle: WATER_SPLASH
        x: 0.5
        y: 0.7
        z: 0.5
        count: 5
    # 添加水时播放的音效
    sound_action:
      type: sound
      value:
        key: "minecraft:item.bucket.empty"
        source: 'player'
        volume: 1
        pitch: 1

设置要求： 在 requirements 下，你可以配置玩家在使用洒水器之前必须满足的条件。可用事件：break/place/use

requirements:
  use: {}
  place: {}
  break:
    requirement_1:
      type: permission
      value: xxx.xxx