Shelf Filler | Blender Addon  

📚 MK SHELF FILLER — Auto-Fill Bookshelves With Books in One Click for Blender

Stop placing books one by one. Select your shelf, pick a few book models, hit START — and your entire bookshelf fills instantly with natural, randomized, ready-to-render books. No tedious manual stacking, no overlaps, no headaches.

📦 What's Included:

📚 One-Click Fill — Select a shelf, add your book models, press START. The whole shelf fills automatically with realistic spacing.

🧩 Smart Compartment Detection — Automatically detects separate cubbies/compartments on a shelf and fills each one independently — no books crossing over dividers.

📐 Ceiling-Aware Scaling — Knows the real height above each compartment, so books are never wrongly shrunk by a neighbor's shelf. Open-top areas keep full-height books.

📖 Natural Book Variety — Standing, leaning groups (domino-style against the wall), 90° faced-out columns, and lying flat stacks — all controllable.

🎲 Smart Randomization — A "bag" system spreads your book models evenly with no repeating patterns and no back-to-back duplicates. Decoratives are scattered, never stuck in a single column.

🔀 Per-Book Orientation — Mix different book models freely; every model stands correctly from its own axes, all under one unified rule.

🏺 Decoratives Between Books — Drop in figurines, plants, frames or any prop, and the addon opens space between books to seat them, on any percentage of levels you choose.

⚡ Full Realtime — Every slider updates the arrangement instantly. Tweak gap, lean, scale, seed and watch it rebuild live.

📌 Multi-Shelf Apply — Fill one shelf, hit Apply to bake it in place, then move on to the next shelf without disturbing the first.

🎰 Seed Control — One button to reshuffle the entire layout until it looks perfect.

🛠 How to Use:

1. Pick your shelf object.
2. Add one or more book models to the list.
3. (Optional) Add decorative models.
4. Press START — done. Adjust sliders in realtime, or Apply and move to the next shelf.

💻 Compatibility:

Blender 3.6 and above (tested on 4.x and 5.x). Works with any shelf mesh — straight, divided, or multi-compartment.

Whether you're dressing a cozy library, a game environment, or an arch-vis interior, MK Shelf Filler turns hours of manual placement into a single click.