# Foliage Plugin Configuration

# General settings
settings:
  # Whether to use MiniMessage format
  # If false, will use legacy color codes (§)
  use-minimessage: true

# Vanilla leaves settings (client-side via ProtocolLib)
  vanilla-leaves:
    override-enabled: true #Leave this true
    fixed-distance: 7
    persistent: false
    processed-types:
      - OAK_LEAVES
      - BIRCH_LEAVES
      - SPRUCE_LEAVES
      - JUNGLE_LEAVES
      - ACACIA_LEAVES
      - DARK_OAK_LEAVES
      - AZALEA_LEAVES
      - FLOWERING_AZALEA_LEAVES
      - MANGROVE_LEAVES
      - CHERRY_LEAVES

# Vanilla saplings settings
  vanilla-saplings:
    # Whether to override vanilla saplings behavior
    override-enabled: true
    # Whether to force stage 0 for all vanilla saplings
    force-stage-zero: true
    # Whether to allow natural tree growth
    allow-natural-growth: true

# General custom sapling growth settings
  custom-saplings:
    growth-chance: 0.25
    bonemeal-multiplier: 3.0
    random-tick-interval: 30
    blocks-per-chunk: 10
    allow-bonemeal: true

performance: #Do not touch if you don't know what you are doing
  # Maximum number of chunks to keep in memory cache
  chunk-cache-size: 100

# Whether to load chunks asynchronously
  async-loading: true

# Whether to batch block updates
  batch-updates: true

# Maximum number of block updates to process in a single batch
  batch-size: 1000

# How often to save block data to disk (in seconds)
  save-interval: 300

# Whether to use more thorough sampling for chunks after initial sampling
  # Only enable if you notice missing leaves in some chunks
  thorough-sampling: false

# Whether to use legacy full chunk processing instead of sampling (not recommended)
  # This will have a significant performance impact
  legacy-full-processing: false

# Whether to use adaptive forest-aware leaf processing (reduces TPS impact in forests)
  adaptive-leaf-processing: true

# Maximum number of leaf updates to process per tick (lower = less TPS impact)
  max-leaf-updates-per-tick: 50

# Multiplier for cooldown in dense forest areas (higher = fewer updates in forests)
  density-cooldown-multiplier: 3

# Storage settings
storage:
  # Whether to use the region storage system (recommended)
  use-region-storage: true

# Whether to automatically migrate data from the old YML storage to the new region storage
  auto-migrate: true

# Whether to delete the old storage file after migration
  delete-old-storage: false

# Compression level for region files (0-9, where 9 is maximum compression)
  # Higher values use more CPU but less disk space
  compression-level: 6

# Debug settings
debug:
  # Enable debug messages in console
  enabled: false
  # Log block placements
  log-placements: true
  # Log block registrations
  log-registrations: true
  # Log block updates and physics
  log-updates: true
  # Log chunk loading/unloading
  log-chunks: true
  # Log block storage operations
  log-storage: true
  # Log block operations
  log-blocks: true
  # Log sapling growth events
  log-growth: true
  # Log WorldEdit operations
  log-worldedit: false
  # Log startup messages
  log-startup: true
  # Log packet operations
  log-packets: false
  # Log placement attempts for custom blocks
  log-placement: true
  # Log block breaks
  log-breaks: true
  # Log drops from blocks
  log-drops: true
  # Log leaf growth events
  log-leaf-growth: true
  # Log sapling growth events
  log-sapling-growth: true

# Permissions
permissions:
  # Whether to check permissions for placing blocks
  enabled: true
  # Default permission settings
  defaults:
    # Allow placing custom leaf blocks
    can-place-leaves: true
    # Allow placing custom sapling blocks
    can-place-saplings: true

# Messages
messages:
  # Use MiniMessage format for all messages
  # See: https://docs.adventure.kyori.net/minimessage/format.html
  prefix: "<dark_gray>[<green>Foliage</green><dark_gray>] <gray>"
  no-permission: "<red>You don't have permission to do that!</red>"
  given-block: "<gray>Given <green>{block}</green>!</gray>"
  invalid-block: "<red>Invalid block configuration: {error}</red>"

# Version - do not modify
config-version: 1 

This config is important for non-custom blocks (leaves, sugar cane, saplings).

# Custom Blocks Configuration
# This is an example of how to configure custom leaves.

custom_leaves:
  fir_leaves:
    item:
      itemsadder: custom_blocks:fir_leaves #Use ItemsAdder items
    block:
      base_material: AZALEA_LEAVES
      distance: 3
      persistent: true
      model: "custom_blocks:leaves/fir_leaves/fir_leaves" #Use a single model
    drops: "fir_leaves" #Use the name from drops.yml

maple_leaves:
    item:
      nexo: custom_blocks:maple_leaves #Use Nexo items
    block:
      base_material: AZALEA_LEAVES
      distance: 4
      persistent: true
      models: #Use multiple models
        - "custom_blocks:leaves/maple_leaves/maple_leaves"
        - "custom_blocks:leaves/maple_leaves/maple_leaves1"
        - "custom_blocks:leaves/maple_leaves/maple_leaves2"
        - "custom_blocks:leaves/maple_leaves/maple_leaves3"
    drops: "maple_leaves" #Use the name from drops.yml

# Configuration version - do not modify
version: 1 

Everything is fully configurable, you are free to create your unique foliage.

# Custom Saplings Configuration
# This file contains definitions for all custom sapling blocks in the game

custom_saplings:
  example_sapling:
    item:
      material: OAK_SAPLING
      name: "<green>Example Sapling</green>"
      custom_model_data: 1001
      lore:
        - "<gray>A magical sapling that grows</gray>"
        - "<gray>into a custom tree!</gray>"
      # Optional custom item IDs
      itemsadder: ""
      nexo: ""

block:
      base_material: OAK_SAPLING
      stage: 0
      growth:
        # Chance to grow on random tick (out of 100)
        chance: 15
        # List of schematics to randomly choose from (from the schematics/ directory)
        schematics:
          - "custom_tree1.schem"
          - "custom_tree2.schem"
        # Minimum light level required for growth (0-15)
        min_light: 9
        # Whether bonemeal can be used
        allow_bonemeal: true
        # Whether the sapling needs specific blocks below to grow
        required_blocks:
          - "GRASS_BLOCK"
          - "DIRT"
          - "PODZOL"
        # Minimum space needed above the sapling (y height)
        required_height: 7
        # Whether to check for space in a radius around the sapling
        space_check:
          enabled: true
          radius: 2
          height: 5

# Drop table to use for this block (references a table in drops.yml)
    drops: "example_sapling"

# Configuration version - do not modify
version: 1 

Your custom saplings growth system is fully configurable and allows custom trees growth.

Foliage uses WorldEdit schematics to handle custom trees:

1. Build your custom tree
2. Select it with WorldEdit (//pos1 & //pos2 or use a Wooden Axe)
3. //copy - Copy your selected structure
4. //schem save <your-schematic> - Save your tree schematic under the name you want
5. Copy your schematic from WorldEdit/schematics/<your-schematic>.schem
6. Paste it in Foliage/schematics/
7. Use your schematic name in grow-into in the custom_saplings.yml file.

# Drop tables configuration
drop-tables:
  fir_leaves:
    drops:
      stick:
        material: STICK
        amount: 1-2
        chance: 0.1
        fortune-affected: false
      fir_sapling:
        itemsadder: custom_blocks:fir_sapling
        amount: 1
        chance: 0.05
        fortune-affected: false

maple_leaves:
    drops:
      stick:
        material: STICK
        amount: 1-2
        chance: 0.1
        fortune-affected: false
      maple_sapling:
        nexo: maple_sapling
        amount: 1
        chance: 0.05
        fortune-affected: false