MineDnD Studio

Un'app desktop per creare e modificare i datapack di MineDnD: oggetti, incantesimi, regole sui requisiti, imprese, titoli, impostazioni del mondo e traduzioni. Funziona sui mondi del tuo computer e sui server online (Modrinth Servers, host con Pterodactyl, qualsiasi server SFTP o FTP), spiega ogni valore e il suo effetto sui giocatori, e fa un backup di ogni file prima di cambiarlo. Windows, macOS e Linux; in italiano e in inglese (si cambia con il pulsante della lingua, in alto a destra).

• Installare
• Aprire un mondo o un server
• Cosa puoi fare
• Applicare le modifiche nel gioco
• Sicurezza: backup e conflitti
• Risolvere i problemi

Installare

Scarica il file per il tuo sistema dalla pagina Releases del repository. Vengono aggiunti a un rilascio a parte, quindi se l'ultimo non li ha ancora, prendili da un rilascio precedente:

Sistema	File	Note
Windows	MineDnD-Studio-<version>-windows-setup.exe	Installer (collegamento nel menu Start, disinstallazione)
Windows	MineDnD-Studio-<version>-windows-portable.exe	Senza installazione: avvialo da dove vuoi (es. una chiavetta USB)
macOS	MineDnD-Studio-<version>-macos.dmg	Universale: Apple Silicon e Intel. Trascinalo in Applicazioni
Linux	MineDnD-Studio-<version>-linux-x86_64.AppImage	Qualsiasi distribuzione: dagli chmod +x, poi avvialo
Linux	MineDnD-Studio-<version>-linux-amd64.deb	Debian, Ubuntu, Mint: sudo apt install ./MineDnD-Studio-…deb

Le build non sono firmate con un certificato a pagamento, quindi al primo avvio compare un avviso:

• Windows: "Windows ha protetto il PC" → Ulteriori informazioni → Esegui comunque.
• macOS: "impossibile aprire perché lo sviluppatore non può essere verificato" → clic destro sull'app → Apri → Apri (oppure Impostazioni di Sistema → Privacy e sicurezza → Apri comunque). Solo la prima volta.
• Linux: su alcune distribuzioni le AppImage richiedono FUSE 2 (Ubuntu 22.04+: sudo apt install libfuse2).

Aprire un mondo o un server

La pagina iniziale offre tre modi per entrare. I luoghi che apri restano in Recenti.

Un mondo su questo computer

Studio elenca i mondi del launcher di Minecraft, della Modrinth App, di Prism Launcher, CurseForge, ATLauncher e GDLauncher (anche installati con Flatpak), con la loro icona, l'ultima volta che ci hai giocato, quanti datapack hanno e se in quell'istanza MineDnD è installato. Cliccane uno per aprire la sua cartella datapacks.

Non è nell'elenco? Scegli una cartella… e scegli la cartella del mondo (quella con level.dat), la sua cartella datapacks, un singolo datapack o la cartella di un server (con server.properties). Nella Modrinth App: istanza → ⋯ → Apri cartella → saves.

Un server online

Connettiti a un server ti guida passo per passo:

1. Host: Modrinth Servers, un pannello Pterodactyl/Pelican (Apex, Bisect, Shockbyte, BerryByte, Sparked, PebbleHost…), un altro server SFTP (una VPS), o FTP/FTPS.
2. Accesso: host, porta, nome utente, password (o una chiave SSH). La pagina dice dove li mostra il tuo host:
3. Modrinth Servers: il tuo server su modrinth.com → Options → Info: host SFTP, porta, nome utente e password.
4. Host con Pterodactyl: le Settings del pannello (o "SFTP Details"): un indirizzo come sftp://node.example.com:2022 (l'host prima dei due punti, porta 2022), un nome utente come nome.1a2b3c4d, la password del pannello.
5. Prova la connessione mostra i file che vede. Ricorda la password la salva cifrata con il portachiavi del sistema (Gestione credenziali/DPAPI di Windows, Portachiavi di macOS, il Secret Service su Linux).
6. Cartella: vai alla cartella del server se non è quella in cui arrivi.
7. Ricarica (facoltativo): RCON permette a Studio di eseguire /reload per te. Servono enable-rcon=true, rcon.port e rcon.password in server.properties, e la porta raggiungibile dal tuo computer (molti host non la aprono).
8. Dai un nome alla connessione e aprila.

Studio legge server.properties per trovare il mondo (level-name) e apre la sua cartella datapacks. Se la cartella contiene più mondi, ti chiede quale.

Puoi modificare mentre il server è acceso. Non viene scritto nulla finché non salvi.

Cosa puoi fare

Pagina	Cosa fa
Panoramica	Conteggi, azioni rapide, i tuoi datapack, i pacchetti compressi (estraili per modificarli), problemi
Oggetti	Oggetti MineDnD: oggetto base, nome e descrizione in ogni lingua, rarità, luccichio, bonus alle caratteristiche e slot, requisiti, abilità (palla di fuoco o lancio che ritorna, clic destro o tasto V), incantesimi, modificatori degli attributi, effetti di pozione, una ricetta 3×3 (e gli oggetti che la sbloccano nel ricettario) o una ricetta di distillazione (ampolla + ingrediente, per le pozioni), qualsiasi altro componente in JSON
Incantesimi	Nome, livello massimo, rarità (peso), livelli del tavolo per incantesimi, costo dell'incudine, oggetti e slot (preimpostati, e cosa contiene un tag), dove lo trovano i giocatori (tavolo, tesoro, bottino, scambi con i bibliotecari), effetti da 16 modelli o in JSON
Requisiti	Punteggi necessari per creare o distillare, piazzare o usare ricette, oggetti, tag o pozioni (qualsiasi ampolla, o solo da lancio/persistenti), per azione
Imprese	Progressi mostrati come albero: genitore, icona, cornice, testi, nascosto, criteri con un modulo per ogni trigger di MineDnD (N volte, N cose diverse, statistiche, cucina, livello, punteggio di caratteristica) o condizioni di Minecraft in JSON, e la notifica nel gioco
Titoli	Nome e colore, l'impresa che lo sblocca, effetti (come un incantesimo, più danni, caratteristica, esperienza, velocità di scavo, fame, salute, durata delle pozioni) e l'anteprima sopra il nome
Traduzioni	Ogni chiave × ogni lingua, celle mancanti evidenziate, "copia l'inglese nelle celle vuote", nuove chiavi e lingue
Impostazioni del mondo	Ogni regola di settings.json con la sua spiegazione, da dove viene il valore attuale, una tabella punteggio → effetto, la curva dei livelli (lineare, esponenziale, logaritmica, a potenza, una formula o una tabella) con il grafico, preset (Punteggi discreti, Eroico, Spietato…)
Problemi	File rotti, traduzioni mancanti, oggetti/incantesimi/effetti/ricette/pozioni sconosciuti, progressi senza genitore, titoli che nessuno può sbloccare, ricette in conflitto (quelle di distillazione anche con Minecraft), requisiti che i punti non possono raggiungere, abilità che rubano il clic destro di un arco o di uno scudo
Contenuto integrato	Il datapack Default Content (la copia dentro Studio), in sola lettura: apri qualsiasi cosa per vedere com'è fatta, Copia in un pacchetto per cambiarla (vince la tua copia)
Backup	Ogni file cambiato da Studio, com'era prima, per sessione; ripristina quelli che vuoi
Guida	Datapack, punteggi e modificatori, oggetti, incantesimi, regole, pozioni e distillazione, server, applicare le modifiche, un glossario

Procedure guidate (i pulsanti Nuovo (guidato)): costruiscono passo per passo un datapack, un oggetto, un incantesimo o una regola completi. Per un oggetto scegli il tipo (arma da mischia, arco, focus magico, armatura, anello, tomo, strumento, pozione…), un oggetto base tra i suggerimenti, i nomi in italiano e in inglese, bonus e requisiti, un preset di abilità (trucchetto, incantesimo da battaglia, armi da lancio…) e una ricetta (banco da fabbricazione, o alambicco per le pozioni), con il tooltip del gioco che si aggiorna mentre procedi.

Spiegazioni ovunque: ogni campo ha un ? con cosa fa nel gioco; i numeri con un valore predefinito lo mostrano e si possono riportare a quello; il pannello a destra mostra il tooltip dell'oggetto come lo vedono i giocatori (in italiano o in inglese) e cosa significa per un personaggio con i punteggi che scegli: l'effetto del bonus (es. "Danni in mischia ×1,10 → ×1,20"), il livello a cui un nuovo personaggio soddisfa i requisiti, i danni dell'abilità per colpo e al secondo, gli usi per barra della fame.

Tastiera: Ctrl+S salva, Ctrl+K cerca tra tutti gli oggetti, incantesimi, regole e pagine.

Applicare le modifiche nel gioco

Hai cambiato	Si applica con
Oggetti, ricette, regole sui requisiti, traduzioni, impostazioni del mondo	/reload (in chat da operatore, o nella console del server)
Incantesimi	Un riavvio: riavvia il server, oppure in giocatore singolo Salva ed esci e riapri il mondo
Una nuova cartella di datapack	Si attiva quando il mondo si carica, o con /reload; controlla con /datapack list

Con RCON configurato, il pulsante Esegui /reload nella barra in alto lo fa per te. Altrimenti Applica nel gioco ricorda questi passi.

Sicurezza: backup e conflitti

• Backup: la prima volta che in una sessione un file viene cambiato o eliminato, Studio copia la sua vecchia versione nella cartella dati dell'app (backups/). La pagina Backup li elenca, mostra ogni file e ripristina quelli che selezioni (i file creati nella sessione vengono eliminati). Prima viene fatto il backup delle versioni attuali, quindi anche un ripristino si può annullare.
• Conflitti: quando salvi, Studio controlla che il file sia ancora quello che aveva aperto. Se qualcuno (un compagno, il server, un altro programma) l'ha cambiato nel frattempo, ti chiede se sovrascriverlo o caricare la sua versione.
• Modifiche non salvate: lasciare una pagina con modifiche non salvate chiede se salvare, scartare o restare.
• Dati intatti: i campi che i moduli non mostrano (componenti sconosciuti, chiavi in più) vengono riscritti esattamente come erano. I file non modificati non vengono riscritti.
• Studio scrive solo dentro la cartella che hai aperto, e dai server legge solo i file che riguardano MineDnD.

Risolvere i problemi

Problema	Prova
"Connessione non riuscita" (SFTP)	Controlla host e porta (Pterodactyl: 2022, non 22 né la porta del gioco). Il nome utente spesso contiene un punto e un id. Alcuni host richiedono che il server sia acceso per l'SFTP.
"Connessione non riuscita" (FTP)	Attiva o disattiva FTPS come richiede il tuo host. Si usa la modalità passiva; i firewall devono permetterla.
La password non viene ricordata (Linux)	Il tuo desktop non ha un portachiavi (Secret Service) attivo: installa/sblocca GNOME Keyring o KWallet, o scrivila ogni volta.
/reload via RCON non funziona	enable-rcon=true in server.properties e un riavvio; la porta RCON deve essere aperta al tuo IP (molti host non lo permettono); usa la console.
Un mondo manca dall'elenco	Usa Scegli una cartella…. Le cartelle dei launcher personalizzate non vengono cercate.
Un datapack compresso non si può modificare	Panoramica → Estrai in una cartella (lo zip viene poi rimosso, con un backup, così il gioco non li carica entrambi).
Un file risulta "rotto"	Non è un JSON valido: Studio lo apre come testo con l'errore del parser; correggilo e salva.

Sviluppare Studio: tools/minednd-studio/README.md (in inglese).