🎨BlockPalette Studio

BlockPalette Studio is a professional in-game building assistant and color theory studio designed for Minecraft architects, builders, and designers. It analyzes block textures in real-time to generate smooth color harmonies, custom gradients, WorldEdit patterns, and builder preset palettes.

---

✨ Key Features

🎨 Advanced Color Harmony Engine: Select any target block or HEX color code to instantly generate palette suggestions based on color theory algorithms:
Closest / Exact Color: Finds blocks with matching texture tones.
Analogous (Harmonious): Smooth, adjacent color tones.
Complementary (Contrasting): Vibrant opposite colors.
Triadic & Split-Complementary: Balanced 3-color architectural palettes.
Monochromatic: Tonal variations of a single hue.
🌊 Block Gradient Generator: Set key waypoint blocks to dynamically calculate smooth, seamless block transitions for walls, gradients, and natural terrain.
👁️ Eyedropper Hotkey (`V` Key): Aim at any block in your world and press `V` to instantly set it as your target block and open the studio.
📊 In-Game Floating HUD Palette (`H` Key): Toggle a sleek, transparent HUD palette overlay while building in-game without opening menus.
⚡ WorldEdit Pattern Exporter: Export your active palette directly to your clipboard in WorldEdit percentage format (e.g., `33%oak_planks,33%spruce_planks,34%birch_planks`).
📚 Built-in Preset Library: One-click access to curated architect palettes including *Medieval Castle*, *Luxury Modern Quartz*, *Cottagecore Moss*, *Desert Sandstone*, *Dark Nether Basalt*, and *Cyberpunk Concrete*.
🔍 Deep Category & Mod Filtering: Filter blocks by 16 granular categories (Wood, Stones, Ores, Carpets, Terracotta, Concrete, Slabs, Stairs, etc.) and origin mod namespace. Non-building utility items are automatically excluded.
⚙️ Studio Themes & Drag-and-Drop Layout Editor: Toggle between 4 built-in themes (*Architect Blueprint, Obsidian Dark, Botanist Emerald, Netherite Violet*) or use the interactive Layout Editor to drag, resize, and save your custom GUI layout.
📖 JEI Integration: Full Just Enough Items (JEI) support. Hover over any block swatch and press `R` (Recipes) or `U` (Usages) or middle-click.

---

⌨️ Keybindings & Controls

Key / Action	Function
`V` Key (In-Game)	Eyedropper: Set looked-at block as target & open GUI
`H` Key (In-Game)	HUD Overlay: Toggle floating active palette on screen
`R` / `U` / Middle Click	JEI Inspection: Open recipe or usages page for hovered block
Left Click (GUI)	Add block to active palette
Right Click (GUI)	Set clicked block as new target block
SHIFT + Left Click	Add block to Blacklist (hides from suggestions)
`⚙` Settings Modal	Toggle Studio Themes, Design Mode, or Reset Layout

---

⚙️ Compatibility & Requirements

Minecraft Version: `1.20.1`
Mod Loader: `Forge 47.4.10+`
Side: Client-side only (Can be used on any vanilla or modded server!)
Supported Integrations: Just Enough Items (JEI), WorldEdit

---

📦 FAQ & Modpack Permissions

Can I include BlockPalette Studio in my modpack
Yes! You are completely free to include BlockPalette Studio in any public or private modpack.
Does the server need this mod installed?
No, BlockPalette Studio is 100% client-side. You can use it anywhere!

---

🇹🇷 Türkçe Açıklama (Turkish Description)

🎨 BlockPalette Studio Hakkında

BlockPalette Studio, Minecraft mimarları, yapıcıları ve tasarımcıları için geliştirilmiş gelişmiş bir oyun içi inşaatçı ve renk teorisi stüdyosudur. Oyundaki tüm blokların doku renklerini canlı analiz ederek pürüzsüz paletler, blok geçişleri (gradient) ve WorldEdit oran kalıpları sunar.

Öne Çıkan Özellikler:
6 Farklı Renk Uyum Algoritması: En Yakın Tonlar, Analog Uyum, Zıt (Tamamlayıcı) Renkler, Üçlü Uyum ve Monokromatik paletler.
Blok Geçişi (Gradient) Üretici: Kilit blokları belirleyerek pürüzsüz renk geçiş dizilimleri oluşturma.
Damlalık (Eyedropper - `V` Tuşu): Baktığınız bloğa nişan alıp `V` tuşuna basarak anında hedef seçme.
Oyun İçi HUD Paleti (`H` Tuşu): Ekranın altında şeffaf aktif palet çubuğu.
WorldEdit Oran Dışa Aktarımı: Paletleri tek tıkla WorldEdit komut oranına (`%33 oak_planks, %34 spruce_planks…`) dönüştürme.
Hazır Mimar Kütüphanesi: Medieval, Modern Quartz, Cottagecore Moss, Nether Basalt vb. hazır paletler.
4 Canlı Tema & Canlı Tasarım Modu: Ozalit Mavisi, Obsidyen Dark, Sera ve Kozmik Mor temaları; panelleri fareyle sürükleyip boyutlandırma olanağı.