> 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-sign-and-poster-studio/troubleshooting.md).

# Troubleshooting

CAS Sign & Poster Studio troubleshooting: signs not showing, restarts, full slots, the striped stand-in, database errors and AI Design errors.

## A sign does not show after the export

A new or changed design reaches players only after a **server restart**, and each player must **rejoin** to load it. Until then the design shows **WAITING FOR THE RESTART** in the **Saved** tab, and staff see its signs as a grey striped board with an hourglass.

{% hint style="danger" %}
Never restart `cas-signstudio` on its own while players are online after an export. Streamed files that change under a running game can crash clients. Restart the whole server.
{% endhint %}

## A design says "Needs export"

Its file is gone from `cas-signstudio/stream/` (a reinstall, a folder copied over). Open it from the **Saved** tab and export it again. Its signs come back after the next restart.

## "Every slot of this shape is in use"

Each shape has its own slots (30 hanging boards, 40 posters, 20 sandwich boards, 30 newspaper pages, 30 small, 30 medium, 20 large, 20 door, 20 wide and 10 extra large panels). Delete designs of that shape you no longer use: the slot is free again after the next restart. One design can be placed as many times as you like: it uses one slot however many signs show it.

## A sign floats away from the door it was on

A sign fixed to a door finds the door again by its model near where the door stood. If a map change moved or replaced that door, move the sign again (Signs tab, Move) or place it anew.

## "Too far from you"

A sign must be within `Config.PlaceRange` metres of you (30 by default). Walk closer, or raise the setting.

## "The database refused the design"

Raise MySQL's packet limit in `my.ini` under `[mysqld]`: `max_allowed_packet=16M`, then restart MySQL. Or use fewer or smaller pictures.

## AI Design

| Message                                | What to do                                                 |
| -------------------------------------- | ---------------------------------------------------------- |
| AI Design is not set up on this server | Set `ss_ai_provider` and `ss_ai_key` in `server.cfg`.      |
| The AI key was refused                 | Check the key; for fal it starts with your key id.         |
| The AI account has no credit left      | Top up the account at your AI provider.                    |
| The AI took too long                   | Try again; a busy provider can take more than two minutes. |

## The console names slot files that belong to no design

Files in `stream/` that no design uses (a deleted database, an old test) are never handed out. Run `signstudio_cleanup` in the server console: they are removed at the next restart.