The Parametric Lego-Like Planter System (Beta)

Background

Just to be upfront right out of the gate, this openSCAD script was AI generated w/ Gemini, along with the entire description of all the parameters below (other than this background intro, had to write something myself).  I also used Gemini to add plants to the pyramid structure as I don't have any plants for it just yet... aaand a bulk script generator to make all the STL's from 1x1x1 to 4x4x4 (included at the end.

I was fooling around w/ Gemini, just having fun trying to get it to generate a 3D planter for me, that failed horribly, but then got going w/ an openSCAD script, and it sorta just evolved from there. Some of the ideas for parameters it generated, mostly I did, and i'll likely continue to evolve it as things go.  Didn't really plan on publishing it, but hey, maybe it'll work for you!

Picked the base unit of 88mm since it'll play nicely on my XL (4x4 units) and decently on the MK3.5s/MK4s. Walls are pretty thick to accommodate the peg system, but feel free to play with the parameters and see what works for your scenario! 

I've put it with a beta tag as I haven't had the time yet to print out the different pieces for testing. If you do run into any bugs or quirkiness let me know, and I'll update the script. Totally open to suggestions if there is something you want me to add.

I've added some parameters so it plays nicely with the fantastic tool https://bumpmesh.com/ by CNC Kitchen for adding textures.

I would recommend using the include tolerance print first to make sure the pegs fit well. They should be quite snug so the pieces will hold together firmly if doing overhangs, etc. I find I have to use a hammer to get them in, but then it feels like they should stay put, if looser tolerance, perhaps use the c clips that are a parameter to ensure the pots don't tip. 

⚙ The Parameter Master List

1. Core System Configuration

Description: These fundamental settings control the physical dimensions and structural tolerances of every component in the system.

• Base Unit: This sets the base size of your grid. 88mm is the standard for this system, optimized to fit perfectly on most standard beds.

• Units X / Y / Z: These three values determine the total 3D dimensions of your planter in units. Think of this as the "map size" for your individual pot.

• Corner Radius: This controls how much the outer vertical corners are rounded. A higher number gives a smoother, more modern feel, while 0 creates sharp corners.

• Wall / Bottom Thickness: These define the structural shell. Thicker walls are better for structural integrity if you are building massive, multi-unit stacks.

• Tolerance: This is the "wiggle room" for your printer. If your snap-together parts are too tight or loose, adjust this value by 0.05mm increments.

2. Top Frame Settings

Description: These options allow you to customize the top rim of your planter for both aesthetic appeal and practical plant protection.

• Frame Height: Sets the vertical height of the decorative top rim. This covers the top edge of your planters for a finished look.

• Frame Style: Toggles the top frame's functionality. Choose "solid" for a simple aesthetic look or "guard" for a cat-proof soil lattice.

• Frame Cutout Toggles: Enables a custom opening in the top rim. This is useful for letting large plant stems grow through without restriction.

• Cutout Offsets (X/Y): These allow you to shift the frame cutout to align with where your plant is actually located inside the pot.

3. Biscuit / Peg System

Description: This modular connector system uses structural joints to link multiple planters, tiles, and accessories into one unified wall architecture.

• Peg Shape: Choose between rounded rectangular "biscuits" or standard cylinders. Rectangular biscuits are generally stronger against shearing forces.

• Pegs Per Unit: Sets the number of connection points along each 88mm edge. More pegs provide a tighter, more uniform hold.

• Peg Size / Thickness: Adjusts the dimensions of the structural connectors. Ensure these match your printer’s tolerance settings for the best fit.

• Peg Height: Sets how long the peg is. The system automatically calculates the depth, so the peg plunges halfway into each pot.

• Socket Toggles: Individual switches that enable holes for pegs on the top, bottom, or sides, allowing for infinite modular expansion.

4. Grid-Locked Drainage

Description: This feature adds integrated drainage systems so that the soil doesn't become waterlogged and damage sensitive roots.

• Enable Drainage & Diameter: Determines if a hole is punched through the floor of the soil cavity. Use this to prevent water buildup for specific plant types.

• Drainage Slope: Enables a 3D funnel that guides water directly to the center drain. This prevents standing water in the corners of your pot.

• Drainage Slope Height: Defines how steep the funnel is. A steeper slope ensures water moves more aggressively toward the center.

5. Grid-Locked Clips

Description: These external locking brackets mechanically bind separate planters together horizontally to provide additional structural stability.

• Enable Clips & Spacing: Toggles external C-brackets that physically bind planters together from the outside. This is great for added security on multi-unit walls.

• Clip Dimensions: Adjusts the width, depth, and prong grip-strength of the external locking hardware.

6. Feline Soil Guard

Description: A protective lattice system designed to cover the soil, preventing pets from digging in your pots while still allowing for airflow.

• Guard Pattern & Line Width: Selects the lattice geometry (hex, grid, or lines) and how thick the guard webbing is.

• Plant Hole & Diameter: Enables a specific opening in the center of the lattice for your plant to grow through.

7. Internal Support Column

Description: These internal pillars add critical reinforcement for large-scale architectural layouts, especially when dealing with heavy soil loads or deep overhangs.

• Column Style: Selects the pillar style for internal weight-bearing support.

8. Architectural Cladding

Description: Use these cosmetic trim components to cover up the connection seam lines between stacked units for a professional, finished look.

• Trim Thickness & Height: Defines the dimensions of the snap-on cosmetic trim rails. These are perfect for hiding the seam lines between stacked units.

• Texture Clearance: Adds extra clearance for the trim-rails, specifically useful if you are using "Fuzzy Skin" settings in your slicer.

• Trim Rail Units: Controls how many grid units long the trim rail should be, letting you customize the length for specific wall designs.

9. Riser Blocks

Description: Riser blocks provide structural height to your grid without the weight and filament cost of filling large sections with soil.

• Riser Style & Hex Size: Selects the pattern (hex, arch, or X) for hollow support blocks. These replace solid pots to save massive amounts of filament.

• Riser Line Width & Margin: Sets the webbing thickness and solid border width of the riser blocks for maximum structural strength.

10. Smart Baffle System

Description: The baffle system allows you to insert divider panels inside your planters to create distinct sections within a single large pot, either for different plants, or to wall off portions that are underneath another pot. 

• Enable Slots & Track Depth: Toggles internal wall grooves that allow you to slide in divider sheets.

• Baffle Thickness & Span: Sets the thickness and width of the removable guillotine-style divider panels for segmenting your soil.

11. Canopy Trellis System

Description: This integrated climbing frame slots directly into the planter's top peg system to support vertical growth for vining plants.

• Trellis Span & Height: Defines the size of your climbing lattice.

• Trellis Pattern & Hole Size: Controls the vine-weave pattern and the size of the trellis openings.

• Trellis Thickness: Sets the Z-height thickness of the trellis structure.

12. Hybrid Cavity System

Description: This matrix system allows you to map your design, selecting which blocks act as soil-filled planters and which act as hollow supports.

• Custom Cavity Toggle: Enables advanced matrix control. When on, you can manually map individual blocks as either planters (1) or structural risers (0).

• Cavity Layout Matrix: The master grid where you define the layout of your soil versus your hollow support blocks.

13. Mega-Matrix Template Slicer

Description: This system automatically generates custom drill templates for your wall, taking the guesswork out of mounting large modular grids.

• Mount Holes & Side: Enables horizontal screw tunnels. Choose the wall side that aligns with your specific mounting location.

• Jigsaw Slicer Toggle & Chunk Size: Splits the drill template into printer-sized puzzle pieces for easy assembly on large walls.

• Template Layout Matrix: The map of your design. 1 marks a new planter hole, and 2 marks alignment pegs for existing pots.

14. Light Mount System

Description: A dedicated, reinforced bracket system that allows you to mount grow lights directly onto your planter wall.

• Light Mount Peg Span: Defines how many grid units wide the mounting bracket extends.

• Light Mount Height & Reach: Sets the total vertical length of the bracket and how far it projects from the wall.

• Light Pole Depth & Diameter: Controls the vertical drop-in socket size and depth, automatically reinforcing the bracket with extra plastic.

15. Wall Tile System

Description: These flush-mount panels provide a clean, finished appearance by covering gaps in your modular grid layout.

• Tile Units X / Z: Defines the total width and height of your decorative flush-mount wall panel.

• Tile Thickness: Sets the plate depth. If this is lower than 8mm, the system automatically generates internal bosses to provide enough plastic for the peg sockets.

• Tile Socket Toggles: Individually enables or disables top/bottom pegs to snap the tile securely into your existing planter grid.

16. Texture & Displacement

Description: This parameter ensures compatibility with surface textures (like BumpMesh.com) by automatically accounting for extra width from the texture.

• Texture Depth: Defines the depth of any external BumpMesh or displacement textures applied to your outer walls. Setting this accurately ensures that your snap-on trim rails and horizontal locking clips sit perfectly flush against the surface, preventing gaps or clipping issues caused by the texture geometry.
  

The Bulk STL Generator (Python Script)

Want to generate an entire ecosystem of planters without exporting them one by one? I have included a custom Python script (batch_render.py) that hooks directly into OpenSCAD's command-line interface.

By default, this script will automatically calculate and export a full matrix of planter sizes (from 1x1x1 all the way up to 4x4x4) and organize them into neat subfolders while you grab a coffee.

Prerequisites:

• OpenSCAD installed on your system.

• Python 3 installed.

How to set it up:

1. Keep it together: Ensure your main planter .scad file and batch_render.py are saved in the exact same folder.

2. Check the Filename: Open the batch_render.py script in any basic text editor. Make sure the SCAD_FILE variable exactly matches the name of your OpenSCAD file (e.g., SCAD_FILE = "Parametric_Planter.scad").

3. Set your OpenSCAD Path: In that same python script, update the OPENSCAD_PATH variable to point to where OpenSCAD lives on your computer:

   • Windows: "C:/Program Files/OpenSCAD/openscad.exe" (Default location)

   • Mac: "/Applications/OpenSCAD.app/Contents/MacOS/OpenSCAD"

   • Linux: "/usr/bin/openscad"

How to run it:

1. Open your Terminal (Mac/Linux) or Command Prompt (Windows).

2. Navigate to the folder containing your files (e.g., type cd and drag your folder into the terminal).

3. Run the script by typing:

   Bash

   python batch_render.py
   

(Note: Mac users may need to type python3 batch_render.py depending on your system setup).

The Output: Sit back and watch the terminal. The script will dynamically override the width, depth, and height parameters in the configuration file, generate the geometry, and dump dozens of ready-to-print .stl files into a newly created Planter_Matrix_STLs folder!