> 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/troubleshooting.md).

# Troubleshooting

Fix common problems in the RedM Wedding & Marriage System: items that do nothing, framework not found, ceremonies that will not begin, the embrace not playing, invisible venue props and wrong times.

## Start with the console

When the resource starts correctly, the server console shows:

```
[cas-wedding] Database ready.
```

| Console shows                                                   | Fix                                                                                                                                                                    |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `No supported framework is running yet (vorp_core or rsg-core)` | Start cas-wedding after your framework, or set `Config.Framework = "vorp"` or `"rsg"`. See step 2 of [Installation](/script-documentation/cas-wedding/installation.md) |
| Nothing about cas-wedding                                       | The resource is not started. Check `ensure cas-wedding` in `server.cfg` and the folder name                                                                            |
| An oxmysql error                                                | oxmysql is not running or cannot reach the database. Start it before cas-wedding                                                                                       |

## Items

**Using a ring, an invitation or a certificate does nothing.**

* The item is missing from your inventory's item list. Add it. See step 3 of [Installation](/script-documentation/cas-wedding/installation.md).
* On VORP, the items were added while the server was running. vorp\_inventory reads its `items` table only when it starts, so restart the server.
* The item is not marked usable. On VORP `usable` must be `1`, on RSG `useable = true`.

**"You cannot carry that many invitations."**

The satchel has no room for the copies. On VORP, also check that the `wedding_invitation` item's `limit` is at least `Config.Invitations.MaxCopiesPerPrint` (50):

```sql
UPDATE items SET `limit` = 50 WHERE item = 'wedding_invitation';
```

Restart the server after changing it.

**The items have no pictures in the satchel.**

Copy `install/images/*.png` to your inventory's image folder. See step 4 of [Installation](/script-documentation/cas-wedding/installation.md).

**"The ink has faded. This invitation can no longer be read."**

The invitation belongs to a design or a marriage that is no longer in the database, for example after the tables were emptied.

## Proposals

**"No one close enough. Stand beside the person you wish to marry."**

The other player must be within 2.5 m (`Config.Proposal.Distance`).

**The proposer cannot kneel.**

They cannot kneel on horseback, in a wagon, in water, while seated or while ragdolled. A notification says which.

**The embrace does not play after a yes.**

* The embrace is made for one male and one female character. Other couples are engaged normally and skip it.
* *The ground is too uneven here to embrace.* The two players stand on ground more than 30 cm apart in height. Propose on flatter ground.
* *You could not line up to embrace.* Something blocked them from reaching their places. Leave a little room around the couple.
* `Config.Proposal.Embrace.Enabled` is `false`.

**The ring box or the embrace animation is missing.**

The `stream` folder is missing or incomplete. Replace the resource folder with a fresh copy.

{% hint style="warning" %}
Do not rename `stream/pa_embrace_mf.ycd`. The animation's clips refer to it by that name, and a renamed file loads but plays nothing.
{% endhint %}

## Booking

**"Only engaged couples can book a ceremony."**

The character is not engaged. Propose with a ring first.

**"Speak to the clerk to book a ceremony."**

Booking, invitations and divorce petitions are done in person at a county clerk. Stand at the clerk's counter.

**Every hour shows Closed.**

The hours are less than 30 minutes away or already past, or the day is in `Config.Booking.ClosedWeekdays`. Look at the following days.

**The hours shown look wrong.**

Every hour is shown in the player's own time zone, read from their computer's clock. If the server runs on a machine set to another zone than you expect, pin it with `Config.ServerUtcOffset`. See [Time and Time Zones](/script-documentation/cas-wedding/time-zones.md).

## The ceremony

The notification says why a ceremony cannot begin:

| Message                                                                  | Fix                                                            |
| ------------------------------------------------------------------------ | -------------------------------------------------------------- |
| *Stand at the altar to begin.*                                           | Stand within 3 m of the altar spot on the aisle                |
| *You have no ceremony booked at this chapel.*                            | The couple's booking is at another office, or they have none   |
| *Your ceremony is booked for ... Come back 15 minutes before it begins.* | It is not their hour yet. The altar opens 15 minutes before it |
| *... must be here for the ceremony.*                                     | The partner is not online                                      |
| *... must stand at the altar with you.*                                  | The partner is more than 15 m from the altar                   |

**The ceremony ended by itself.**

A partner went more than about 22 m from the altar, or 30 minutes passed without sealing. The booking is kept, so the couple can begin again while their window is open. See [When a ceremony stops](/script-documentation/cas-wedding/ceremony.md#when-a-ceremony-stops).

**A player cannot be chosen as officiant.**

Their job is not in `Config.Ceremony.PlayerOfficiantJobs`. On RSG these jobs do not exist by default. See [Player officiants](/script-documentation/cas-wedding/frameworks.md#player-officiants).

**A spouse did not get a certificate.**

Their satchel was full. They can print a copy from **View Certificate** in the marriage records.

## The venue

**The venue is empty.**

* Staff may have hidden it. Use `/wedding_venue on`.
* `Config.Venue.EnabledByDefault` is `false`.
* The `stream` folder is missing, or `stream/cas_weddingvenue.ytyp` is not loaded. Keep the `data_file` line in `fxmanifest.lua`.

**Characters vanish or the game warns about a full pool while NPC guests are out.**

RedM has room for about 150 characters at once. Lower `Config.Venue.Crowd.maxGuests`, or clear the guests with `/wedding_crowd off` when they are not needed.

**The staff commands say I am not allowed.**

Grant the ACE permission. See [Permissions](/script-documentation/cas-wedding/commands.md#permissions).

## The interface

**A menu opens black or does not open.**

The `web/dist` folder is missing or incomplete. It is the built interface. Replace the resource folder with a fresh copy.

**A menu is stuck on screen.**

Press **Escape** to close it. Restarting the resource also releases it.