Qué falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría son problemas de configuración, no fallos, y activar Config.Debug = true hace que la consola indique qué framework e inventario se eligieron. Compruébalo primero.
Instalación#
El recurso se detiene al iniciar con un error que menciona custom.standalone
No había ningún framework compatible en ejecución cuando se inició Books Creator. Asegúrate de que es_extended, qb-core o qbx_core se inicie con ensure antes de qs-book-creator en server.cfg. Books Creator no funciona sin un framework.
Usar el libro no hace nada
En ox_inventory, al ítem le falta
server = { export = 'qs-book-creator.useBook' }, o se cambió el nombre de la carpeta del recurso.En los demás, el ítem no está marcado como
useable, o su nombre es distinto deConfig.BookDefaults.item.El inventario se inicia después de Books Creator, así que nunca se detectó.
En ps-inventory, todavía no hay adaptador; Integraciones muestra la solución de dos líneas.
Con Config.Debug = true, un inicio correcto muestra Registered usable book item: book seguido del nombre de tu inventario.
"This book has no data" en cuanto se usa cualquier libro
El inventario detectado es standalone: no hay ninguno en ejecución que pueda guardar metadatos de ítems, o se inicia demasiado tarde. El inventario clásico de ESX no puede guardar un libro: usa ox_inventory, qs-inventory u otro compatible, e inícialo antes de Books Creator.
Errores de base de datos que mencionan qs_books
La tabla nunca se creó. Importa database.sql en la base de datos que usa tu servidor y asegúrate de que oxmysql se inicie primero y se conecte.
El editor o el lector es una pantalla en blanco
La interfaz viene lista en web/build/. Si esa carpeta falta o está subida a medias (algo común con clientes FTP que omiten archivos), vuelve a descargar el recurso desde el CFX Portal y sube la carpeta completa. No cambies nada dentro de web/.
Escritura y lectura#
El mismo libro abre un editor vacío cada vez
El id del libro nunca llegó al ítem, así que cada uso parece un libro en blanco. Dos causas:
El ítem se apila. Configura
stack = false(ox_inventory) ounique = true(en los demás).El adaptador del inventario todavía no puede escribir metadatos: Origen, Core, Codem, Tgiann y AK47. Integraciones explica la función que falta.
"This book has no data" al abrir un libro escrito
El libro no tiene título o no tiene páginas, o se eliminó. Elige Edit en el ítem, añade al menos una página y guarda.
"Please fill in all required fields"
El título, el autor o el Content de una página está vacío. El editor se desplaza al primero y lo resalta.
"Failed to update book"
El servidor rechazó el guardado: no pudo leer el personaje del jugador o la base de datos rechazó la escritura. Busca un BOOK ERROR o una línea de oxmysql en la consola del servidor en ese momento.
Add Page aparece desactivado
El libro alcanzó Config.BookDefaults.maxPages (50 por defecto). Auméntalo en config/main.lua y reinicia.
Editar un libro cambió las copias de otros jugadores
Es el comportamiento correcto: los ítems que llevan el mismo bookUid son copias de un mismo libro. En su lugar, reparte texto de solo lectura con el export openBook; consulta Uso → Copias del mismo libro.
Cualquiera puede escribir o editar un libro
La escritura depende del ítem: quien tiene un libro en blanco lo escribe, y quien tiene uno escrito puede editarlo. Controla quién recibe libros en blanco: Uso → Quién puede escribir tiene ideas.
Las imágenes no se muestran
La dirección no es un enlace directo y público al archivo de imagen, o ha caducado (los enlaces de adjuntos de Discord caducan pasado un tiempo). Abre la dirección en una ventana privada del navegador: deberías ver solo la imagen, no una página a su alrededor. La consola F8 del juego muestra una carga fallida cuando el enlace está roto.
Los textos siguen en inglés después de cambiar Config.Locale
La interfaz lee locales/en.json. Copia encima el archivo de tu idioma y reinicia: Uso → Idiomas.
Mensajes#
Lo que ven los jugadores, la clave de idioma que hay detrás y lo que significa:
Mensaje | Clave | Significado |
|---|---|---|
This book has no data |
| Sin título ni páginas, un libro eliminado o un inventario sin metadatos. |
Book saved successfully |
| Guardado en la base de datos y el ítem actualizado. |
Failed to update book |
| El servidor rechazó el guardado. Lee la consola. |
Book removed successfully |
| Eliminado de la base de datos. Sus ítems siguen ahí, vacíos. |
Please fill in all required fields |
| El título, el autor o el contenido de una página está vacío. |
Maximum pages reached |
| El límite de páginas de |
¿Sigues atascado? Abre un ticket e incluye la consola de tu servidor con
Config.Debug = true, tu framework y tu inventario con sus versiones, y una captura de la consola F8 para cualquier problema de la interfaz.