Llama BuilderBeta

Reference Manual

Earrings

Design studs, hoops, and dangles for The Sims 4, with materials and multi-piercing arrangements, exported as a Create-a-Sim .package file.

Earrings are CAS (Create-a-Sim) content: 3D jewelry worn in the game's earring slot. You build each earring from a style (stud, hoop, or dangle), place its piercing anywhere on the ear, and stack up to five per ear; Llama Builder generates the meshes.

Workflow

  1. Pick a style: stud, hoop, or dangle. Each style keeps its own settings while you decide.
  2. Place the piercing: snap to a preset (lobe, helix, tragus, and more) or slide the earring anywhere on the ear.
  3. Build the arrangement: click Add earring to stack up to five earrings per ear, each with its own style and placement.
  4. Choose the pairing: the same design on both ears (mirrored or identical), or a different arrangement per ear.
  5. Set the materials: every earring gets its own metal, gem, and finish, per swatch.
  6. Set restrictions: which ages and frames can wear the earrings.
  7. Add swatches: each swatch recolors the whole arrangement; they all ship in one .package.
  8. Fill in details: name and description. Catalog placement is handled by the Tags section.
  9. Download: click Download and install via the Install in Game guide.

Styles

Switching styles never loses your work; each style remembers its own settings.

  • Stud: a decorative face on a post. Pick the face shape from the jewelry library (gems, hearts, stars, and more) and set its width in millimeters. Real studs usually run 3 to 8 mm.
  • Hoop: a full ring through the piercing. Set the Diameter (from snug 6 mm huggies to bold 25 mm rings), the wire Thickness, and the Facets count. High counts read as smooth circles; low counts give a deliberately faceted, geometric look.
  • Dangle: a hanging drop below the ear. Choose the connector (a Hook french ear-wire or a simple Post with a ring), add up to five Chain links in oval or round style with an adjustable size, and pick the Drop from the library.

Instead of a library drop, you can sculpt your own: the profile editor revolves your outline around its vertical axis, the same idea as the vase shape editor at earring scale. Drag a point to move it, click the outline to add one, and double-click a point to remove it (a drop needs at least three). The Drop size slider scales the finished silhouette.

Dangles are rigid in-game and do not sway with movement, a Sims limitation shared by all custom content.

Placement and arrangements

Each ear wears an arrangement of up to five earrings. The arrangement list shows every earring on the ear you're editing, labeled by its piercing location and style. Click an earring to select it: the style, placement, and material controls all edit the selected one, and it glows teal in the preview when the ear wears more than one. Add earring starts a new stud on the next free piercing location, and removes one (an ear always keeps at least one).

Placement controls where the selected earring pierces the ear:

  • Presets cover the common piercings: lobe, upper lobe, helix (top rim), forward helix, mid helix (back rim), tragus, and conch. Picking one snaps the earring there.
  • Sliders move it anywhere: height, front/back, in/out, plus a tilt that rotates hoops and dangles in the ear plane. Nudging a slider switches the placement to Custom.

The Left Ear and Right Ear camera views frame that side's whole ear, so you can judge a placement against the other piercings.

Pairing

The pairing controls decide how the two ears relate:

  • Same on both ears uses one design for the pair, with a choice of Mirrored (the right ear is a mirror image, which is how matched jewelry is usually worn) or Identical (the design reads exactly the same on both ears).
  • Different per ear gives each ear its own arrangement. Use the Left ear and Right ear tabs to pick which one you're editing; the preview always shows both.

Materials

Materials are per earring: select an earring in the arrangement list, then color it in the Materials section. Each swatch stores a full set of materials for every earring, so one design can ship as a gold swatch, a silver swatch, and anything else.

  • Metal: colors the wire parts (posts, hoops, hooks, and chain links). Use a solid color for classic metals (gold #d4af37, silver #c0c0c0, rose gold #b76e79) or a gradient for two-tone looks.
  • Gem: colors the decorative pieces (stud faces and dangle drops). Solid colors read as opaque stones or enamel; gradients give a faceted, light-catching impression.
  • Finish: a treatment painted over the metal. Polished adds a bright highlight band, Brushed adds fine directional lines, and Matte stays flat.

Preview

Sims come in two body frames, and their ears sit differently: the masculine ear is a little taller, flatter, and further forward. When your restrictions allow both frames (the default), the exported mod includes a separately placed version for each, adapted automatically from your design. The frame toggle switches which frame's ear the preview shows; it never changes what the mod contains.

The skin tone picker tints the preview's ear models so you can judge the pair against different complexions. It is also a preview aid only.

Restrictions

Restrictions control who the earrings appear for in Create-a-Sim. The default (all frames, Teen through Elder) matches how the game's own earrings ship. The body slot itself is fixed: earrings always occupy the game's earring slot, covering both ears with a single part.

Tips

  • One well-placed lobe stud is a complete, downloadable project; arrangements can grow later.
  • Mix materials across the arrangement: a pearl lobe stud next to a gold helix hoop reads more like real jewelry than five identical pieces.
  • Check both frames with the preview toggle before downloading, especially for tight custom placements.

Controls reference

Style

Earring Styles

Pick stud, hoop, or dangle. Each style remembers its own settings.

Earrings come in three styles:

  • Stud: a single decorative face on a post.
  • Hoop: a classic ring through the lobe.
  • Dangle: a hook or post with an optional chain and a hanging drop.

Switching styles never loses your work: each style keeps its own settings, so you can flip between them freely while deciding.

Pair & Symmetry

Same design on both ears (mirrored or identical), or a totally different earring per ear.

Controls how the two earrings relate:

  • Same on both ears: one design for the pair, with a choice of:
    • Mirrored: the right ear is a mirror image (how matched jewelry is usually worn; a twisted design leans opposite ways).
    • Identical: the design reads exactly the same on both ears.
  • Different per ear: each ear gets its own arrangement of earrings. Use the Left ear / Right ear tabs to pick which one you're editing; the preview always shows both.

Materials are per earring: select an earring and set its metal, gem, and finish in the Materials section.

Multiple Earrings

Stack up to five earrings per ear, each one fully customizable and positioned on its own piercing.

Each ear wears an arrangement of up to five earrings. The list shows every earring on the ear you're editing, labeled by its piercing location and style.

  • Click an earring to select it. The style and placement controls below edit the selected one, and it glows teal in the preview when the ear wears more than one.
  • Add earring starts a new stud on the next free piercing location.
  • removes an earring (an ear always keeps at least one).

Use the Left Ear / Right Ear camera views to zoom in while you arrange. Each frames that side's whole ear.

Piercing Placement

Snap to a common piercing preset, or slide the earring anywhere on the ear and tilt it.

Where the selected earring pierces the ear.

Presets cover the common piercings: lobe, upper lobe, helix (top rim), forward helix, mid helix (back rim), tragus, and conch. Picking one snaps the earring there.

Sliders move it anywhere: height, front/back, in/out, plus a tilt that rotates hoops and dangles in the ear plane. Nudging a slider switches the placement to Custom.

Placements mirror with the pair, so a left-helix earring sits on the right helix too. The Left Ear / Right Ear camera views frame the whole ear so you can judge a placement against the other piercings.

Stud Settings

Choose the face shape from the jewelry library and set its size in millimeters.

Studs are a decorative face sitting on the earlobe.

  • Face shape picks from the jewelry piece library: gems, hearts, stars, and more.
  • Size sets the face's width in millimeters. Real studs usually run 3–8 mm.

Hoop Settings

Set the ring's diameter, wire thickness, and facet count.

Hoops are a full ring passing through the lobe.

  • Diameter: from snug 6 mm huggies to bold 25 mm rings.
  • Thickness: the wire gauge.
  • Facets: how many segments form the ring. High counts read as smooth circles; low counts give a deliberately faceted, geometric look.

Dangle Settings

Pick a hook or post connector, style the chain, and choose or sculpt the hanging drop.

Dangles hang a decorative drop below the ear.

  • Hook / Post is the connector through the piercing: a french ear-wire (the chain hangs from its short front leg) or a simple post with a ring.
  • Chain links: up to five links between the connector and the drop, in oval or round style, with an adjustable size.
  • Drop: pick a shape from the library, or sculpt your own silhouette with the profile editor.

Dangles are rigid in-game, so they don't sway with movement (a Sims limitation shared by all custom content).

Custom Drop Silhouette

Sculpt the drop's outline; it revolves into the 3D shape, like the vase editor.

The silhouette you draw here is revolved around its vertical axis to build the hanging drop, the same idea as the vase shape editor, at earring scale.

  • Drag a point to move it. Points keep their vertical order.
  • Click anywhere on the outline to add a new point.
  • Double-click a point to remove it (a drop needs at least three).

The Drop size slider scales the finished silhouette; wider outlines make wider drops.

Materials

Metal Material

The selected earring's metal color, solid or gradient. Gold, silver, rose gold, or anything else.

The metal material colors the SELECTED earring's wire parts: posts, hoops, hooks, and chain links. Pick which earring you're editing in the Style section's arrangement list. Every earring can wear its own metal.

Use a solid color for classic metals (gold #d4af37, silver #c0c0c0, rose gold #b76e79) or a gradient for two-tone looks.

Gem Material

The selected earring's gem color (stud faces and dangle drops), solid or gradient.

The gem material colors the selected earring's decorative pieces: stud faces and dangle drops. Like the metal, it's per earring, so mix a pearl lobe stud with an emerald helix.

Solid colors read as opaque stones or enamel; gradients give a faceted, light-catching impression.

Metal Finish

Polished adds a bright highlight, brushed adds fine lines, matte stays flat.

The finish is a treatment painted over the metal color:

  • Polished: a bright highlight band, like freshly buffed metal.
  • Brushed: fine directional lines, like brushed steel.
  • Matte: flat color with no treatment.

Preview

Preview Ear Frame

Preview your design on the feminine or masculine ear. Placements adapt per frame automatically.

Sims come in two body frames, and their ears sit differently: the masculine ear is a little taller, flatter, and further forward. When your earrings allow both frames (the default), the game gets a separately-placed version for each, adapted automatically from your design.

This toggle switches which frame's ear the preview shows, so you can check both without leaving the editor. It's a preview aid only, and the exported mod always includes every frame your Restrictions allow.

Skin Tone

Tints the preview's ear models so you can judge the pair against different complexions.

The skin tone tints the ear models in the preview so you can judge how your earrings read against different complexions. It's a preview aid only, and it has no effect on the generated mod.

Restrictions

Restrictions

Which Sims can wear these earrings: ages and frames; unisex by default.

Restrictions control who the earrings appear for in Create-a-Sim.

The default (all frames, Teen through Elder) matches how the game's own earrings ship. The body slot itself is fixed: earrings always occupy the game's earring slot, covering both ears with a single part.