Guida
Organizzare il primo progetto
Formati supportati, struttura cartelle e primi passi
GENKAI lavora con una semplice cartella sul tuo computer. Dentro ci metti i documenti della tua avventura — il programma li legge, li indicizza per la ricerca, e ti permette di navigarli, organizzarli e condividerli con i giocatori.
Formati supportati
| Tipo | Estensioni | Come si visualizzano |
|---|---|---|
| Documenti | .md .html .htm .txt | Markdown formattato, HTML renderizzato, testo semplice |
| Immagini | .png .jpg .jpeg .gif .webp | Visualizzate nel Viewer e nel pannello Media |
| Audio | .mp3 .ogg .wav .flac .m4a | Riproducibili nel pannello Media con player completo |
| Video | .mp4 .webm .mov | Player video nel pannello Media |
| Link web | .url | Aprono pagine web nel Viewer |
.md) è il formato ideale per i documenti di gioco. Supporta titoli, grassetto, corsivo, elenchi, tabelle e immagini — e la dashboard lo rende con una formattazione leggibile.
Struttura consigliata
Non c'è una struttura obbligatoria — GENKAI legge qualsiasi cartella. Ma ecco un esempio che funziona bene:
La Città Perduta/
├── ambientazione/
│ ├── storia.md
│ ├── luoghi.md
│ └── fazioni.md
├── png/
│ ├── elara-la-saggia.md
│ ├── garrick-il-mercante.md
│ └── ombra.md
├── giocatori/
│ ├── thorin-scheda.md
│ ├── lyra-scheda.md
│ └── krom-scheda.md
├── handout/
│ ├── mappa-città.png
│ ├── lettera-misteriosa.md
│ └── stemma-gilda.jpg
├── musica/
│ ├── taverna.mp3
│ ├── combattimento.mp3
│ └── esplorazione.mp3
├── sessioni/
│ ├── sessione-01.md
│ └── sessione-02.md
├── relazioni.txt
└── eventi.mdAprire il progetto
- Avvia GENKAI GM Dashboard
- Nella schermata iniziale, clicca "Apri cartella" e seleziona la cartella del progetto
- L'Explorer a sinistra mostra tutti i file e le sottocartelle
- Clicca su un documento per aprirlo nel Viewer
- Clicca su un file audio o un'immagine per aggiungerlo al pannello Media
Il progetto viene aggiunto automaticamente ai Progetti recenti: la prossima volta lo trovi nella schermata iniziale senza dover cercare la cartella.
File nascosti
Alcuni file vengono nascosti dall'Explorer per mantenere la vista pulita. Per impostazione predefinita sono nascosti:
.json .yml .yaml .git .gitignore .DS_Store .thumbs.db .ini .cfg .log .bak .tmp .swp .lock
Puoi modificare questa lista nelle Impostazioni → Progetto → Estensioni nascoste.
Altre modalità di avvio
- Importa da .zip — se qualcuno ti ha condiviso un'avventura come archivio, puoi importarla direttamente
- Catalogo online — scarica avventure create da altri GM direttamente dall'app
- Progetti recenti — gli ultimi progetti aperti appaiono nella schermata iniziale