> 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-weddingvenue/guests-and-celebrations.md).

# Guests and Celebrations

NPC wedding guests, applause, confetti, fireworks and sound in CAS Wedding Venue: crowd modes, guest counts, performance and the celebration effects.

For filming, events or a quiet server's wedding, staff can fill the venue with NPC guests and set off a celebration over the altar.

## NPC guests

```
/wedding_crowd all
/wedding_crowd ceremony
/wedding_crowd reception
/wedding_crowd off
```

| Mode        | Guests                                                                                                                                                          |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ceremony`  | Seated in the rows facing the arch, some fanning themselves. Standing along the sides and behind the rows. The string quartet plays                             |
| `reception` | At the guest tables eating and drinking. On the fountain benches. Standing in pairs with champagne or a cigar. Waiters in formal wear. The string quartet plays |
| `all`       | Both at once                                                                                                                                                    |

The guests are Saint Denis society, men and women, in random outfits. **Every player sees the same guests on the same seats.** The couple's sweetheart table is always left free.

The guests appear for players within 110 m of the venue and stay until staff send them home with `/wedding_crowd off`, or until the next restart.

### Applause

```
/wedding_clap [seconds]
```

The guests applaud for 8 seconds by default, 60 at most. Seated guests clap over their seated pose, with the arms of the Saint Denis theatre audience. Standing guests use the clapping of the Mayor's own garden party. Applause comes with sound.

### Performance

The guests are created on each player's own game. RedM has room for about 150 characters at once, counting players, horses, animals and townsfolk. The crowd is capped at 80 guests (`maxGuests`), and while the guests are out, new townsfolk and animals stop spawning around the venue (`suppressAmbient`).

If players see characters vanish or the game warns about a full pool, lower `maxGuests`.

## Celebrations

```
/wedding_confetti
/wedding_confetti fireworks
/wedding_confetti all
```

| Command                       | Fires                                          |
| ----------------------------- | ---------------------------------------------- |
| `/wedding_confetti`           | Confetti over the altar                        |
| `/wedding_confetti fireworks` | Confetti and fireworks                         |
| `/wedding_confetti all`       | Confetti, fireworks and 10 seconds of applause |

Everyone within 150 m sees it.

| Effect        | What it is                                                                                                                                                         |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Confetti**  | 18 bursts of flower petals over the couple, each tinted a different colour: white, blush, gold, pale blue and rose. Then petals drifting on the wind for 8 seconds |
| **Fireworks** | 12 bursts of the Mayor's own garden party fireworks from the story, high over the garden behind the arch, in warm white, pink, blue and gold                       |
| **Applause**  | The NPC guests clap, if they are out                                                                                                                               |

### Sound

Confetti, fireworks and applause come with sound, heard from the camera. Each plays at full volume up close and fades to silence with distance. Firework booms arrive late when far away, as they would.

| Sound     | Full volume within | Silent beyond |
| --------- | ------------------ | ------------- |
| Confetti  | 6 m                | 60 m          |
| Fireworks | 40 m               | 450 m         |
| Applause  | 12 m               | 90 m          |

A wedding script can fire the same celebration when a couple is married. See [Using It With a Wedding Script](/script-documentation/cas-weddingvenue/integration.md).

## Settings

The guests are set in `Config.Crowd` and the celebration in `Config.Celebration`. See [Configuration](/script-documentation/cas-weddingvenue/configuration.md#npc-guests) for every option.