Gentree v1.0.0

Gentree - Procedurally generates trees and foliage in Aseprite.

Gentree is an  Aseprite extension that procedurally generates pixel art trees and foliage using customizable parameters and presets. 

It’s designed to help you quickly create natural‑looking trees, forests, and vegetation for pixel‑art environments, tilesets, and game assets, while still keeping the process artist‑driven and editable.

✨ Includes ready‑to‑use presets for fast iteration, plus a Forest Mode for generating multiple trees at once.

🌲 Trunk and Branch Tab

Controls the overall shape, thickness, and curvature of  the trunk and branches.

• Trunk Height - Overall height of the main trunk.
• Branch Length – Average length of each branch.
• Trunk/Branch  Points - Number of points used to form each path.
  • Higher values produce smoother, more natural curves.
• Trunk/Branch  Curve -  Controls how much the trunk or branch bends.
• Thickness Start / End - Controls tapering from base to top.

⚙️ Structure & Complexity

Controls how dense and complex the tree becomes.

• Branch Amount - Number of branches on the trunk.
• Branch Fork - How often branches split.
• Branch Levels - Maximum recursion depth (tree complexity).
• Combine Trunk & Branch - Merges branch and trunk into the same layer.
• Trunk Textured - Adds bark-like lines to the trunk.

💡 High depth + high branch amount can get dense fast.

🍃 Leaves Tab

Controls leaf placement and style.

• Leaf Density - Number of leaf clumps.
• Cluster Size - Radius of each leaf cluster.
• Leaf Size - Size of individual leaves.
• Leaf Type - Shape used for leaves (round, triangle, etc.).
• Shade Variation - Adds subtle color variation for depth.

🎨 Colors & Extras

• Leaves Color - Base leaf color.
• Wood Color - Trunk and branch color.
• Outlined - Adds pixel outlines.
• Flip Shadow - Flips the light/shadow direction.
• New Layer - Forces generation onto a new layer.

🌲 Forest Mode

Generates multiple trees inside a selection.

• How it works:
  1. Make a horizontal rectangular selection
  2. Enable Forest Mode
  3. Set number of trees
  4. Click Generate

Trees are spaced with controlled randomness for a natural look.

🧱 Layering Modes

Choose how generated elements are organized.

1. 🔹 Single Layer (Recommended)
   1. Draws on the currently selected layer
   2. Regeneration overwrite the same layer
   3. 💡 Select a new layer if you want to keep the current tree.
      
2. 🔹 Separated
   1. Creates individual layers:
      1. Trunk, Branch, Foreground Leaves, Background Leaves
   2. 💡 Group the four layers to keep the tree intact.
3. 🔹 Grouped
   1. Same as Separated, but inside a group
   2. Cleaner organization for complex scenes
   3. 💡 Rename the group if you want to keep multiple trees.

🌱 Presets

Presets let you instantly switch between different tree styles.

• Built-in presets for quick results
• Select a preset to instantly apply settings
• Create your own presets
• Default presets cannot be deleted or overwrite

💡 Presets are great for exploring variations or getting a solid base before polishing by hand.

✨ Tips & Best Practices

• Start with a preset, then tweak values to taste
• Begin simple: low depth, fewer branches
• Increase complexity gradually
• Use Single Layer mode while experimenting
• Flip Shadow to match scene lighting

Gentree is designed to feel procedural, but artist-driven.

It doesn’t replace hand-drawn trees, it gives you a strong, editable starting point that you can tweak, polish, and make your own.