> For the complete documentation index, see [llms.txt](https://code-after-sex.gitbook.io/script-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://code-after-sex.gitbook.io/script-documentation/cas-wedding/invitations.md).

# Wedding Invitations

The wedding invitation studio in the RedM Wedding & Marriage System: ten themes, fonts, papers, wax seals and envelopes, printing sealed copies, handing them to guests and tracking who opened them.

Couples design their own invitations, print them as sealed items and hand them to their guests. A guest uses the invitation to open the envelope, read the card and mark the venue on their map.

## Opening the studio

Hold **G** at the county clerk, or choose **Make Invitations** in the booking window. The studio is for engaged and married couples, and either partner can use it. Both partners see and edit the same invitations.

The first time, the studio starts with an invitation already filled in with the couple's names. A couple can keep up to **5** invitation designs (`Config.Invitations.MaxDrafts`), for example one for family and one for friends. Use **+ New**, **Duplicate** and **Delete** to manage them, and the arrows to move between them.

## Designing

The card is shown large on the left, front or back (**Flip the card**), with a zoom. The editor on the right has five tabs.

### Wording

The subtitle, the bride's and the groom's names, optional labels above the names (*The Bride*, *The Groom*) and the main message. Every text has a sensible default, such as *request the honour of your presence as they are joined in holy matrimony*.

### Details

* **Date, time, ceremony location and address.** **Fill in from my booking** writes them from the couple's booking, with the date and time in words.
* **Family text** and the names of both sets of parents.
* **Witnesses** and the **officiant.** **Pick nearby** fills in the names of players standing close. The witness field only appears when ceremonies have witnesses.
* **RSVP**, a **footer** and the text for the **back of the card**.

### Design

| Option                 | Choices                                                                                                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Theme**              | Classic Elegance, Floral Garden, Rose Bouquet, Royal Ceremony, Vintage Parchment, Golden Script, Minimal Ceremony, Rustic Wedding, Noble Paper, Handwritten Love |
| **Paper**              | Ivory Laid, Cream Linen, Pearl Grey, Antique Parchment, Parchment, Noble Ink, Wine Velvet                                                                        |
| **Paper finish**       | Deckled parchment, Pressed card                                                                                                                                  |
| **Border**             | Fine rule, Double rule, Engraved frame, or none                                                                                                                  |
| **Corners**            | Brackets, Tri-corners, Stars, Diamonds, or none                                                                                                                  |
| **Ornament**           | Plain rule, Diamond rule, Star rule, Title bar, or none                                                                                                          |
| **Flowers & keepsake** | Seven flowers from the game, Golden Rings, Pearl Strand, or none                                                                                                 |
| **Front layout**       | Classic, Framed names, Monogram crest                                                                                                                            |
| **Back layout**        | Family & details, Verse, Minimal                                                                                                                                 |
| **Text colour**        | Ink, Sepia, Wine, Charcoal, Dove, Ivory                                                                                                                          |

A theme sets all of these at once. Change any of them afterwards.

### Font

The title, subtitle and body each take one of five Red Dead Redemption 2 fonts: RDR Lino, Hapna Slab, RDR Gothica, Redemption and RDR Catalogue. Title size, text size, line spacing, weight, an upright or script slant and the alignment are adjustable.

### Envelope

The inner liner (Wine, Ink, Pearl, Ivory), the wax seal (Medallion, Shield Crest, Rosette, or none), the wax colour, the mark pressed into it (the couple's monogram, a star, a diamond, or plain) and whether the seal is also pressed onto the card.

**Save** keeps the design. **Open as guest** shows the invitation exactly as a guest opens it.

## Confirming and printing

A design is printed only once it is **confirmed as final**. Choose **Confirm Final**. The bride's and the groom's names must be filled in. A confirmed design is locked. Choose **Edit** to unlock it again.

{% hint style="info" %}
Every copy shows the invitation as it currently stands. If a couple edits a design after printing it, the copies already in their guests' hands show the new version too.
{% endhint %}

Then choose **Print copies**, pick how many and **Print**:

|                  | Default                       |
| ---------------- | ----------------------------- |
| Copies per print | 1 to 50 (`MaxCopiesPerPrint`) |
| Price per copy   | $0.30 (`CopyPrice`)           |

Printing is done at the county clerk. The copies go straight into the satchel as `wedding_invitation` items, each sealed in its envelope. The print is refused if they would not fit.

## Handing them out

Choose **Give copy**. The players within 4 m are listed with their distance. Pick up to 8 at once. Each gets one copy from your satchel, addressed to them by name, and a notification.

Invitations can also be passed on through the inventory like any other item. A copy that is not addressed to anyone shows the name of whoever opens it.

The studio counts each design's copies: **printed · given · opened · in satchel**. The couple gets a notification the first time each guest opens theirs.

## Opening an invitation

A guest uses the invitation from their satchel:

1. The sealed envelope appears, addressed to them. Click it to break the seal.
2. Drag the letter out of the envelope.
3. Click the card to turn it over and read the back.
4. **Mark the chapel on my map** places a wedding marker on the venue for 30 minutes (`MapBlipMinutes`). It only appears while the couple has a ceremony booked.

The envelope also shows the booked date and hour, in the guest's own time zone.

## Settings

Each player has a few preferences, under **Settings** in the marriage records. They are saved on the player's own computer.

| Setting                                  | Effect                                                                                                             |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Theme for new invitations                | The theme a new design starts with                                                                                 |
| Title font for new invitations           | The title font a new design starts with                                                                            |
| Start new invitations with my last theme | Uses the last theme you chose instead                                                                              |
| Animate opening invitations              | The envelope animation. Turn off for an instant open                                                               |
| Smooth signatures                        | Smooths signature strokes as they are drawn                                                                        |
| Clock                                    | Automatic, 12-hour or 24-hour                                                                                      |
| Also show server time                    | Shows the server time next to your own. See [Time and Time Zones](/script-documentation/cas-wedding/time-zones.md) |

## Settings for server owners

```lua
Config.Invitations = {
    CopyPrice = 0.3,
    MaxCopiesPerPrint = 50,
    MaxDrafts = 5,
    GiveDistance = 4.0,
    MapBlipMinutes = 30,
}
```

{% hint style="warning" %}
On VORP, keep the `wedding_invitation` item's `limit` at least as high as `MaxCopiesPerPrint`. vorp\_inventory refuses a print larger than the limit.
{% endhint %}
