# Gingerbread & Cookie Cutter Generator

Design 1-piece 3D printable gingerbread and cookie cutters with tapered blades, embossing details, stamps, plungers, nested sets, names, or custom SVG paths.

- Page: https://paramlet.com/tools/gingerbread-cutter/
- Tool id: `gingerbread-cutter` · version 0.1.0 · Paramlet Module Spec 1.1 · API version 1 · docs: https://paramlet.com/agents/
- Category: workshop / molds-casting · status: beta
- Parameter schema (JSON Schema): https://paramlet.com/tools/gingerbread-cutter/schema.json · presets: https://paramlet.com/tools/gingerbread-cutter/presets.json
- Core parameters (`exportFormat`, `exportTol`, `units`) are in schema.json under `x-coreParams`, not `properties`; both are accepted.
- Presets: `classic-gingerbread` (Classic gingerbread man (100 mm)), `star-set-3` (Star set (3 nested)), `house-windows` (House with window details), `heart-stamp` (Heart with stamp), `name-anna` (Name cutter "ANNA"), `tree-plunger` (Tree with plunger). Each has a page: https://paramlet.com/tools/gingerbread-cutter/classic-gingerbread/, https://paramlet.com/tools/gingerbread-cutter/star-set-3/, https://paramlet.com/tools/gingerbread-cutter/house-windows/, https://paramlet.com/tools/gingerbread-cutter/heart-stamp/, https://paramlet.com/tools/gingerbread-cutter/name-anna/, https://paramlet.com/tools/gingerbread-cutter/tree-plunger/
- Deep link with parameters: `https://paramlet.com/tools/gingerbread-cutter/?p=<url-encoded JSON>` or single values `?key=value`
- Deep link with a project: `https://paramlet.com/tools/gingerbread-cutter/#project=<base64url project JSON>` (8,000 characters max)
- In the page: `window.paramlet` (getSchema, getParams, getState, setParams, loadProject, getProject, exportModel, exportSTL, export3MF).
- WebMCP tools: `gingerbread_cutter_get_parameter_schema`, `_get_state`, `_set_parameters`, `_load_project`, `_download`.
- Validation: unknown keys and out-of-range values are rejected; nothing is applied from an invalid request. Keys with x-agentSafe false can only be changed in the page.
- Output: 3mf, stl (default 3mf), millimetres, parts lying on the bed in print orientation. Every download contains README.txt and parameters.json (a project file).
- Downloads: free and unlimited at launch; API exports use the same download path as the button, including a short page with recommended products (affiliate links) that the user closes before the file starts.
- Export types: `3mf`, `stl`.

## Features

- 12 built-in holiday and classic shapes with optional 1-piece embossing detail ridges
- Name/letter cutter mode with built-in vector stroke font (no external fonts)
- Safe single-path SVG parser with simplification and self-intersection checks
- Tapered cutting blade (0.4-1.2 mm tip) with reinforcing grip rim
- Optional debossed stamp with handle, fitted dough plunger, and nested cutter sets
- Live readouts for outline length, cookie area, print mass, and cookies per 30x40 cm sheet

## Use cases

- Print classic gingerbread men, houses, stars, and trees sized to your baking tray
- Create personalized name or initial cookie cutters for holidays and parties
- Turn a single closed SVG silhouette into a tapered, food-contact-aware cutter
- Generate matching debossed cookie stamps, dough plungers, and nested cutter sets

## Safety

- Use food-contact certified PETG or PLA only; never use ABS, ASA, or photopolymer resin for food.
- Avoid porous layer seams on the cutting blade: tune extrusion, use 2-3 perimeters, and place the Z-seam away from the blade tip.
- Hand wash in warm (not hot) soapy water and dry thoroughly; never dishwasher-wash 3D printed cutters.
- Intended for short-duration contact with cold/chilled dough; inspect for cracks or residue and replace periodically.
- Thin 0.4-0.6 mm blade tips can be sharp; supervise children when handling freshly printed cutters.

## FAQ

**Which filament is safest for 3D printed cookie cutters?**
Use food-contact certified, unpigmented PETG (recommended) or PLA. Print with a clean stainless-steel nozzle and smooth layer lines; never use ABS, ASA, or standard UV resin.

**How should I clean and use a 3D printed cookie cutter?**
Hand wash gently in warm soapy water immediately after use and air dry completely. Never put printed cutters in a dishwasher. Keep dough contact brief, avoid porous layer seams on the cutting edge, and replace cutters if they show wear.

**Do the cutters, stamps, or plungers need print supports?**
No. Every part is oriented flat on z = 0: cutters print rim-down with the tapered blade up, stamps print debossed-face down with the handle up, and plungers print plate-down with a 45-degree chamfered cap.

**What SVG files work in custom SVG mode?**
Paste a single closed SVG path (or upload an SVG containing one). Open paths, multiple disconnected subpaths, and self-intersecting loops are rejected with a clear warning.

## Parameters

| key | label | type | range / values | default | agents |
|---|---|---|---|---|---|
| `source` | Outline source | string | preset|text|svg | "preset" | yes |
| `shape` | Built-in shape | string | gingerbread-man|gingerbread-woman|star|heart|tree|house|bell|mitten|snowflake|deer|circle|scalloped-circle | "gingerbread-man" | yes |
| `textString` | Name or letter | string | string | "ANNA" | yes |
| `svgPath` | SVG path data (d) | string | string | "" | yes |
| `sizeMm` | Longest side | number | 30–150 mm (step 1) | 100 | yes |
| `cutHeight` | Cut height | number | 8–20 mm (step 0.5) | 14 | yes |
| `bladeTip` | Blade tip thickness | number | 0.4–1.2 mm (step 0.05) | 0.6 | yes |
| `wallThickness` | Wall thickness | number | 1–3 mm (step 0.1) | 1.6 | yes |
| `rimWidth` | Rim flange width | number | 2–10 mm (step 0.5) | 5 | yes |
| `rimHeight` | Rim flange height | number | 1.6–5 mm (step 0.2) | 2.6 | yes |
| `innerDetails` | Inner embossing ridges | integer | 0|1 | 1 | yes |
| `detailRecess` | Detail recess below blade | number | 2–8 mm (step 0.5) | 3.5 | yes |
| `includeStamp` | Separate embossing stamp | integer | 0|1 | 0 | yes |
| `stampText` | Stamp text (optional) | string | string | "" | yes |
| `embossDepth` | Stamp deboss depth | number | 0.8–2.4 mm (step 0.2) | 1.2 | yes |
| `includePlunger` | Fitted dough plunger | integer | 0|1 | 0 | yes |
| `clearance` | Stamp / plunger clearance | number | 0.2–2 mm (step 0.05) | 0.6 | yes |
| `nestedCount` | Cutters in nested set | integer | 1–5 count (step 1) | 1 | yes |
| `nestedStep` | Size shrink step | number | 5–25 mm (step 1) | 15 | yes |
| `nozzleSize` | Nozzle diameter | number | 0.4–0.8 mm (step 0.1) | 0.4 | yes |
| `printMaterial` | Print material | string | petg|pla | "petg" | yes |
| `resolution` | Curve resolution | integer | 24–96 count (step 4) | 48 | yes |
| `color` | Preview colour | string | string | "#c86d3b" | yes |
