Formatos para importar

Qué lleva por dentro un módulo de D&D en JSON, un sistema del creador en JSON y un libro en texto o PDF, con ejemplos para bajar y cómo escribirlo para que se lea bien.

Roliando lee de fuera tres tipos de archivo para crear contenido: el JSON de un módulo de D&D (el que tú mismo exportas), el JSON de un sistema del creador, y texto o PDF de un libro (Markdown, TXT, PDF, Homebrewery). Esta guía dice qué lleva cada uno por dentro y cómo escribir un texto para que el importador lo entienda a la primera. Cada formato tiene un ejemplo inventado que puedes bajar y abrir con cualquier editor de texto.

Módulo de D&D en JSON

Dónde: en el formulario Nuevo módulo, el botón Importar módulo (.json) crea un módulo nuevo y privado con todo lo que trae el archivo. Dentro de un módulo ya abierto, Más, Importar módulo (.json) añade las entradas del archivo a ese módulo (las que ya tengas no se tocan). Junto al selector de archivo hay un enlace Descargar ejemplo.

El archivo es el mismo que baja Más, Exportar el módulo (JSON) o la exportación de una categoría suelta, así que sirve para guardar copias, pasar un módulo a otra cuenta o editarlo a mano.

Forma del archivo

{
  "format": "roliando-module",
  "version": 1,
  "category": "feat",
  "module": { "name": "…", "edition": "2024" },
  "entries": [ { "category": "feat", "name": "…", "data": {} } ]
}

Lo que no viaja y se pone al importar: los ids, el dueño, las fechas, el module_id, el precio y la publicación. Un módulo importado nace siempre privado y sin publicar; publicarlo lo decides tú después. Los slug de las entradas se vuelven a generar con el prefijo del módulo de destino (son únicos en toda la app) y las referencias de una entrada a otra se actualizan.

Campos de cada entrada

Truco: no escribas data a mano desde cero. Crea la entrada en el editor, expórtala y usa ese JSON como plantilla; o parte del ejemplo, que trae una de cada: una dote, un conjuro, un objeto mágico, una especie y una subclase.

Sistema del creador en JSON

Dónde: en el creador de sistemas, El sistema entero, Importar un sistema (y el mismo archivo lo baja Descargar archivo). Admite pegar el texto o traer el archivo, y enseña un resumen de lo que va a entrar antes de aplicarlo; puedes añadir a lo que ya hay o reemplazar.

Descarga el ejemplo mínimo: sistema-ejemplo.json (en inglés: sistema-ejemplo-en.json). Trae tres atributos tirables, una defensa calculada, una reserva de vida y las reglas de la tirada.

Bloques principales

Los campos calculados usan fórmulas con las claves de otros campos: "derived_formula": "8 + brazo + FLOOR(ojo / 2)". Una reserva (resource) lleva max_formula. Todo lo que el importador no entiende se descarta con un aviso, nunca en silencio, y las claves repetidas se renombran.

Texto y PDF de un libro (Markdown, TXT, PDF, Homebrewery)

Dónde: dentro de un módulo, Más, Importar homebrew. Acepta un archivo .md, .txt o .pdf, el texto pegado, o buscar y traer uno de Homebrewery. Antes de guardar nada, el importador enseña lo que ha reconocido y puedes cambiar el tipo, renombrar o descartar cada entrada.

Importar como… Si lo abres desde el Bazar (la búsqueda fuera de Roliando, botón Importar de un resultado de Homebrewery) o fuera de un módulo, el importador propone qué es el libro y te deja cambiarlo antes de seguir: Módulo de D&D, Aventura (un capítulo por encabezado, con imágenes enlazadas, tablas y criaturas reconocidas, en el creador de aventuras), Mundo de una campaña (lugares, facciones, historia y misiones como entradas del Libro del Mundo, y los personajes como PNJ) o Documento (un capítulo del Libro del Mundo por sección). Mundo y documento entran ocultos. En un mundo se crean además las relaciones entre entradas (un lugar dentro de otro, quién vive dónde, miembros de una facción, a quién sirve cada cual), los nombres de otras entradas pasan a [[enlaces]], y si la campaña tiene mapa los lugares entran como pines por colocar (sin inventar coordenadas: los arrastras tú). Las imágenes se copian a tu almacenamiento (casilla activada por defecto; las que no se puedan copiar quedan enlazadas), las criaturas con ficha pueden guardarse también como PNJ de tu biblioteca, y las tablas de tirada, en tu biblioteca.

El importador no se fía de los nombres de las secciones: clasifica por lo que llevan dentro. Descarga el ejemplo, que usa justo estas pistas: modulo-ejemplo.md.

Cómo reconoce cada tipo

Las pistas están en inglés (los términos del juego en el que se basan los libros), pero el texto de dentro puede ir en el idioma que quieras.

Escribirlo para que se lea bien

• Los títulos arman las secciones. Un # para el libro, ## para cada capítulo (Especies, Dotes, Conjuros…) y ### o #### para cada entrada. La ruta de títulos se guarda como la ubicación de la entrada.
• Cada entrada, en su propio título. Una dote o un conjuro son una sección; sus párrafos y viñetas van debajo.
• Los rótulos en negrita y con dos puntos: Casting Time: 1 action.
• Un párrafo suelto de introducción bajo el título del libro se lee como una regla más. Si no la quieres, quítala o muévela a un capítulo propio y descártala en la revisión.
• Tablas en Markdown (| a | b |) se conservan.
• TXT es lo mismo que MD: se lee igual, solo que sin extensión de Markdown. Un .txt exportado de Homebrewery vale tal cual.

Qué formato rinde mejor

1. Homebrewery (texto/.txt) o Markdown propio. Conserva negritas, cursivas y títulos, que es justo de lo que se fía el importador. Es lo más fiable.
2. PDF con texto. Se lee en tu navegador (el archivo no sale de tu ordenador), reconstruyendo títulos y negritas por el tamaño y el tipo de letra. Funciona, pero un PDF de maquetación compleja (columnas, recuadros, fondos) pierde estructura.
3. PDF escaneado o en imagen: no funciona. Si no puedes seleccionar el texto con el ratón, no hay texto que leer y el importador no hace OCR.

Importas material que ya posees. Lo importado queda en un módulo privado. No compartas ni publiques contenido de terceros sin tener derecho a hacerlo.

Véase también

Importar un sistema: JSON, paquete, tablas y Roll20, Importar libros y homebrew: archivo, texto y Homebrewery, Importar contenido, Creador de módulos, Creador de sistemas: primeros pasos.

Todas las guías de Roliando