BoostedTrees — Configuration

BoostedTrees — Configuration

Configuration settings

• enabled – default true. Enables forest population and starting manual tasks. Turning it off pauses active manual tasks; re-enabling does not automatically resume them.
  
• worlds – default []. An allow list of world names; empty means all Overworlds. Names are trimmed and normalized to lowercase. Nether and End worlds are excluded from forest population.
  
• custom_trees_percent – default 80, range 0–100. Target custom share among final trees in the scanned area.
  
• large_trees_percent – default 10, range 0–100. Target large-tree frequency among custom trees, subject to suitable terrain and sources.
  
• performance_level – default 3, range 1–5. Higher values allow more scanning/planning and faster manual conversion, with more processing work.
  
• disabled_trees – default []. Canonical tree IDs excluded from automatic population and manual conversion. Explicit preview commands remain available.
  
• tree_rarity – map of tree IDs to rarity keys. Automatic population and manual forest conversion check rarity before planning. Explicit preview commands bypass this selection gate.
  

GUI changes save and apply immediately. Manual file changes require /boostedtrees reload. Invalid YAML, invalid types or unknown rarity values are rejected while the file is retained; a failed reload keeps the previous running settings. Numeric values are clamped to their ranges. Configuration is normalized on save, so unsupported keys are not a supported customization method.

Rarity levels
Admission chances per suitable source are listed below. They are not final world percentages and still combine with biome, size and placement checks. Omitted species use built-in defaults: ancient_cypress and giant_sequoia are rare; elder_weeping_oak, titan_weeping_birch and savanna_colossus are ultra_rare; all others are popular.

• popular – 100%
  
• common – 65%
  
• uncommon – 35%
  
• scarce – 20%
  
• rare – 10%
  
• very_rare – 1%
  
• ultra_rare – 0.1%
  

Default configuration
The current code writes the normalized configuration below. The older bundled resource still uses rare_trees; this legacy list is accepted and converted to tree_rarity. Use the current map for new edits. Configuration keys, tree IDs and rarity values stay in English.


Example: one selected world
This complete example limits new forests to world, uses 60% custom trees and 5% large trees, disables Giant Oak and makes Highland Pine common. Replace the world name with your actual world name, then run /boostedtrees reload.


Percentages are targets for eligible sources, not guaranteed whole-world ratios. A group replaced by one custom tree counts as one final tree. Biomes, rarity, space and processing limits can lower the resulting share. Setting custom_trees_percent: 0 disables automatic replacement work; it does not remove existing trees.

Manual tasks capture detection and proportion settings when started; performance level and current species/rarity checks change live. Changing settings does not rewrite already generated trees. Start a new task to use changed captured task settings. The world allow list is checked when starting a task.