# Christmas ornament generator

Design personalised 3D-printable Christmas tree ornaments—balls, stars, snowflakes, hearts, bells, medallions and trees—with custom text and patterns.

- Page: https://paramlet.com/tools/christmas-ornament/
- Tool id: `christmas-ornament` · version 0.1.0 · Paramlet Module Spec 1.1 · API version 1 · docs: https://paramlet.com/agents/
- Category: workshop / organizers · status: beta
- Parameter schema (JSON Schema): https://paramlet.com/tools/christmas-ornament/schema.json · presets: https://paramlet.com/tools/christmas-ornament/presets.json
- Core parameters (`exportFormat`, `exportTol`, `units`) are in schema.json under `x-coreParams`, not `properties`; both are accepted.
- Presets: `classic-ball` (Classic ball with name), `snowflake-6` (6-arm snowflake), `faceted-star` (Faceted star), `heart-date` (Heart with date), `tea-light-lantern` (LED tea-light lantern ball), `kids-medallion` (Kids' flat medallion). Each has a page: https://paramlet.com/tools/christmas-ornament/classic-ball/, https://paramlet.com/tools/christmas-ornament/snowflake-6/, https://paramlet.com/tools/christmas-ornament/faceted-star/, https://paramlet.com/tools/christmas-ornament/heart-date/, https://paramlet.com/tools/christmas-ornament/tea-light-lantern/, https://paramlet.com/tools/christmas-ornament/kids-medallion/
- Deep link with parameters: `https://paramlet.com/tools/christmas-ornament/?p=<url-encoded JSON>` or single values `?key=value`
- Deep link with a project: `https://paramlet.com/tools/christmas-ornament/#project=<base64url project JSON>` (8,000 characters max)
- In the page: `window.paramlet` (getSchema, getParams, getState, setParams, loadProject, getProject, exportModel, exportSTL, export3MF).
- WebMCP tools: `christmas_ornament_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

- Seven ornament shapes: ball, star, snowflake, heart, bell, medallion and tree
- Auto-fitting two-line text: embossed, debossed, cut-through or separate two-colour part
- Five surface patterns including ribs, twist, deterministic Voronoi holes and knurl
- Support-free print orientation with loop, hole or hook-pocket cap hanger
- Optional LED tea-light pocket plus live mass, filament length and print time readouts

## Use cases

- Print personalised name and year baubles for family and gifts
- Generate unique procedural 6-arm snowflakes from any seed
- Make hollow LED tea-light lantern ornaments for safe warm glow
- Print two-colour kids medallions with a simple filament swap or AMS

## Safety

- LED tea-lights and fairy lights only — never place a real flame or hot incandescent bulb inside a 3D-printed ornament.
- Small ornaments, caps and hooks can be a choking hazard for young children.

## FAQ

**Do these ornaments need print supports?**
Most configurations print completely support-free: balls split into two flat-bottomed halves or a vase-friendly shell, and flat/faceted shapes rest directly on the bed.

**Can I use a real candle in the tea-light pocket?**
No. Only use battery-powered LED tea-lights or fairy lights. Real flames will melt or ignite 3D-printed plastic.

**How do I print two-colour text without an AMS?**
Enable the separate text part or use embossed text on a flat medallion, then add a colour-change pause in your slicer at the first text layer.

## Parameters

| key | label | type | range / values | default | agents |
|---|---|---|---|---|---|
| `shape` | Ornament shape | string | ball|star|snowflake|heart|bell|medallion|tree | "ball" | yes |
| `size` | Size (diameter / width) | number | 30–120 mm (step 1) | 70 | yes |
| `wallThickness` | Wall thickness | number | 0.8–5 mm (step 0.2) | 1.6 | yes |
| `ballMode` | Ball construction | string | two-half-snap|two-half-glue|vase-shell | "two-half-snap" | yes |
| `starStyle` | Star style | string | faceted|flat | "faceted" | yes |
| `starPoints` | Star points | integer | 5–8 count (step 1) | 5 | yes |
| `flakeSeed` | Snowflake seed | integer | 1–9999 count (step 1) | 2026 | yes |
| `flakeArms` | Snowflake arms | integer | 6–8 count (step 1) | 6 | yes |
| `flakeDepth` | Branch depth | integer | 1–3 count (step 1) | 2 | yes |
| `flakeAngle` | Branch angle | number | 30–75 deg (step 5) | 55 | yes |
| `textMode` | Text style | string | none|emboss|deboss|cutout | "emboss" | yes |
| `line1` | Line 1 (name / year) | string | string | "NOEL" | yes |
| `line2` | Line 2 (optional) | string | string | "" | yes |
| `textDepth` | Text relief depth | number | 0.4–3 mm (step 0.2) | 1 | yes |
| `twoColorText` | Separate two-colour text part | integer | 0|1 | 0 | yes |
| `pattern` | Surface pattern | string | none|ribs|twist|voronoi|knurl | "ribs" | yes |
| `patternCount` | Pattern density | integer | 6–32 count (step 2) | 16 | yes |
| `patternDepth` | Pattern depth | number | 0.4–3 mm (step 0.2) | 1.2 | yes |
| `hangerType` | Hanger style | string | loop|hole|cap | "loop" | yes |
| `hangerHoleDia` | Hanger hole diameter | number | 2–10 mm (step 0.5) | 4 | yes |
| `lightPocket` | LED tea-light pocket | integer | 0|1 | 0 | yes |
| `lightDiameter` | Tea-light diameter | number | 18–45 mm (step 0.5) | 38.5 | yes |
| `clearance` | Fit clearance | number | 0.1–0.8 mm (step 0.05) | 0.25 | yes |
| `printMaterial` | Print material | string | pla|petg | "pla" | yes |
| `resolution` | Mesh resolution | integer | 16–64 count (step 4) | 36 | yes |
| `color` | Preview colour | string | string | "#c81e1e" | yes |
