Skip to content

Parameter Reference

This document is the canonical reference for every Customizer section and parameter in cable-box-parametric.scad.

  • Model source: cable-box-parametric.scad
  • Repository: https://github.com/prisant-labs/3d-cable-box-parametric-openscad
  • License: MIT
  • Third-party attribution: THIRD_PARTY_NOTICES.md

If this document and the SCAD file ever disagree, treat the SCAD file as the functional source and update this document.

  • Units: millimeters unless stated otherwise.
  • 0 as override value usually means “use default/global value”.
  • “Primary” alignment means along the arrangement axis.
  • “Secondary” alignment means perpendicular to the arrangement axis.
  1. Overall
  2. Box 2a. Edge Treatment
  3. Post
  4. Lid 4a. Lid Relief 4b. Lid Magnets
  5. Openings
  6. Left Openings Overrides
  7. Right Openings Overrides
  8. Back Openings Overrides
  9. Front Openings Overrides
  10. Stabilizers - Main Settings
  11. Stabilizers - Front/Back Walls
  12. Stabilizers - Left/Right Walls
  13. Bottom Openings - Main
  14. Bottom Openings - Alignment
  15. Bottom Openings - Custom Margins
  16. Slicing - For Smaller Print Beds
  17. Gridfinity
  18. Printing
  19. Hidden
Parameter Type Default Allowed values Description Notes
Part_To_Render enum "Box Only" "Box Only", "Lid Only", "Box and Lid" Chooses which model body is generated. In non-slicing mode, box and lid are separated in view for export.
Option Behavior
"Box Only" Renders only the box body.
"Lid Only" Renders only the lid.
"Box and Lid" Renders both bodies in one scene.
Parameter Type Default Description Practical guidance
Box_Width number 100 Outer box width (X axis). Increase for longer cable bundles or power bricks.
Box_Depth number 75 Outer box depth (Y axis). Increase for front/back routing space.
Box_Height number 50 Outer box height (Z axis). Set high enough for cable bend radius and connectors.
Box_Corner_Radius number 8.1 Roundness of outer vertical edges. Effective ceiling is (min(Box_Width, Box_Depth) - Wall_Thickness*2) / 2, set by the inner cavity rather than the outer shell. Larger values are clamped and reported via echo.
Wall_Thickness number 1.85 Wall thickness for shell and post walling. Typical FDM baseline: 1.2 to 2.4 depending nozzle/material.

Horizontal edges are square by default. These soften them. Both sizes default to 0, and at 0 the model renders exactly as it did before these existed.

Parameter Type Default Description Practical guidance
Bottom_Edge_Fillet number 0 Size of the treatment on the box’s outer bottom edge, in the shape Bottom_Edge_Style picks. Around 1.0 softens the profile and visually absorbs elephant foot. Capped at Wall_Thickness, and ignored entirely when a Gridfinity base is active, because that profile is dimensioned by the standard.
Bottom_Edge_Style enum "Fillet" Shape of that bottom edge: "Fillet", "Teardrop", or "Chamfer". Fillet is a quarter round, and its lowest layers overhang the bed, so keep it modest. Teardrop is a one-eighth round that ends in a 45 degree chamfer, so it keeps the rounded look and prints without an overhang. Chamfer is a plain 45 degree bevel. All three are Bottom_Edge_Fillet deep and tall, and only the box’s bottom edge uses this setting.
Top_Edge_Chamfer number 0 Chamfer on the box’s top rim and on both exposed lid edges. Around 0.6 takes the sharp edge off the rim you handle every time the lid comes off. Capped at Wall_Thickness, since the rim is only that wide. Ignored on the lid when a Gridfinity lid top is active.
Parameter Type Default Description Interactions
Enable_Post boolean true Adds a center post for cable organization. Affects bottom opening post-avoid behavior and lid post interface.
Closed_Post boolean false Makes the post floor solid instead of open through the box bottom. When false the post is a tube open at both ends. When true the bore starts above the floor, leaving a Wall_Thickness base.
Post_Diameter number 15 Outer post diameter. Also drives center clearance used by bottom post-avoid logic.
Parameter Type Default Description Tuning strategy
Lid_Style enum "Plug" "Plug" drops a ring just inside the box wall; "Skirt" wraps a wall around the outside of the box. Plug keeps the lid’s overhang as a finger grip, is notched around magnet bosses, and asserts if stabilizer fins or the post would reach it. Skirt touches nothing inside the box.
Lid_Height number 8.1 Height of lid wall above top plane. Increase for stronger lid walls and clip volume in sliced mode.
Lid_Lip_Gap number 0.15 Clearance on each side between the lip and the box wall it fits against. Also opens the lid’s post socket by the same amount. Tight fit: reduce by 0.05; loose fit: increase by 0.05. The default fitted well with both lid styles on a Bambu Lab P1S printing PLA+.
Lid_Lip_Gap_Height number 3 How far the lip, skirt or plug, reaches past the rim into the box. Taller lip improves hold; too tall may increase insertion force. With a Plug, stabilizer fins must stop this far below the rim.

The lid’s footprint is Box_Width + 2*(Wall_Thickness + Lid_Lip_Gap) by Box_Depth + 2*(Wall_Thickness + Lid_Lip_Gap) for both styles, which is exactly a skirt’s outside. A lip covers the top Lid_Lip_Gap_Height of any side opening that runs to the rim.

A friction-fit lid has nothing to grip. These give the lid somewhere to be held.

Parameter Type Default Description Practical guidance
Lid_Relief_Style string "None" None, Scallop or Tab. Scallop is a concave groove in the lid’s outer face: tidier, and it does not change the envelope. Tab is a protruding grip: more effective, and it widens the lid by Lid_Relief_Depth on each enabled side.
Lid_Relief_Width number 20 Length of the relief along the wall. Must stay clear of the rounded corners; the model asserts if it does not.
Lid_Relief_Depth number 2.5 How far a scallop cuts in, or a tab stands out. A scallop is a half cylinder, so this is both its depth and its half width; it must be under half of Lid_Height.
Lid_Relief_On_Left boolean true Relief on the left wall. Inert while Lid_Relief_Style is None.
Lid_Relief_On_Right boolean true Relief on the right wall. Mirrors the Opening_On_* convention.
Lid_Relief_On_Front boolean false Relief on the front wall.
Lid_Relief_On_Back boolean false Relief on the back wall.

A side is skipped automatically when an opening on that wall reaches the box rim. The relief is in the lid and openings are in the box, so they normally cannot meet; a full-height opening is the exception, and a tab standing over a hole grips nothing. The rim check uses the opening’s real top edge, so it counts that wall’s Move_Opening_*_Up as well as All_Openings_Up.

Lid_Relief_Width is checked against each enabled wall’s own length: Box_Width for Front and Back, Box_Depth for Left and Right.

Parameter Type Default Description Practical guidance
Enable_Lid_Magnets boolean false Mating magnet pockets in the box and lid. Held in bosses at the four inside corners, because the rim is only Wall_Thickness wide and a 6 mm magnet does not fit in it. Corners are also free of openings, stabilizers, the post and slice seams.
Lid_Magnet_Diameter number 6.2 Pocket diameter. Takes a nominal 6 mm magnet. Magnet diameters vary by supplier; increase if a press fit cracks the boss.
Lid_Magnet_Depth number 2.4 Pocket depth in each half. Each pocket takes its own magnet: one magnet per pocket, up to 2.4 mm thick at the default. The lid keeps material above its pocket, so the magnet is captured rather than visible.
Lid_Magnet_Wall number 1.2 Material around each pocket. Also sets the boss diameter, which is Lid_Magnet_Diameter + 2 * Lid_Magnet_Wall.

Insert the magnets with opposing poles facing. The geometry is symmetric in both axes so the pockets align however the lid is flipped onto the box, which also means it cannot enforce polarity for you.

Bosses run the full box height rather than hanging from the rim, so they print off the bed with no overhang and stiffen the corner.

Parameter Type Default Description Interactions
All_Opening_Width number 10 Default opening width on enabled side walls. Used unless side-specific width override is greater than 0.
All_Opening_Height number 30 Default opening height on enabled side walls. Must be > 0, and <= Box_Height while any side opening is on. This is the true opening height; the cut is anchored at its bottom edge, not centered on the box floor.
All_Opening_Corner_Radius number -1 Default corner radius for side openings. -1 keeps fully rounded ends; 0 is square; positive values are clamped to valid half-extents.
All_Opening_Top_Style enum "Round" Shape of each side opening’s top: "Round" or "Teardrop". Round arcs flatten near the top, and that part prints as an overhang. Teardrop turns each rounded top corner into a 45 degree flank with a short flat cap, so the top prints without support. The opening keeps its typed width and height. The cap is about 0.41 times the width for fully rounded ends. A square opening is unchanged. Applies to all four walls.
All_Openings_Right number 0 Global side-opening offset along each wall’s local left/right direction. Combines with each side-local Move_Opening_*_to_Right parameter.
All_Openings_Up number 5 Height of each side opening’s bottom edge above the box floor. 0 sits the opening flush with the box bottom, so a cable resting on the desk passes straight in. Raise it to lift openings off the surface. Combines with side-specific vertical offsets. An opening lifted past the rim is cut open as a notch, and the model reports it with an echo.
Opening_On_Right boolean true Enables right wall opening. Uses global size unless right override is set.
Opening_On_Left boolean true Enables left wall opening. Uses global size unless left override is set.
Opening_On_Front boolean true Enables front wall opening. Uses global size unless front override is set.
Opening_On_Back boolean true Enables back wall opening. Uses global size unless back override is set.
Parameter Type Default Description
Override_Opening_Width_Left number 0 Left opening width override; 0 keeps global width.
Override_Opening_Height_Left number 0 Left opening height override; 0 keeps global height.
Override_Opening_Corner_Radius_Left number -1 Left opening corner radius override; -1 keeps global corner radius.
Move_Opening_Left_to_Right number 0 Left wall opening depth shift; positive moves toward front (-Y).
Move_Opening_Left_Up number 0 Left opening vertical offset.
Parameter Type Default Description
Override_Opening_Width_Right number 0 Right opening width override; 0 keeps global width.
Override_Opening_Height_Right number 0 Right opening height override; 0 keeps global height.
Override_Opening_Corner_Radius_Right number -1 Right opening corner radius override; -1 keeps global corner radius.
Move_Opening_Right_to_Right number 0 Right wall opening depth shift; positive moves toward back (+Y).
Move_Opening_Right_Up number 0 Right opening vertical offset.
Parameter Type Default Description
Override_Opening_Width_Back number 0 Back opening width override; 0 keeps global width.
Override_Opening_Height_Back number 0 Back opening height override; 0 keeps global height.
Override_Opening_Corner_Radius_Back number -1 Back opening corner radius override; -1 keeps global corner radius.
Move_Opening_Back_to_Right number 0 Back wall opening lateral shift; positive moves toward left (-X).
Move_Opening_Back_Up number 0 Back opening vertical offset.
Parameter Type Default Description
Override_Opening_Width_Front number 0 Front opening width override; 0 keeps global width.
Override_Opening_Height_Front number 0 Front opening height override; 0 keeps global height.
Override_Opening_Corner_Radius_Front number -1 Front opening corner radius override; -1 keeps global corner radius.
Move_Opening_Front_to_Right number 0 Front wall opening lateral shift; positive moves toward right (+X).
Move_Opening_Front_Up number 0 Front opening vertical offset.
Parameter Type Default Description Interactions
Enable_Stabilizers boolean true Enables interior support fins. If false, all stabilizer parameters are ignored.
Stabilizer_Width number 1.5 Fin thickness along wall direction. Increasing count and width together can reduce usable interior area.
Stabilizer_Depth number 15 Fin extension from wall into interior. Larger values add stiffness but can obstruct cable routing.
Stabilizer_Height number 35 Fin height from floor upward. Keep below full box height if upper interior clearance is needed. With the default Plug lid, fins must stop Lid_Lip_Gap_Height below the rim.
Parameter Type Default Allowed values Description
Stabilizers_Front_Back_Count integer 3 0+ Number of fins on each of front and back walls.
Stabilizers_Front_Back_Alignment enum "Centered" "Centered", "Distributed", "Custom" Placement strategy for front/back fins.
Stabilizer_FB_Spacing number 3 >= 0 Gap between adjacent front/back fins in Centered and Custom modes.
Stabilizer_FB_Margin_Left number 15 any Left margin used in Distributed and Custom.
Stabilizer_FB_Margin_Right number 15 any Right margin used in Distributed and Custom.
Stabilizer_Avoid_Front_Opening boolean true true/false Skips front-wall fin positions that overlap opening area.
Stabilizer_Avoid_Back_Opening boolean true true/false Skips back-wall fin positions that overlap opening area.
Option Behavior
"Centered" Builds a centered fin cluster using Stabilizer_FB_Spacing.
"Distributed" Distributes fins between left/right margins.
"Custom" Starts from the custom start margin and uses fixed pitch (Stabilizer_Width + Stabilizer_FB_Spacing) when it fits; otherwise falls back to distributed placement inside margins.
Parameter Type Default Allowed values Description
Stabilizers_Left_Right_Count integer 0 0+ Number of fins on each of left and right walls.
Stabilizers_Left_Right_Alignment enum "Centered" "Centered", "Distributed", "Custom" Placement strategy for left/right fins.
Stabilizer_LR_Spacing number 3 >= 0 Gap between adjacent left/right fins in Centered and Custom modes.
Stabilizer_LR_Margin_Front number 15 any Front margin used in Distributed and Custom.
Stabilizer_LR_Margin_Back number 15 any Back margin used in Distributed and Custom.
Stabilizer_Avoid_Left_Opening boolean true true/false Skips left-wall fin positions that overlap opening area.
Stabilizer_Avoid_Right_Opening boolean true true/false Skips right-wall fin positions that overlap opening area.
Option Behavior
"Centered" Builds a centered fin cluster using Stabilizer_LR_Spacing.
"Distributed" Distributes fins between front/back margins.
"Custom" Starts from the custom start margin and uses fixed pitch (Stabilizer_Width + Stabilizer_LR_Spacing) when it fits; otherwise falls back to distributed placement inside margins.
Parameter Type Default Allowed values Description Interactions
Enable_Bottom_Openings boolean false true/false Enables floor cutouts in the box bottom. If false, all bottom opening params are ignored.
Bottom_Openings_Count integer 3 1+ recommended Number of floor openings. With post avoid enabled, count is split across both sides of post.
Bottom_Opening_Axis enum "Along X" "Along X", "Along Y" Axis used to arrange opening sequence. Defines which margins are primary vs secondary.
Bottom_Opening_Width number 15 any positive Short dimension of each opening. Combined with orientation to derive actual X/Y footprint.
Bottom_Opening_Depth number 30 any positive Long dimension of each opening. Combined with orientation to derive actual X/Y footprint.
Bottom_Opening_Orientation enum "Along Y" "Along X", "Along Y" Rotates opening shape independent of arrangement axis. Allows slot rotation without changing arrangement direction.
Bottom_Opening_Corner_Radius number 5 >= 0 Rounding radius for opening corners. Effective radius is clamped to opening half-extents.
Bottom_Opening_Spacing number 0 0+ Gap between neighboring openings. 0 enables auto-spacing from alignment mode.
Option Behavior
"Along X" Places multiple openings across box width.
"Along Y" Places multiple openings across box depth.
Option Behavior
"Along X" Rotates each opening so long axis points along X.
"Along Y" Rotates each opening so long axis points along Y.
Parameter Type Default Allowed values Description
Bottom_Opening_Alignment_Primary enum "Centered" "Centered", "Distributed", "Start", "End", "Custom" Placement mode on arrangement axis.
Bottom_Opening_Alignment_Secondary enum "Centered" "Centered", "Start", "End", "Custom" Placement mode on perpendicular axis.
Bottom_Opening_Avoid_Post boolean true true/false Splits and offsets openings around post when Enable_Post=true.
Bottom_Opening_Post_Margin number 2 >= 0 Minimum gap from post outer wall to nearest opening edge when post avoidance is enabled.
Option Behavior
"Centered" Centers total opening pattern in available area.
"Distributed" Evenly distributes openings between computed bounds.
"Start" Anchors pattern to start bound (left/front depending axis).
"End" Anchors pattern to end bound (right/back depending axis).
"Custom" Uses custom margins as explicit primary bounds.

Bottom_Opening_Alignment_Secondary options

Section titled “Bottom_Opening_Alignment_Secondary options”
Option Behavior
"Centered" Centers openings on perpendicular axis.
"Start" Anchors openings to start side using relevant margin.
"End" Anchors openings to end side using relevant margin.
"Custom" Centers the opening line within the custom margin window (left/right or front/back based on axis).
Parameter Type Default Description Used by
Bottom_Opening_Margin_Left number 10 Distance from inner left wall. Along X primary (Start/Custom), Along Y secondary (Start and Custom window).
Bottom_Opening_Margin_Right number 10 Distance from inner right wall. Along X primary (End/Custom), Along Y secondary (End and Custom window).
Bottom_Opening_Margin_Front number 10 Distance from inner front wall. Along Y primary (Start/Custom), Along X secondary (Start and Custom window).
Bottom_Opening_Margin_Back number 10 Distance from inner back wall. Along Y primary (End/Custom), Along X secondary (End and Custom window).
Parameter Type Default Description Constraints and notes
Enable_Slicing boolean false Enables split-part generation with mating clips. Recommended when full width exceeds printable bed area.
Slice_Count integer 2 Number of slices across width. Must be >= 2 for meaningful slicing.
Slice_Piece_To_Render integer 0 0 previews all pieces; non-zero renders one specific slice index. Must be an integer in range 0..Slice_Count.
Clip_Tolerance number 0.2 Clearance added to female clip geometry. Increase if clips are too tight.
Clips_Per_Edge integer 2 Number of clips along each split edge. Higher values improve alignment but add assembly friction.
Clip_Tab_Width number 10 Clip extent along split edge. Increase for strength; reduce if edge space is limited.
Clip_Tab_Depth number 4 Clip insertion depth. Deeper clips improve retention but may over-constrain fit.
Clip_Tab_Height number 3 Clip tab height. Larger values increase engagement force. Floor clips start at the floor’s bottom face, so anything above Wall_Thickness rises inside the box rather than hanging below the piece.
Slice_Preview_Spacing number 5 Gap between pieces in all-slices preview. Visual layout only; does not affect exported single-part geometry. Snap clips add their travel on top, so pieces never touch in the preview.
Clip_Style enum "Tab" "Tab" is the original friction fit; "Snap" is a BOSL2 cantilever snap clip. See the snap clip section below.
Seam_Tooth_Depth number 3 Depth of the 45 degree sawtooth cut through the walls at each seam. The teeth stop joined pieces sliding vertically. 0 gives a flat seam. Must be >= 0, and less than half a slice width minus Clip_Tolerance. See the seam teeth section below.

Above the floor, each seam zigzags at 45 degrees through the walls, the post, and any fin it crosses. The teeth have no undercut, so the pieces still push together along X, the way the floor clips go in. Once joined, the teeth stop the pieces sliding vertically, and the floor clips stop them sliding along the seam. Pulling the pieces apart is resisted only by a Snap clip or by glue.

  • The tooth period is twice the depth: 6 mm at the default 3 mm.
  • The two pieces’ profiles sit Clip_Tolerance apart, measured along X. That gap is also the most a joined pair can move vertically.
  • Through the floor the seam stays flat, so the floor clips keep their positions. A Gridfinity base is also cut flat.
  • Where a front or back opening crosses a seam, the teeth stop at the opening’s height range, because teeth there would leave slivers against its rounded edges. On the default box the seam crosses both openings, so the teeth run 15 mm above them and about 3 mm below.
  • On the lid, teeth run through the slab below the band the lid’s seam clips occupy. A front or back lid relief on the seam keeps the lid’s seam flat.
  • Every tooth face is at most 45 degrees from vertical, so the pieces print without supports.
Slice_Piece_To_Render value Result
0 Renders all slices in a preview layout.
1..Slice_Count Renders only the selected slice index (box and/or lid based on Part_To_Render).

The original "Tab" clip is a rectangle in a slightly larger rectangular hole, held by friction. Clip_Tolerance is its only tuning knob and it trades “will not go in” against “falls apart” with nothing in between.

"Snap" uses a real cantilever clip with an engagement bump. The arm flexes, so it absorbs print inaccuracy instead of jamming, and the bump resists pull-out rather than relying on interference.

Parameter Type Default Description
Clip_Snap_Length number 8 How far the clip travels into its socket. Must exceed Clip_Tab_Width / 2; below that the arm has no room to flex and the geometry cannot be built.
Clip_Snap number 0.4 Depth of the engagement bump. Larger holds harder and is harder to separate.
Clip_Arm_Thickness number 1.0 Arm thickness, which sets stiffness. Too thin snaps off; too thick will not flex.
Clip_Compression number 0.1 Extra width on the ears for a tighter fit.
Clip_Lock boolean false Makes the joint effectively permanent once assembled.

Under "Snap", Clip_Tab_Width becomes the clip’s base width, Clip_Tab_Height its extrusion depth, and Clip_Tolerance the clearance added to the socket. Clip_Tab_Depth is not used; snap clips need their own travel, which is what Clip_Snap_Length provides.

The default is deliberately still "Tab". Clip geometry is the one part of this model whose correctness cannot be established by rendering it: manifoldness, solid counts, and probes all pass for a joint far too tight to assemble or too loose to hold. "Snap" becomes the default once a print says it should.

Two independent, optional interfaces that let the box join a Gridfinity setup. Both default to off and change no geometry when disabled.

Parameter Type Default Description Interactions
Enable_Gridfinity_Bottom boolean false Adds solid Gridfinity feet under the box, built to the spec’s profile, so it drops into a 42 mm baseplate. Rounds the footprint up to whole cells (see below), and the lid grows with it. Mutually exclusive with Enable_Bottom_Openings. Requires Closed_Post=true when the post is enabled. Adds 4.75 mm to total height.
Enable_Gridfinity_Lid_Top boolean false Adds a Gridfinity baseplate to the lid’s exposed face: a plate with pockets cut to the spec profile, so bins or another box sit on the closed box. Adds 5.0 mm to lid height, and the lid is exported turned over so the pockets print facing up. The plug or skirt is then filled solid.
Gridfinity_Profile_Clearance number 0.25 Fit clearance on the lid-top pockets, and on every magnet pocket and screw hole. Measured against the 0.25 mm the standard already builds into the gap between a 41.5 mm foot and a 42 mm pocket, so the default reproduces the standard exactly. Raise it if bins are tight in the lid; the feet are unaffected, because they must stay at spec to fit anyone else’s baseplate.
Gridfinity_Edge_Keepout number 4 Margin from the lid edge before the first lid-top cell, used only when the base is off. Prevents thin, fragile cells at the lid’s perimeter. With Enable_Gridfinity_Bottom on, the lid instead takes the base’s own cell count so a second box stacks on the first, and the keepout is ignored. The base has ignored it since 2.0.0-rc.6, because its feet fill the rounded footprint.
Enable_Gridfinity_Magnet_Screw boolean false Adds magnet pockets to whichever interfaces are enabled; the bottom base also gets screw holes. The lid gets pockets only, because a through screw hole would breach the closed box. Lid pockets open at each cell’s floor. Both open onto the bed in their print orientations, so magnets go in after printing and neither needs a bridge.
Gridfinity_Magnet_Diameter number 6.25 Magnet diameter the pockets are cut for. Each pocket adds Gridfinity_Profile_Clearance, so the default gives the spec’s 6.5 mm pocket for a 6 mm magnet.
Gridfinity_Magnet_Depth number 2.4 Magnet pocket depth. In a foot, two bridging layers, each Print_Layer_Height tall, sit above the pocket, so the depth can be at most 4.75 - 2 * Print_Layer_Height: 4.35 mm at the default. In the lid, capped so 0.8 mm of material always remains above the pocket.
Gridfinity_Screw_Diameter number 3.2 Through screw hole diameter. Sized for M3, and adds Gridfinity_Profile_Clearance. In a foot it runs up to the box’s underside, and the floor above stays closed.

With Enable_Gridfinity_Bottom on, the footprint rounds up to whole cells. Box_Width and Box_Depth each become the smallest (N - 1) * 42 + 41.5 mm that is at least the typed value, which is the outside of N spec feet. The model echoes the size it built when that differs from what you typed:

ECHO: "Gridfinity base: box footprint rounded up to 125.5 x 83.5 mm (3 x 2 cells) from Box_Width x Box_Depth = 100 x 75"

The default 100 x 75 footprint therefore becomes 125.5 x 83.5, a 3 x 2 grid. Rounding up costs no baseplate area. A box wider than its feet would overhang them, and on a baseplate that overhang blocks the neighbouring cells anyway.

Every foot is solid. Where the box corner is rounder than a foot’s 3.75 mm corner, as at the default Box_Corner_Radius of 8.1, the four corner feet are trimmed to the box’s outline. They are then smaller than a spec foot, which a baseplate still accepts.

The lid top follows the base when the base is on. It holds exactly the base’s cells, so one box stacks on another. The lid is the rounded box plus a wall and a gap on each side, N * 42 + 3.5 mm, which leaves 1.75 mm beside the outermost pockets; the default 4 mm keepout would drop a whole column, so it does not apply. With only the lid top on there is no base to match, and the older layout stands: as many whole cells as fit inside the lid less Gridfinity_Edge_Keepout on each side, centred.

Because that margin is narrow, a lid rounder than about Box_Corner_Radius = 10 lets each corner pocket reach through the side of the lid. The model reports it and carries on; see Clamped Values Rather Than Assertions.

With Enable_Gridfinity_Lid_Top on, the exported lid is rotated 180 degrees about X, so its pockets face up and print with nothing bridging over them. The face that then lands on the bed is the lip’s, so the plug ring is filled solid; a Skirt lid’s pocket is filled too and keeps only a groove for the box wall. A plug that is solid in the model prints as infill, so it costs little filament.

Three things follow from the flip. The lid-face anchor moves to the top of the part, because it names the exposed face rather than a coordinate. The seam clips on a sliced lid move to the lip’s face so they start on the build plate. And the part is mirrored in Y relative to the modelled lid, which is simply what turning a part over does.

The base is added below the box, not carved out of the floor. Box_Height continues to describe the box body, so enabling Gridfinity never silently reduces interior volume; it increases total height instead. The model is lifted so the exported object still sits on z=0.

With an open post, the bore runs through the box floor. A Gridfinity base under that floor would block it, leaving a bore that goes nowhere. Rather than silently produce that, the model asserts. Set Closed_Post=true, or disable the post.

Parameter Type Default Description Interactions
Print_Layer_Height number 0.2 The layer height you slice at. Today only the two bridging steps above each Gridfinity foot’s magnet pocket read it. Each step is one layer tall. A slicer samples each layer near its middle height, so a step shorter than your real layers can fall between samples and vanish, and the pocket’s ceiling then sags. Set it to your layer height. Checked only when Enable_Gridfinity_Bottom and Enable_Gridfinity_Magnet_Screw are both on: it must be above 0 and at most 0.6 mm.
Parameter Type Default Description
Model_Version string current release Echoed at render so an exported STL can be traced back to its source.
Render_On_Include boolean true Set false to use the file as a library: modules and anchors become available without geometry appearing. See the attachment interface in the module reference.
$fn integer 40 Circle/arc resolution for cylinders and rounded geometry.
GF_* various Gridfinity spec Gridfinity standard dimensions (pitch, the foot’s and the pocket’s footprints and profiles, the plate height, hole offsets). Hidden because changing one produces a part that no longer mates with other Gridfinity gear, but still overridable with -D if you need to.
SPACER number 0.04 Internal modeling offset used for robust boolean operations and tiny clearances.

The model enforces these assertions. The Validation rules page explains each one and how to resolve it.

Box and wall:

  • Box_Width, Box_Depth, and Box_Height must be > 0.
  • Wall_Thickness must be > 0 and Wall_Thickness*2 must be less than min(Box_Width, Box_Depth).
  • Box_Corner_Radius must be >= 0.
  • With Bottom_Edge_Fillet above 0, Bottom_Edge_Style must be Fillet, Teardrop, or Chamfer.

Post:

  • Post_Diameter must exceed Wall_Thickness*2 so the post has a wall.
  • Post_Diameter must be less than min(Inner_Width, Inner_Depth).

Lid:

  • Lid_Style must be Skirt or Plug.
  • With Lid_Style=Plug, the interior must hold two Wall_Thickness ring walls plus Lid_Lip_Gap on each side.
  • With Lid_Style=Plug and stabilizers on, Stabilizer_Height + Wall_Thickness must not exceed Box_Height - Lid_Lip_Gap_Height.
  • With Lid_Style=Plug and the post on, Post_Diameter/2 + Lid_Lip_Gap must not reach the plug ring’s inside face.

Stabilizers:

  • Stabilizer_Height + Wall_Thickness must not exceed Box_Height.
  • Stabilizer_Depth*2 must be less than min(Inner_Width, Inner_Depth).
  • Stabilizer_Width must be > 0.
  • Stabilizer counts must be >= 0.
  • Stabilizer_FB_Spacing and Stabilizer_LR_Spacing must be >= 0.

Openings:

  • All_Opening_Height and All_Opening_Width must both be > 0.
  • All_Opening_Height must not exceed Box_Height.
  • Side opening width/height overrides must be >= 0.
  • Opening corner radius defaults/overrides must be >= -1.
  • While any side opening is on, All_Opening_Top_Style must be Round or Teardrop.

Bottom openings:

  • Bottom_Openings_Count must be >= 1 when bottom openings are enabled.
  • Bottom_Opening_Width and Bottom_Opening_Depth must be > 0 when enabled.
  • Bottom_Opening_Post_Margin must be >= 0.

Slicing and clips:

  • Slice_Piece_To_Render must be an integer in range 0..Slice_Count.
  • When slicing is enabled, Slice_Count must be >= 2.
  • When slicing is enabled, Clips_Per_Edge must be >= 1.
  • Clip_Tolerance must be >= 0.
  • Clip_Tab_Width, Clip_Tab_Depth, and Clip_Tab_Height must be greater than 0.
  • When slicing is enabled, Seam_Tooth_Depth must be >= 0, and Seam_Tooth_Depth + Clip_Tolerance must be less than half a slice width.
  • When slicing is enabled, the lid must offer Clip_Tab_Height plus 0.04 mm of material for its seam clips to sit in. That is Lid_Height on a plain lid, and Lid_Height + Lid_Lip_Gap_Height with the lid-top Gridfinity interface active, because the lid then prints turned over with its lip band filled.

Gridfinity:

  • Enable_Gridfinity_Bottom cannot be combined with Enable_Bottom_Openings, and it requires Closed_Post=true when the post is on.
  • With the base and magnets on, Print_Layer_Height must be above 0 and at most 0.6 mm.
  • With the base and magnets on, Gridfinity_Magnet_Depth must be > 0 and at most 4.75 - 2 * Print_Layer_Height (4.35 mm at the default), so the pocket and its two bridging layers fit inside a foot.

Box_Corner_Radius is clamped instead of rejected, because a too-large radius has an obvious correct interpretation (round the corners as much as the geometry allows). When clamping occurs the model emits an echo naming the requested and the applied value, so the difference is visible in the OpenSCAD console.

The footprint under a Gridfinity base is rounded up the same way, with an echo naming the typed and the built size. See “How the base is laid out” above.

  • Box_Width=120
  • Box_Depth=80
  • Box_Height=55
  • Wall_Thickness=1.8
  • Lid_Lip_Gap=0.15
  • Enable_Post=true
  • Box_Width=160
  • Box_Depth=100
  • Box_Height=60
  • All_Opening_Width=14
  • All_Opening_Height=36
  • Enable_Stabilizers=true
  • Stabilizers_Front_Back_Count=4
  • Enable_Slicing=true
  • Slice_Count=3
  • Slice_Piece_To_Render=1 (export each slice individually)
  • Clip_Tolerance=0.25 (start conservative, tune after test print)

When parameters are added, removed, renamed, or default values change:

  1. Update this file in the same commit as SCAD changes.
  2. Update docs/FAQ.md if behavior impact is likely user-visible.
  3. Update README.md if workflow or folder structure changes.