MineDnD Validator

Una piccola app desktop per controllare un file di un datapack prima di caricarlo in gioco. Scrivi o apri un file JSON a sinistra: sotto compaiono i problemi che il gioco troverebbe, e a destra l'anteprima del file come lo vedranno i giocatori (il tooltip di un oggetto, la griglia di una ricetta, la notifica di un obiettivo…). Windows, macOS e Linux; italiano e inglese (si cambia con il pulsante EN/IT, in alto a destra).

• Installare
• Usarla
• Cosa controlla
• Cosa mostra in anteprima
• Problemi comuni

Installare

Scarica il file per il tuo sistema dalla pagina Releases del repository. Vengono aggiunti a una release a parte, quindi se la più recente non li ha ancora, prendili da una release precedente:

Sistema	File	Note
Windows	MineDnD-Validator-<versione>-windows-setup.exe	Installer (collegamento nel menu Start, disinstallazione)
Windows	MineDnD-Validator-<versione>-windows-portable.exe	Senza installazione: avviala da dove vuoi (es. una chiavetta USB)
macOS	MineDnD-Validator-<versione>-macos.dmg	Universale: Apple Silicon e Intel. Trascinala in Applicazioni, o in qualsiasi cartella o chiavetta USB e avviala da lì
Linux	MineDnD-Validator-<versione>-linux-x86_64.AppImage	Qualsiasi distribuzione, senza installazione: chmod +x, poi avviala da dove vuoi
Linux	MineDnD-Validator-<versione>-linux-amd64.deb	Debian, Ubuntu, Mint: sudo apt install ./MineDnD-Validator-…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: "non può essere aperta perché lo sviluppatore non può essere verificato" (o "è danneggiata") → 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).

Usarla

• Apri… (Ctrl/Cmd+O) un file, o trascinalo sulla finestra. Salva (Ctrl/Cmd+S) e Salva come… lo riscrivono. Nuovo inizia un file vuoto; Esempio… carica un file del datapack Default Content da cui partire.
• Tipo di file è Rileva di default: il tipo dipende da dove si trova il file nel suo datapack (data/<namespace>/items/… è un oggetto, data/<namespace>/recipe/… una ricetta, data/<namespace>/settings.json le impostazioni del mondo e così via, vedi Datapack) oppure, per un file che non è ancora in un datapack, dal contenuto. Se sbaglia, scegli il tipo a mano.
• La lista dei problemi si aggiorna mentre scrivi. Clicca un problema per andarci; gli stessi problemi sono sottolineati nell'editor.
• Quando apri un file da un datapack, l'app legge anche le traduzioni di quel datapack (data/*/lang/en_us.json e it_it.json), così nell'anteprima le chiavi translate diventano il loro testo.
• Per oggetti e regole dei requisiti, Personaggio imposta i punteggi di caratteristica del giocatore dell'anteprima (Tutti li imposta tutti insieme): i requisiti diventano verdi o rossi, e un oggetto mostra se i suoi bonus sarebbero attivi.

Cosa controlla

Le stesse regole che la mod applica quando carica un datapack, quindi un file senza errori qui si carica in gioco:

Gravità	Significa
Errore	Il gioco rifiuta il file (o la voce): JSON sbagliato, un campo obbligatorio mancante, un valore fuori intervallo, una caratteristica, uno slot, un componente o un trigger sconosciuto
Avviso	Si carica, ma probabilmente non come volevi: un campo sconosciuto (con un suggerimento "forse intendevi…?"), un campo che il tipo di abilità ignora, una chiave della ricetta che lo schema non usa mai, una regola che non trova nulla
Info	Utile da sapere, niente da correggere

Tipi di file: oggetti, ricette (con forma, senza forma, alambicco), incantesimi, regole dei requisiti, obiettivi (advancement), titoli, tag, impostazioni del mondo (settings.json, formula dell'XP compresa), traduzioni e pack.mcmeta.

Controlla un file alla volta: non può sapere se l'oggetto prodotto da una ricetta, o il genitore di un obiettivo, esiste in un altro file. Per quelli, carica il pack e guarda il log del gioco (Trovare gli errori).

Cosa mostra in anteprima

File	Anteprima
Oggetto	Il tooltip del gioco: nome nel colore della rarità, incantesimi, descrizione, modificatori degli attributi, requisiti, l'abilità attiva (tasto, danni, ricarica) e il bonus alle caratteristiche
Ricetta	La griglia di fabbricazione con il risultato, o l'alambicco
Incantesimo	Il tooltip del libro incantato, a cosa si applica, e una tabella con ogni livello e il suo costo
Regola dei requisiti	Cosa blocca, per quali oggetti o blocchi, e quali punteggi richiede
Obiettivo	La notifica che compare, il suo tooltip e i suoi criteri
Titolo	La targhetta sopra il giocatore
Impostazioni del mondo	Cosa hai cambiato rispetto ai valori predefiniti, cosa fa ogni punteggio di caratteristica, e quanta XP costa ogni livello
Tag, traduzioni, pack.mcmeta	I loro valori, le traduzioni affiancate, il pack come appare nella lista dei pack

Problemi comuni

• L'exe portatile per Windows non si avvia: richiede il runtime WebView2 di Microsoft, incluso in Windows 10 e 11 (su un sistema vecchio o ridotto, installa "WebView2 Runtime" da Microsoft, oppure usa l'installer, che lo aggiunge).
• Apri e Salva non fanno nulla: funzionano solo nell'app, non quando la pagina è aperta in un browser (npm run dev).
• Un nome tradotto compare come chiave (item.minednd.flame_sword): il file non è stato aperto dall'interno del suo datapack, quindi l'app non ha trovato le traduzioni. Aprilo dalla cartella del datapack, o ignoralo: il gioco mostra il testo.