> For the complete documentation index, see [llms.txt](https://docs.yeistudios.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yeistudios.com/scripts/safe-zone/troubleshooting.md).

# Troubleshooting

***

## Troubleshooting

### "ERROR CRÍTICO: la tabla 'Shared' no existe"

{% hint style="danger" %}
`config.lua` no se cargó, está corrupto, o hay un `config.lua` viejo mezclado en la carpeta.
{% endhint %}

1. Revisa que `config.lua` esté en `shared_scripts` del fxmanifest.
2. Confirma que empieza con `Yei = Yei or {}`.
3. Borra cualquier `config.lua` de una versión anterior mezclado.

### "Base de datos no lista todavía (intento X/15)"

* Confirma el orden en `server.cfg`: `ox_lib` → `oxmysql` → `yei-safezone`.
* Revisa las credenciales de conexión de `oxmysql`.
* El bridge reintenta automáticamente 15 veces — si falla todas, revisa la conexión a MySQL directamente.

### El panel no abre con `/safezone`

* Confirma el permiso ACE `yei.safezone` (o que `Restricted = false`).
* Revisa que el `add_principal` use exactamente tu `identifier.license`.

### "No tienes permisos para..." al crear/editar/borrar

* Cada acción del panel revalida el ACE por separado en el servidor.
* Confirma que no haya un typo entre `yei.safezone` (config) y el `add_ace` en `server.cfg`.

### "Datos inválidos o puntos insuficientes"

* Necesitas marcar como mínimo `Validation.MinPoints` (4 por defecto) puntos antes de confirmar.

### "Ya existe una zona con el nombre: X"

* Los nombres son únicos (constraint `UNIQUE`). Cambia el nombre o edita/borra la zona existente.

### El TextUI no aparece al entrar a una zona

* Verifica que `textUI` no esté desactivado para esa zona específica.
* Confirma `Creator.Options.textUI = true` en `config.lua`.

### El jugador no queda invencible dentro de la zona

* Revisa `Yei.Config.Invincible` — si es `false`, es el comportamiento esperado.

### Los logs de Discord no llegan

{% hint style="info" %}
Verifica que `Discord.Webhook` no sea `false` **y** que el evento específico tenga `Enabled = true`.
{% endhint %}

### ¿Sigues con problemas?

{% hint style="success" %}
Todos los errores aparecen en consola prefijados como `[YeiSafeZone]`. Contacta soporte con el mensaje exacto, tu `config.lua` (sin el webhook si es privado) y las versiones de `ox_lib`/`oxmysql`.
{% endhint %}


---

# 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.yeistudios.com/scripts/safe-zone/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.