> For the complete documentation index, see [llms.txt](https://docs.sonoransoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonoransoftware.com/store/street-signs/faq-and-troubleshooting.md).

# FAQ and Troubleshooting

## Frequently Asked Questions

### Do I need a database?

No. Street Signs stores sign data locally and does not require MySQL or `oxmysql`.

### Where is sign data stored?

Street Signs stores sign data in:

```
data/signs.json
```

### Why can I walk up to a sign but not edit it?

Being close to a sign is not enough by itself. The server still checks whether your account or job has edit permission for that sign.

Review [Permissions](/store/street-signs/permissions.md).

### Why are some sign types missing?

Some built-in sign packs are disabled by default. Check:

```lua
Config.EnabledPacks
```

If a pack is set to `false`, its related sign options will not be available.

### How do I allow more staff to use Street Signs?

That depends on your chosen permission mode:

* ACE: add the correct ACE objects to the desired group
* Standalone: add player identifiers to `Config.StandaloneAllowed`
* QBCore or ESX: add the correct jobs and grades in the config

### Can I use Street Signs without Sonoran CAD?

Yes. If you do not need CAD features, disable them in:

```lua
Config.CAD.enabled = false
```

### Can I log sign changes to Discord?

Yes. Configure `Config.Webhooks` and provide the webhook URL you want to use.

## Troubleshooting

### The resource starts but my config is not being used

Make sure you renamed:

```
config.CHANGEME.lua -> config.lua
```

Then restart the resource.

### I cannot create signs

Check the following:

* `Config.PermissionMode`
* Your ACE permissions, identifiers, or framework job setup
* Whether you are using the correct command

Test command:

```
/signcreate test_sign Test Sign
```

### I cannot open the full controller

`/signcontroller` is intended for admin-level access. Confirm that your account has the appropriate admin permission in the mode you selected.

### Signs do not appear for players

Check:

* The resource is started correctly
* The sign is enabled
* Players are close enough to the sign for it to render
* The sign pack used by that sign is enabled

### Sign text was blocked unexpectedly

Street Signs uses banned-word substring matching. Review:

```lua
Config.BannedWords
```

Short or broad entries may block more content than expected.

### My webhook messages are not posting

Check:

* `Config.Webhooks.enabled = true`
* The correct webhook URL is set
* The correct subsection URL is set for the webhook you want to use
* The server can reach Discord

### Auto update is not working

Check:

* `Config.Updater.EnableAutoUpdate = true`
* The `sonoran-streetsigns_helper` resource is installed
* These ACE permissions are present:

```cfg
add_ace resource.sonoran-streetsigns command allow
add_ace resource.sonoran-streetsigns_helper command allow
```

### I changed config values and nothing happened

After editing `config.lua`, restart the resource or restart the server so the updated settings are loaded.

## Still Need Help?

If the issue continues after reviewing your config, permissions, and startup order, collect:

* Your current `Config.PermissionMode`
* The affected command or workflow
* Any server console errors
* Whether the problem affects all signs or only some signs

That will make support and troubleshooting much faster.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sonoransoftware.com/store/street-signs/faq-and-troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.