- Overview
- Scorecard
- Updates2
Un motor de juego de rol en solitario integrado directamente en tu vault de Obsidian.
EThis is the Spanish version of the documentation. For the English version, see ->
README-en.md.
OPSE Oracle es un plugin para Obsidian que implementa el sistema completo de One Page Solo Engine v1.6 — el motor minimalista todo-en-uno para jugar cualquier TTRPG sin Director de Juego. Automatiza tiradas, consultas al oráculo, generación de contenido y rastreo de exploración, dejando al jugador libre para interpretar e improvisar.
Características
Motor OPSE v1.6 completo
- Oráculo Sí/No con tres niveles de probabilidad (3+/4+/5+) y modificadores
pero…/y… - Oráculo ¿Cuánto? con escala de magnitud de 6 niveles
- Focos de Oráculo: Acción, Detalle, Tema y Foco Doble — con soporte para naipes y dados
- Movimientos del DJ: Movimientos de Ritmo y de Fallo (basados en PbtA)
- Evento Aleatorio combinado (Acción + Tema)
Generadores de contenido
- Gancho Argumental — Objetivo, Adversarios, Recompensa (3×d6)
- Generador de PNJ — Identidad, Objetivo, Rasgo, Actitud, Tema de conversación
- Contenido Genérico — Acción, Apariencia, Magnitud
- Giro de Trama y Ambiente / Clima
Motor de escena
- Tirada de Complicación de Escena (d6)
- Chequeo de Escena Alterada (1d6 ≥ 5)
- Tirada de tabla de Alteración si la escena es modificada
Exploración persistente
- Rastreador de Mazmorra con grafo de salas, salidas y notas por sala
- Exploración Hexagonal con esquema de terreno y brújula de navegación
- Estado de exploración guardado entre sesiones de Obsidian
Interfaz completa
- Panel de control en sidebar derecho con 5 tabs (Escena / Oráculo / Generar / Explorar / Sesión)
- Vista de Exploración con tabs Mazmorra / Hexágonos
- Historial persistente con filtros, pins, interpretación editable, reinsertar y retirar
- Panel redimensionable mediante drag handle entre tabs e historial
- Exportación de sesión a Markdown o JSON
Configuración avanzada
- Color de acento personalizable (color picker en tiempo real)
- Modo compacto para el historial
- Formato de timestamp (hora / fecha completa / relativo)
- Formato de inserción (markdown plano / callout Obsidian / solo respuesta)
- Orden del historial (reciente / antiguo)
- Probabilidad por defecto para el oráculo Sí/No
- Umbral de evento en hexágono (configurable, default 5+)
- Exportación en Markdown o JSON
- Idioma: Inglés y Español
Instalación
Instalación manual
- Descarga
main.js,manifest.jsonystyles.cssdesde la última release. - Crea la carpeta
.obsidian/plugins/opse-oracle/en tu vault. - Copia los tres archivos en esa carpeta.
- Abre Obsidian → Configuración → Plugins de la comunidad → activa OPSE Oracle.
BRAT (recomendado para beta)
- Instala el plugin BRAT.
- En los ajustes de BRAT → Add Beta Plugin → introduce la URL de este repositorio.
- Activa OPSE Oracle en la lista de plugins de la comunidad.
Inicio rápido
1. Crear una aventura
Ejecuta OPSE: Start New Adventure desde la paleta de comandos (Ctrl+P). Rellena:
- Título — nombre de la campaña o sesión
- Sistema RPG — el juego que estás usando (D&D, Ironsworn, etc.)
- Género / Tono — fantasía épica, ciencia ficción, horror, etc.
- Protagonistas (opcional)
- Premisa inicial (opcional)
El plugin crea un fichero Markdown con frontmatter YAML, inicializa el estado de la aventura y abre la nota.
2. Abrir el panel de control
Haz clic en el icono 🎲 en la cinta izquierda, o ejecuta OPSE: Open control panel. El panel se abre en el sidebar derecho y permanece accesible durante toda la sesión.
3. Preparar la escena
En el tab Escena, pulsa Generar Escena. Introduce la ubicación y el objetivo de tus personajes. El plugin tira:
- 1d6 → Complicación de Escena
- 1d6 → Chequeo de Escena Alterada (si ≥ 5, tira tabla de Alteración)
4. Jugar la sesión
Usa los botones de los tabs del panel de control para:
- Preguntar al oráculo
- Tirar focos cuando necesites inspiración
- Generar PNJs, eventos o ganchos al vuelo
- Usar Movimientos del DJ para avanzar la narrativa
Los resultados se insertan automáticamente en la nota activa (si Auto-insert está activado) y se registran en el historial.
5. Explorar
Si necesitas rastrear una mazmorra o un mapa hexagonal, crea los rastreadores desde el tab Explorar. El estado persiste entre sesiones.
Panel de control
El panel es la interfaz principal de juego. Está organizado en 5 tabs más la tarjeta de aventura y el historial.
Tarjeta de aventura (siempre visible)
Muestra la aventura activa con:
- Rango de Escena con controles +/− (1–6, usado para el chequeo de alteración)
- Gestor de hilos — añade y elimina objetivos o subtramas activas
Tabs
| Tab | Contenido |
|---|---|
| Escena | Generar escena, Chequear alteración, Tirar alterada, Complicación, Movimiento de Ritmo, Movimiento de Fallo, Ayuda OPSE |
| Oráculo | Preguntar Sí/No, ¿Cuánto?, Foco Acción, Foco Detalle, Foco Tema, Foco Doble |
| Generar | PNJ, Gancho, Genérico, Giro de Trama, Ambiente/Clima, Evento Aleatorio |
| Explorar | Crear Mazmorra, Crear Región Hex, Explorar siguiente sala |
| Sesión | Nueva Aventura, Exportar log, Barajar baraja, Contador de cartas |
Resize handle
Hay una barra de separación entre los tabs y el historial que puedes arrastrar para ajustar el espacio que ocupa cada sección. La posición se guarda automáticamente.
Sistema de oráculos
Oráculo Sí/No
Implementa la mecánica de 2d6 de OPSE v1.6:
| Probabilidad | Umbral | Atajo |
|---|---|---|
| Probable | d1 ≥ 3 | 3+ |
| A Nivel | d1 ≥ 4 | 4+ |
| Improbable | d1 ≥ 5 | 5+ |
El segundo dado (d2) añade un modificador narrativo:
1→pero…(complicación)2–5→ sin modificador6→y…(beneficio adicional)
La probabilidad por defecto es configurable en ajustes.
Oráculo ¿Cuánto? (OracleComoDe)
Tirada 1d6 con la escala de OPSE v1.6:
| d6 | Resultado |
|---|---|
| 1 | Sorprendentemente escaso |
| 2 | Menos de lo esperado |
| 3–4 | Aproximadamente la media |
| 5 | Más de lo esperado |
| 6 | Extraordinario |
Focos de Oráculo
Los focos usan naipes (rango 2–A + palo) o dados (d12 + d4 en modo Dados). El palo define el dominio que contextualiza el resultado:
| Palo | Dominio |
|---|---|
| ♣ Tréboles | Físico (apariencia, existencia) |
| ♦ Diamantes | Técnico (mental, funcionamiento) |
| ♠ Picas | Místico (significado, capacidad) |
| ♥ Corazones | Social (personal, conexión) |
Foco de Acción — ¿Qué hace?
Foco de Detalle — ¿Qué clase de cosa es?
Foco de Tema — ¿De qué va esto?
Foco Doble — Combina Acción + Detalle en una sola tirada.
Modos de aleatorización
| Modo | Descripción |
|---|---|
| Dados | d12 para el rango, d4 para el palo. Sin baraja, siempre disponible. |
| Cartas | Baraja virtual de 54 cartas (52 + 2 Comodines) barajada. Los Comodines disparan un Evento Aleatorio automático y rebarajan la baraja (regla OPSE v1.6). |
| Baraja Persistente | Igual que Cartas, pero el estado de la baraja se guarda al cerrar Obsidian. Las cartas no vuelven al mazo hasta que se agote. |
Generadores
Gancho Argumental
Tira 3d6 independientes para generar:
Objetivo → d6 (Elimina amenaza / Aprende la verdad / Recupera valor / …)
Adversarios → d6 (Organización / Forajidos / Guardianes / Población local / …)
Recompensa → d6 (Dinero / Conocimiento / Ayuda aliado / Arco argumental / …)
Generador de PNJ
Combina 4 focos de naipe + 2 tiradas de dado:
Identidad → Foco naipe (tabla NPC_IDENTITY)
Objetivo → Foco naipe (tabla NPC_OBJECTIVE)
Rasgo → 1d6 tipo de rasgo + Foco Detalle (descripción)
Actitud → 1d6 escala ¿Cuánto?
Tema → Foco naipe (tabla THEMES)
Evento Aleatorio
Compone dos focos:
Lo que sucede → Foco de Acción + Dominio
Que lo involucra → Foco de Tema
Si se saca un Comodín en cualquier foco, se dispara un Evento Aleatorio adicional encadenado.
Generador Genérico
Útil para ciudades, naves, objetos mágicos, tabernas, monstruos:
Lo que hace → Foco de Acción + Dominio
Cómo se ve → Foco de Detalle + Dominio
Cómo de llamativo → ¿Cuánto? (1d6)
Exploración
Rastreador de Mazmorra
Implementa la mecánica de dungeon crawl de OPSE v1.6.
Creación: Nombre + apariencia visual + propósito. La primera sala tiene siempre 3 salidas.
Por cada sala nueva el plugin tira:
| Tabla | Rangos d6 |
|---|---|
| Localización | 1 = Área típica … 6 = Propósito especial |
| Encuentro | 1-2 = Nada, 3-4 = Enemigos, 5 = Obstáculo, 6 = Adversario único |
| Objeto | 1-2 = Nada, 3 = Pista, 4 = Herramienta, 5 = Valioso, 6 = Especial |
| Salidas | 1-2 = Callejón sin salida, 3-4 = 1 salida, 5-6 = 2 salidas |
Navegación: Botones de exploración (avanzar) y retroceso a salas conectadas. Notas por sala. Mapa de ruta acumulativo.
Exploración Hexagonal
Implementa el sistema de hexcrawl de OPSE v1.6 con coordenadas axiales.
Creación: Nombre de la región + 3 tipos de terreno (común / poco común / raro).
Generación de terreno (d6 por hex adyacente):
| d6 | Resultado |
|---|---|
| 1–2 | Igual que el hex actual |
| 3–4 | Terreno común |
| 5 | Terreno poco común |
| 6 | Terreno raro |
Contenidos (1d6): resultados 1–5 = nada notable, 6 = genera un Rasgo.
Rasgos (1d6): Estructura notable / Riesgo peligroso / Asentamiento / Rasgo natural extraño / Nueva región / Entrada a Mazmorra.
Eventos: Un evento se dispara cuando la tirada de evento alcanza el umbral configurado (por defecto d6 ≥ 5).
Navegación: Brújula de 6 direcciones (N / NE / SE / S / SW / NW). Los hexágonos ya visitados se recuperan sin tirar de nuevo.
Historial
El historial registra todas las tiradas de la sesión y persiste entre sesiones.
Funcionalidades
- Filtros por tipo: Todos / S/N / ¿Cuánto? / Foco / Evento / Escena / Movimiento / PNJ / Gancho
- Pin: Marca entradas importantes para que no se eliminen al limpiar
- Interpretación editable: Campo de texto por entrada para añadir contexto
- Copiar: Copia la entrada formateada al portapapeles
- Insertar: Inserta la entrada en la nota activa o la de aventura
- Retirar: Repite la misma tirada generando un nuevo resultado
- Modo compacto: Cards pequeñas para ver más entradas a la vez
- Orden configurable: Más reciente primero o más antiguo primero
- Timestamp configurable: Hora, fecha completa o relativo ("hace 5 min")
Exportación de sesión
Exporta el historial completo en:
- Markdown — formato legible con secciones por entrada
- JSON — estructura de datos completa con metadatos de aventura e historial
Configuración
La pantalla de ajustes está organizada en secciones:
General
| Ajuste | Valores | Descripción |
|---|---|---|
| Idioma | Español / English | Idioma de la interfaz y las tablas |
| Modo de aleatorización | Dados / Cartas / Baraja Persistente | Fuente de aleatoriedad para focos |
| Inserción automática | Sí/No | Insertar resultados en la nota activa automáticamente |
Interfaz
| Ajuste | Valores | Descripción |
|---|---|---|
| Tab por defecto | Escena / Oráculo / Generar / Explorar / Sesión | Tab que abre el panel al arrancar |
| Color de acento | Color picker | Color principal de la UI (por defecto violeta #8b5cf6) |
| Modo compacto | Sí/No | Cards pequeñas en el historial |
| Orden del historial | Reciente primero / Antiguo primero | Orden de las entradas |
| Formato de timestamp | Hora / Fecha completa / Relativo | Cómo se muestra la hora en cada entrada |
📋 Inserción de resultados
| Ajuste | Valores | Descripción |
|---|---|---|
| Formato de inserción | Markdown plano / Callout Obsidian / Solo respuesta | Cómo se formatea el texto insertado |
| Mostrar raw rolls | Sí/No | Incluir el resultado de dados (1d6=4) en el texto |
| Mostrar dominio/palo | Sí/No | Incluir el dominio del palo en resultados de foco |
Ejemplo de cada formato:
── Markdown plano ──────────────────────────────
? ¿El guardia está dormido?
Sí, pero... <small>(2d6=5: d1=4, d2=1, Prob: even)</small>
*Social (personal, conexión)*
>
── Callout Obsidian ────────────────────────────
> [!oracle] ¿El guardia está dormido?
> **Sí, pero...** <small>(2d6=5)</small>
> *Social (personal, conexión)*
── Solo respuesta ──────────────────────────────
**Sí, pero...**
🔮 Oráculos
| Ajuste | Valores | Descripción |
|---|---|---|
| Probabilidad por defecto | Probable / A Nivel / Improbable | Nivel preseleccionado en el modal Sí/No |
| Umbral de evento en hex | 2–6 (slider) | Valor mínimo en d6 para disparar un evento |
💾 Sesión y datos
| Ajuste | Valores | Descripción |
|---|---|---|
| Formato de exportación | Markdown / JSON | Formato del archivo exportado |
| Auto-abrir exploración | Sí/No | Abrir la vista de exploración al crear mazmorra/hex |
| Resetear baraja al cambiar aventura | Sí/No | Reiniciar la baraja al activar una aventura diferente |
| Límite de historial | 10–500 (slider) | Número máximo de entradas a conservar |
| Limpiar historial | Botón | Elimina todas las entradas no fijadas |
| Restaurar valores por defecto | Botón | Restaura ajustes de UI/comportamiento (no afecta aventuras ni historial) |
Referencia de comandos
Todos los comandos tienen el prefijo OPSE: y son accesibles desde la paleta de comandos (Ctrl+P).
Vistas
| ID | Descripción |
|---|---|
opse-open-control |
Abrir panel de control |
opse-open-history |
Abrir historial (abre el panel de control) |
opse-open-exploration |
Abrir vista de exploración |
Aventura y escena
| ID | Descripción |
|---|---|
opse-start-adventure |
Nueva aventura (modal) |
opse-set-scene |
Preparar nueva escena (modal) |
Oráculos
| ID | Descripción |
|---|---|
opse-ask-oracle |
Oráculo Sí/No (modal con pregunta) |
opse-ask-how-much |
Oráculo ¿Cuánto? (1d6) |
opse-focus-action |
Foco de Acción |
opse-focus-detail |
Foco de Detalle |
opse-focus-theme |
Foco de Tema |
opse-focus-double |
Foco Doble (Acción + Detalle) |
opse-roll-beat-move |
Movimiento de Ritmo (1d6) |
opse-roll-failure-move |
Movimiento de Fallo (1d6) |
Generadores
| ID | Descripción |
|---|---|
opse-random-event |
Evento Aleatorio |
opse-generate-hook |
Gancho Argumental |
opse-generate-npc |
Generar PNJ |
opse-generate-generic |
Contenido Genérico |
opse-plot-twist |
Giro de Trama |
opse-flavor |
Ambiente / Clima |
Exploración
| ID | Descripción |
|---|---|
opse-create-dungeon |
Crear rastreador de mazmorra |
opse-create-hex-region |
Crear región hexagonal |
opse-explore-room |
Explorar siguiente sala |
opse-hex-north |
Mover al Norte |
opse-hex-northeast |
Mover al Noreste |
opse-hex-southeast |
Mover al Sureste |
opse-hex-south |
Mover al Sur |
opse-hex-southwest |
Mover al Suroeste |
opse-hex-northwest |
Mover al Noroeste |
Referencia de tablas OPSE v1.6
Enfoque de Acción (naipes 2–A)
| Rango | ES | EN |
|---|---|---|
| 2 | Buscar | Seek |
| 3 | Oponerse | Oppose |
| 4 | Comunicar | Communicate |
| 5 | Mover | Move |
| 6 | Dañar | Harm |
| 7 | Crear | Create |
| 8 | Revelar | Reveal |
| 9 | Mandar | Command |
| 10 | Tomar | Take |
| J | Proteger | Protect |
| Q | Ayudar | Help |
| K | Transformar | Transform |
| A | Engañar | Deceive |
Enfoque de Detalle (naipes 2–A)
| Rango | ES | EN |
|---|---|---|
| 2 | Pequeño | Small |
| 3 | Grande | Large |
| 4 | Viejo | Old |
| 5 | Nuevo | New |
| 6 | Mundano | Mundane |
| 7 | Simple | Simple |
| 8 | Complejo | Complex |
| 9 | Insulso | Bland |
| 10 | Especial | Special |
| J | Inesperado | Unexpected |
| Q | Exótico | Exotic |
| K | Digno | Worthy |
| A | Único | Unique |
Enfoque de Tema (naipes 2–A)
| Rango | ES | EN |
|---|---|---|
| 2 | Necesidad Ya | Immediate Need |
| 3 | Aliados | Allies |
| 4 | Comunidad | Community |
| 5 | Historia | History |
| 6 | Planes Futuros | Future Plans |
| 7 | Enemigos | Enemies |
| 8 | Conocimiento | Knowledge |
| 9 | Rumores | Rumors |
| 10 | Arco Argumental | Plot Arc |
| J | Eventos Recientes | Recent Events |
| Q | Equipo | Equipment |
| K | Facción | Faction |
| A | Los PJs | The PCs |
Atribución y licencia
Esta es la versión en español de la documentación. Para la documentación en inglés, consulta
README-en.md.
One Page Solo Engine
Este plugin implementa las mecánicas de One Page Solo Engine v1.6, creado por Karl Hendricks (Inflatable Studios), con traducción al castellano de Micky Pardo.
- Página oficial: inflatablestudios.itch.io
- Licencia original: CC-BY-SA 4.0
Este plugin es una implementación independiente. No está afiliado ni respaldado por el autor original.
Plugin
Autor: Snifer · Bastion del Dinosaurio
Licencia: MIT — libre para usar, modificar y distribuir.
Desarrollado con ❤️ para la comunidad de rol en solitario.