Cómo funciona un libro#
Todo gira en torno al ítem del libro. Cada copia lleva un id de libro en sus metadatos (bookUid), y ese id apunta a un libro guardado — su portada, sus páginas, sus imágenes. El ítem es el libro: allá donde vaya el ítem, el libro va con él.
El ítem | Qué pasa al usarlo |
|---|---|
En blanco — todavía sin id de libro | Se escribe un id nuevo en el ítem y el editor se abre con un libro vacío. |
Escrito | Un menú titulado Book ofrece Open — leerlo — y Edit — abrir el editor con todo ya dentro. |
Al guardar un libro, los metadatos del ítem se actualizan con bookUid, bookTitle y author, así que un inventario que muestre metadatos indica a los jugadores qué libro tienen.
No hay comando ni panel de administración. Los libros se escriben, leen y cambian solo usando el ítem — o se abren desde tus propios scripts, como muestra Exports y eventos.
Escribir un libro#
El editor es una ventana con dos partes: Book Settings — lo que va en la portada — y Pages. El minimapa se oculta mientras está abierto, y también el HUD de qs-interface cuando está en marcha.
La portada#
Campo | Notas |
|---|---|
Book Title | Obligatorio. Se imprime en la portada y se guarda en el ítem. |
Author | Obligatorio. Se imprime bajo el título. |
Cover Image URL | Opcional. La imagen que llena la portada. Sin ella, la portada es de cuero oscuro con esquinas doradas. |
Description | Opcional. Un breve texto impreso en la portada bajo el autor. |
Páginas#
Add Page añade una página al final. Cada página tiene cuatro campos:
Campo | Cómo se lee |
|---|---|
Page Title | Opcional. Un encabezado con serifa en la parte superior de la página. |
Subtitle | Opcional. En cursiva, bajo el encabezado, seguido de una línea ornamental. |
Content | Obligatorio. Texto plano — cada salto de línea empieza un nuevo párrafo con sangría. |
Image URL | Opcional. Una imagen colocada encima del texto, con un ligero tono sepia. |
Las flechas junto a cada página la mueven arriba o abajo, y la papelera la elimina. Las páginas se detienen en Config.BookDefaults.maxPages — 50 por defecto — donde el botón pasa a Maximum pages reached.
Guardar y eliminar#
Acción | Qué pasa |
|---|---|
Save | Primero comprueba los campos obligatorios — uno que falte se resalta y aparece Please fill in all required fields. Si no, el libro se guarda, la ventana se cierra y Book saved successfully lo confirma. |
Delete | Solo al editar un libro escrito. Pide confirmación y después elimina el libro de la base de datos. |
| Cierra sin guardar. Lo escrito desde el último guardado se pierde. |
Eliminar vacía el libro, no el ítem. El ítem conserva su id: Open ahora indica This book has no data, y Edit empieza un libro nuevo en el mismo ítem.
Imágenes#
Las imágenes de portada y de página son direcciones web que carga el propio juego de cada lector, así que deben ser públicas y apuntar directamente al archivo de imagen — la dirección de la imagen en sí, normalmente terminada en .png, .jpg o .webp, no una página que la muestra. Usa un hosting que mantenga los enlaces permanentes; los enlaces de adjuntos de Discord caducan al cabo de un tiempo y la imagen desaparece del libro.
Leer un libro#
Open muestra el libro a pantalla completa. Empieza cerrado, en la portada — título, autor, texto e imagen de portada — y se abre en dobles páginas sobre papel envejecido, cada una numerada al pie.
Control | Función |
|---|---|
Las flechas bajo el libro | Pasan la página, con animación y sonido. |
El contador entre ellas | Cover, luego Page 3 of 12. |
Haz clic fuera del libro, o | Lo cierra. |
Un libro solo se abre cuando tiene título y al menos una página. Con un número impar de páginas, la última doble página termina en una ~ Back Cover ~ en blanco.
Copias del mismo libro#
Dos ítems que llevan el mismo bookUid son dos copias de un mismo libro. Así es como un servidor reparte el mismo texto a muchos jugadores — un reglamento para cada recién llegado, una carta en cada mesa, un manual para cada agente: escríbelo una vez y luego reparte ítems que apunten a él. Exports y eventos muestra cómo hacerlo con cada inventario.
Quién puede escribir#
La escritura depende del ítem. Quien usa un libro en blanco lo escribe, y quien tiene un libro escrito puede editarlo. Así que decides quién escribe decidiendo quién recibe libros en blanco:
Véndelos en una tienda que solo pueda abrir un trabajo — una biblioteca, un periódico, el ayuntamiento.
Haz que se fabriquen con papel, para que escribir cueste algo.
Déjalos solo para administradores y da a los jugadores copias terminadas o libros de solo lectura.
Config.CreatorJobs (police y ambulance por defecto) no se comprueba al usar o guardar un libro. Tus propios scripts aún pueden consultarlo mediante el callback book:hasPermission — true para los administradores y para los trabajos listados ahí.
Idiomas#
Se incluyen 41 traducciones en locales/: ar · bg · bn · ca · cs · da · de · el · en · es · et · fa · fi · fr · he · hi · hr · hu · id · it · ja · ko · lt · lv · ms · nl · no · pl · pt · ro · ru · sk · sl · sv · sw · th · tr · uk · ur · vi · zh.
La interfaz lee sus textos de locales/en.json. Para jugar en otro idioma, copia el contenido del archivo de ese idioma — locales/es.json para español — sobre locales/en.json, configura Config.Locale con el mismo código y reinicia. Cualquier texto se puede reformular de la misma forma.
Guarda una copia de tu
en.jsoneditado antes de actualizar — una nueva versión vuelve a incluir el archivo en inglés.