MCPcopy Index your code
hub / github.com/carlonicora/obsidian-rpg-manager

github.com/carlonicora/obsidian-rpg-manager @4.2.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release 4.2.1 ↗ · + Follow
855 symbols 2,180 edges 215 files 2 documented · 0% updated 6mo ago4.2.1 · 2025-12-16★ 24131 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Gestore di Giochi di Ruolo

en

Il Gestore di Giochi di Ruolo (RPG Manager) è un plugin per Obsidian progettato per semplificare la creazione e l'esecuzione di campagne di giochi di ruolo. Il plugin è agnostico rispetto al sistema, il che significa che puoi usarlo se stai gestendo una campagna di D&D, Call of Cthulhu o qualsiasi altro gioco di ruolo da tavolo.

Indice

1. Introduzione

Benvenuto in RPG Manager, il plugin Obsidian progettato per essere il compagno definitivo per Narratori e Game Master (GM) nella preparazione e nell'esecuzione delle loro campagne. Se sei stanco di avere le note della tua campagna sparse su piattaforme e quaderni multipli, RPG Manager è nato dalla necessità di avere un repository centrale per tutte quelle brillanti idee, note, trame e decisioni dei personaggi giocanti che compongono il tessuto del tuo gioco.

Perché RPG Manager? La bellezza di RPG Manager risiede nella sua semplicità e flessibilità. Ti consente di creare facilmente relazioni tra vari elementi della tua campagna, formando una rete di inform

azioni che aiuta sia nella pianificazione che nell'esecuzione del gioco. Inoltre, è uno strumento agnostico rispetto al sistema, il che significa che può essere utilizzato con qualsiasi sistema di Gioco di Ruolo da Tavolo (TTRPG), fornendo una piattaforma versatile per gestire campagne senza essere vincolati a un set di regole specifico. Tuttavia, ciò significa che potrebbe non coprire ogni singolo dettaglio di ogni sistema là fuori, quindi affronta RPG Manager con una mente aperta e uno spirito d'avventura!

I vantaggi di RPG Manager includono informazioni centralizzate, relazioni tra gli elementi, design agnostico rispetto al sistema ed efficienza generale nella preparazione delle campagne. Fornendo una posizione centrale per tutte le tue idee, note e informazioni, e consentendoti di creare una rete di relazioni tra vari elementi della campagna, RPG Manager ti aiuta a creare narrazioni avvincenti tenendo traccia di tutti i dettagli essenziali.

Quindi, intraprendi il tuo viaggio narrativo con RPG Manager come tuo compagno di fiducia. Abbraccia le possibilità che offre e lascia che ti aiuti a creare avventure indimenticabili.

1.1. Panoramica del Plugin

RPG Manager è un plugin per Obsidian, progettato per posizionarsi comodamente sopra di esso, come un cappello da stregone ben indossato. Associa i metadati alle note di Obsidian e fornisce un'interfaccia utente amichevole per navigare attraverso le informazioni. Non si tratta solo di metadati qualunque; è il tipo di metadati che aiuta a gestire le relazioni tra le note, un aspetto cruciale per qualsiasi Narratore/GM che cerca di tessere una narrazione coerente.

L'interfaccia utente di RPG Manager è un'interfaccia utente HTML che organizza i metadati e li visualizza all'interno della nota di Obsidian. Ciò significa che non devi passare avanti e indietro tra diverse applicazioni o finestre; tutto ciò di cui hai bisogno è lì nella tua nota di Obsidian.

I metadati sono memorizzati all'interno di un blocco di codice in Obsidian, anziché nel front matter. Questa decisione è stata presa perché il front matter non gestisce la quantità di informazioni necessarie in modo pulito e toglie molto spazio nella parte superiore della nota in Obsidian. Tuttavia, non devi preoccuparti dei dettagli tecnici di formattazione o sintassi, poiché tutti i metadati vengono letti e scritti tramite l'interfaccia utente. Ciò significa meno tempo a lottare con il codice e più tempo a creare le tue epiche storie.

1.2. Caratteristiche Principali

RPG Manager vanta una serie di funzionalità progettate per rendere il tuo viaggio narrativo liscio come l'incantesimo di un bardo. Ecco una rapida panoramica di cosa aspettarti:

  1. Informazioni Centralizzate: Raccogli tutte le tue idee, note e informazioni sulla campagna in un unico luogo, assicurandoti che nulla si perda nel caos della creazione.
  2. Interfaccia Utente Amichevole: Un'interfaccia utente HTML incorporata nelle tue note di Obsidian per aiutarti a navigare e gestire i metadati senza dover jonglare tra diverse applicazioni o finestre.
  3. Gestione dei Metadati: Memorizza e gestisci le relazioni tra le note con i metadati, cruciali per tessere una narrazione coerente. I metadati sono memorizzati all'interno di un blocco di codice in Obsidian, riducendo al minimo il disordine e massimizzando l'efficienza.
  4. Relazioni tra Note/Elementi: Gestisci facilmente le relazioni tra vari elementi della campagna, creando una rete di informazioni che aiuta sia nella pianificazione che nell'esecuzione del gioco.
  5. Design Agnostico Rispetto al Sistema: Progettato per funzionare con qualsiasi sistema TTRPG, fornendo una piattaforma versatile per gestire campagne senza essere vincolati a un set di regole specifico.
  6. Elementi: Tutto in RPG Manager è un "Elemento", che sia una campagna, un'avventura, un capitolo, un evento, un luogo, un indizio, un personaggio non giocante, una fazione, un oggetto, un mostro, una sottotrama, un personaggio giocante, una sessione o una scena. Ciò aiuta a organizzare e strutturare la tua campagna in modo più coerente e logico.

Ricorda, questo è solo un assaggio di ciò che RPG Manager ha da offrire. Man mano che approfondirai questa documentazione, scoprirai come ogni funzione può essere adattata al tuo stile narrativo unico.

1.3. Pubblico di Riferimento (Plotters, Sandboxers, GM Pigri)

RPG Manager è progettato per essere uno strumento versatile che può adattarsi a diversi stili narrativi. Che tu sia un Plotter, un Sandboxed o un GM Pigro, questo plugin ha qualcosa per te.

  1. Plotters: Per coloro che amano pianificare meticulosamente le loro storie, RPG Manager offre un approccio strutturato per organizzare e gestire ogni elemento della tua campagna, dalla narrazione generale fino a singole scene e indizi.
  2. Sandboxers: Se preferisci creare mondi aperti e lasciare che i tuoi giocatori si muovano liberamente, RPG Manager aiuta nell'organizzazione di eventi, luoghi e indizi, facilitando la creazione di uno sfondo coerente con cui i tuoi personaggi giocanti possono interagire.
  3. GM Pigri: Anche se non ti prepari molto e preferisci annotare alcune note e appunti prima di ogni sessione, RPG Manager può aiutare a centralizzare le tue idee e note, garantendo che tu possa trovare rapidamente ciò di cui hai bisogno durante il gioco.

Suggerimenti per tutti i Game Master

  • I diversi Game Master utilizzeranno il plugin in modi diversi, utilizzando gli attributi di ciascun tipo di elemento o semplicemente ignorandoli. Prenditi del tempo per capire come funzionano ciascun elemento e funzionalità e decidi se si adatta al tuo stile.
  • Nonostante RPG Manager offra un approccio strutturato, è progettato per essere flessibile ed adattabile. Non esitare a usarlo nel modo che funziona meglio per te, anche se significa non utilizzare determinate funzionalità.
  • Ricorda, l'obiettivo di RPG Manager è rendere la vita del Narratore/GM più facile e organizzata, non imporre una struttura rigida al tuo processo creativo.

1.4. Iniziare

Intraprendere una nuova avventura con RPG Manager è eccitante quanto tirare un dado naturale 20! Per cominciare, tutto ciò di cui hai bisogno è una mente aperta e la volontà di esplorare le funzionalità del plugin per vedere come si allineano con il tuo stile narrativo.

  • Passo 1: Creare una Campagna: La Campagna è il contenitore principale per tutti gli altri elementi in RPG Manager. Ogni Vault di Obsidian può contenere diverse campagne, ma ciascun elemento (avventure, capitoli, eventi, ecc.) è disponibile per una sola campagna. Quindi, inizia creando una nuova campagna.
  • Approccio con Mente Aperta: Mentre inizi a esplorare il plugin, mantieni una mente aperta. Prova diverse funzionalità, osserva come gli elementi interagiscono tra loro e valuta se RPG Manager si adatta al tuo stile di Game Master. È essenziale comprendere che, pur offrendo un approccio strutturato e organizzato, RPG Manager è abbastanza flessibile da adattarsi a stili diversi.

Errori Comuni

  • Mentalità "Taglia Unica": RPG Manager è progettato per essere flessibile ed adattabile. Non assumere di dover utilizzare ogni funzionalità o elemento. Usa ciò che funziona per te e per la tua campagna.
  • Sopraffatti dalle Scelte: Ci sono molti elementi e funzionalità disponibili in RPG Manager. Non sentirti obbligato a capire o utilizzare tutto immediatamente. Prenditi il ​​tuo tempo, esplora a tuo ritmo e incorpora gradualmente le funzionalità che soddisfano le tue esigenze.

Risorse

Al momento non ci sono tutorial o guide disponibili, ma stiamo lavorando alla creazione di video tutorial per aiutarti a sfruttare al massimo RPG Manager. Stai sintonizzato!

1.5. Aggiornare il tuo vault dalla versione v3

Se stai già utilizzando RPG Manager e lo aggiorni alla versione 4, il plugin non funzionerà. Hai due opzioni: utilizzare BRAT per tornare alla versione 3.4.5 o aggiornare il tuo vault.

L'aggiornamento del tuo vault è sempre una questione complicata, poiché il modo in cui hai strutturato i tuoi dati potrebbe essere diverso da quello di altri narratori. Per questo motivo, prima di aggiornare il tuo vault, crea una copia di backup!

Importante: se il processo di aggiornamento si blocca, controlla la Console degli ispettori per gli errori e cerca aiuto su Discord o su Github.

2. Installazione

Installare RPG Manager è semplice come sconfiggere un goblin di livello 1! Segui i passaggi di seguito per iniziare:

  • Già Installato: Se stai leggendo questa documentazione da dentro Obsidian, congratulazioni! Hai già installato il plugin RPG Manager e sei pronto per intraprendere il tuo viaggio narrativo.
  • Passaggi di Installazione: Se non hai ancora installato il plugin, segui questi semplici passaggi:
  • Apri le impostazioni di Obsidian.
  • Vai a "Community Plugins".
  • Disattiva "Modalità Restretta" se necessario.
  • Cerca il plugin "RPG Manager".
  • Una volta trovato, clicca su "Installa" e poi su "Attiva".

E voilà! Ora sei pronto per immergerti nel mondo di RPG Manager. Non è richiesta alcuna configurazione iniziale, quindi puoi iniziare a creare campagne immediatamente!

2.1. Configurazione della tua prima Campagna

Creare la tua prima campagna con RPG Manager è un gioco da ragazzi! Ecco due modi per farlo:

  • Command Palette:
  • Apri la command palette premendo Ctrl + P (Windows) o Cmd + P (Mac).
  • Cerca RPG Manager: crea nuova Campagna.
  • Sel

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Function 414
Method 317
Class 80
Interface 28
Enum 16

Languages

TypeScript100%

Modules by API surface

src/services/RpgManagerCodeblockService.ts30 symbols
src/services/ChatGptService/models/ChatGptNonPlayerCharacterModel.ts29 symbols
src/components/editors/MarkdownEditorComponent.tsx25 symbols
src/data/classes/Element.ts23 symbols
src/components/conflict/ConflictComponent.tsx23 symbols
src/data/interfaces/ElementInterface.ts21 symbols
src/services/taskService/Task.ts15 symbols
src/services/sceneAnalyserService/SceneAnalysis.ts15 symbols
src/main.ts14 symbols
src/components/attributes/types/SensoryImprintAttributeComponent.tsx14 symbols
src/components/attributes/types/MajorCluesAttributeComponent.tsx14 symbols
src/services/taskService/interfaces/TaskInterface.ts13 symbols

For agents

$ claude mcp add obsidian-rpg-manager \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page