config.yml

# 不要更改此值
config-version: '${config_version}'
# 启用或禁用调试模式
debug: false
# 启用或禁用使用 BStats 的指标收集
metrics: true
# 启用自动更新检查
update-checker: true
# 强制使用特定语言环境（例如，zh_cn）
force-locale: ''
# 世界设置
worlds:
  # 一些服务器使用单独的目录来存储玩家的世界，这些目录可能不在服务器的根目录中。
  # 此选项允许你指定这些世界文件夹的自定义路径。仅适用于 Bukkit 世界。
  absolute-world-folder-path: ''
  # 指定插件机制应适用于哪些世界
  # 选项：whitelist/blacklist/regex
  mode: blacklist
  list:
    - blacklist_world # 一个不存在的世界
  settings:
    # 应用于所有世界的默认设置
    _DEFAULT_:
      # 是否启用插件的预配置系统
      # 禁用此选项将停止所有机制的计时，除非通过 API 完全管理。
      # 如果你不熟悉使用 CustomCropsAPI，请保持此设置为 true，因为它满足 99% 用户的需求。
      enable: true
      # 季节设置
      season:
        enable: true
        # 自动循环季节
        auto-alternation: true
        # 每个季节的持续时间（游戏天数）
        duration: 28
      # 这与原版的 RandomTickSpeed 不同。
      # 这里的“随机刻”指的是每秒在 16x16x16 区域内随机选择 n 个方块进行刻动，不同于 Minecraft 的每刻动方式。
      # 因此，CustomCrops 的随机刻对服务器的影响最小，并且在多个线程上运行。
      random-tick-speed: 20
      # 使用定时刻动模式时的最小刻动间隔（秒）
      # 180 秒的值意味着作物至少每 180 秒保证刻动一次
      # 对于作物，在相同条件下生长率几乎是均匀的
      # 洒水器和种植盆在此间隔内周期性地运行。
      min-tick-unit: 180
      # 离线时刻动设置
      # 允许作物即使在世界卸载或服务器关闭时也能生长
      # 这可能会导致与时间相关的条件（如季节）出现问题
      offline-tick:
        enable: false
        # 记录的最大离线时间（秒）
        # 避免设置过高，因为这可能导致长时间卸载的区块加载时间过长
        max-offline-seconds: 1200
        # 加载区块的最长时间
        # 有时，长时间卸载的大量数据区块可能需要一段时间来加载，
        # 可能会导致意外问题
        # 此设置允许插件在加载时间超过设定阈值时强制中断刻动过程
        max-loading-time: 100 # 毫秒
      # 作物设置
      crop:
        # [RANDOM_TICK]
        # 随机刻动模式模仿原版行为，作物随机生长
        # 这种随机性可能导致在相同条件下生长的作物之间存在显著的阶段差异
        # [SCHEDULED_TICK]
        # 定时刻动模式提供更可预测的生长管理，
        # 确保作物几乎以相同的速度生长
        mode: RANDOM_TICK
        # 刻动间隔决定在执行逻辑之前刻动方块的次数
        tick-interval: 1
        # 限制每个区块的作物数量（-1 表示无限制）
        max-per-chunk: -1
      # 种植盆设置
      pot:
        # RANDOM_TICK 或 SCHEDULED_TICK
        mode: SCHEDULED_TICK
        tick-interval: 3
        max-per-chunk: -1
      # 洒水器设置
      sprinkler:
        # RANDOM_TICK 或 SCHEDULED_TICK
        mode: SCHEDULED_TICK
        tick-interval: 2
        max-per-chunk: -1
    # 在此为特定世界覆盖默认设置
    _WORLDS_:
      world_nether:
        enable: false
      world_the_end:
        enable: false
# 机制设置
mechanics:
  # 通过添加更多斜杠创建额外的等级，例如 x/x/x/x/x
  # "x" 代表权重，决定概率比例
  # 17/2/1 = 85%/10%/5%
  # 85% 的计算方法是 17/(17+2+1) * 100%
  default-quality-ratio: 17/2/1
  # 稻草人设置，以防止作物被乌鸦攻击
  scarecrow:
    enable: true
    id: 'scarecrow'
    type: ITEM_FRAME
    range: 7
    # 如果启用，稻草人的范围将不受限制
    # 它将保护同一区块内的所有作物
    protect-chunk: false
  # 温室玻璃防止作物因季节变化而枯萎
  greenhouse:
    enable: true
    # 你可以在此使用 ID 列表；也支持原版方块
    id: 'greenhouse_glass'
    type: CHORUS
    range: 5
  # 与另一个世界同步季节
  sync-season:
    enable: false
    reference: world
  # 原版耕地机制
  vanilla-farmland:
    # 禁用原版耕地的湿润机制
    # 如果你更喜欢原版耕地，但水系统与原版机制冲突，这很有用
    disable-moisture-mechanic: false
    # 防止实体踩踏耕地
    prevent-trampling: false
  # 为不同方块设置全息图偏移校正
  hologram-offset-correction:
    "crop_stage_death": 0
  # 指定应由插件覆盖的方块类型
  # 一些常见作物：WHEAT/CARROTS/POTATOES/BEETROOTS/SWEET_BERRY_BUSH
  override-vanilla-blocks: []
other-settings:
  # 建议使用 MiniMessage 格式。如果你想使用传统颜色代码（"&"），请启用下面的支持。
  # 禁用此选项可以提高性能
  legacy-color-code-support: true
  # 需要 PlaceholderAPI 才能运行
  placeholder-register:
    '{skill-level}': '%levelplugin_farming%'
  # 使用其他插件的物品
  item-detection-order: []
  # 是否保护物品的原始描述
  # 使用记分板组件来识别插件的描述，
  # 这可能与一些仍使用 SpigotAPI#ItemMeta 的插件冲突
  protect-original-lore: false
  # 是否验证方块/家具是否与 CustomCrops 中的数据匹配
  # 如果使用 Oraxen，请启用此选项，因为其 API 更可靠
  double-check: false