Il datapack Default Content¶

La mod MineDnD da sola aggiunge le meccaniche: i punteggi di caratteristica e i loro effetti, livelli e punti, la scheda personaggio, le abilità degli oggetti, le regole sui requisiti, i trigger delle imprese, i titoli e i comandi /dnd. Non aggiunge contenuti: niente oggetti magici, incantesimi, regole, imprese o titoli.

Tutto questo arriva dai datapack. Il datapack MineDnD Default Content (namespace dnd5e) è un mondo costruito con il motore, in stile D&D 5e, per mostrare cosa può fare: installalo per giocare subito, usane solo una parte, copia i suoi file come esempi per i tuoi, oppure fanne a meno e scrivi il tuo mondo da zero.

Cosa contiene¶

Cartella nel pacchetto	Cosa aggiunge	Quanti
`data/dnd5e/items/`	Oggetti magici: armi, armature, accessori, frecce, tomi, strumenti, pozioni, modelli di forgiatura, cibo (10 sono segreti: nascosti)	108
`data/dnd5e/recipe/`	Come farli: banco da fabbricazione, alambicco, banco da forgiatura, tavolo da arciere per frecce, archi e balestre (arciere), tavolo da incantesimi per bacchette, bastoni, libri degli incantesimi e oggetti per la mano secondaria (infusione), e fornace, affumicatore e falò per il cibo (cottura)	94
`data/dnd5e/advancement/recipes/`	Quando ogni ricetta compare nel ricettario (il tavolo da arciere e quello da incantesimi elencano le loro)	54
`data/dnd5e/loot_injections/`	Oggetti leggendari e modelli nelle casse di Minecraft, nei drop dei mob e nella pesca (bottino)	12
`data/dnd5e/loot_table/game_master/`	Un tesoro che i game master possono dare: `/loot give @p loot dnd5e:game_master/dragon_hoard`	1
`data/dnd5e/enchantment/` e `data/minecraft/tags/enchantment/`	Incantesimi, e dove si trovano (tavolo per incantesimi, bottino, scambi)	24
`data/dnd5e/crafting_requirements/`	Regole sui requisiti: punteggi per creare, distillare, piazzare e usare le cose (incudini, fari, strumenti di diamante…); `brewing/` dà un livello a ogni pozione, `imbuing/` a ogni ricetta d'infusione; `legendary/` limita le ricette leggendarie	59
`data/dnd5e/tags/potion/`	Gruppi di pozioni usati dai livelli di distillazione	3
`data/minednd/tags/block/first_time_xp.json`	Blocchi che danno esperienza d'avventura la prima volta che si scavano	1
`data/dnd5e/advancement/achievements/`	La scheda delle imprese MineDnD	27
`data/dnd5e/title/`	Titoli, sbloccati dalle imprese	10
`data/dnd5e/lang/`	Nomi e descrizioni in inglese e in italiano, e i livelli degli incantesimi XI–XX	2
`data/minednd/settings.json`	Ogni impostazione del mondo, da copiare e cambiare: tutte ai valori predefiniti della mod tranne l'esperienza d'avventura, che attiva (`"enabled": true`), senza esperienza per le uccisioni ripetute (`"repeat_kills": false`)	1

Ogni oggetto, incantesimo e regola, in tabelle: Contenuti predefiniti; uno per uno: oggetti, incantesimi.

Oggetti leggendari¶

Gli oggetti leggendari sono rari apposta, e sono anche gli esempi del pacchetto per tutte le funzioni degli oggetti rari: un limite per mondo, oggetti e ricette nascosti, modelli di forgiatura, bottino e ricette che richiedono altri oggetti MineDnD. Le ricette che richiedono un modello nascosto sono segrete per i giocatori (le pagine degli oggetti dicono solo "si trova nel mondo"); per vedere come sono fatte, apri i file del pacchetto.

Oggetto	Cosa mostra	File (`data/dnd5e/…`)
Spada Vorpal	Un modello nascosto, limitato a 1, nelle casse delle città dell'End; la spada stessa limitata a 1; una regola sui requisiti nel banco da forgiatura	`items/templates/vorpal_edge.json`, `recipe/weapons/vorpal_sword.json`, `loot_injections/vorpal_edge.json`, `crafting_requirements/legendary/vorpal_sword.json`
Bastone del Potere	Migliorare un oggetto MineDnD (il Bastone del Mago) nel banco da forgiatura; un modello in due posti: casse delle città antiche e drop degli evocatori	`recipe/weapons/staff_of_power.json`, `loot_injections/arcane_focus_*.json`
Corazza Infernale	Un modello che i giocatori possono conoscere (non nascosto), basato su un modello di finitura di Minecraft, nei bastioni; un tag come aggiunta	`items/templates/infernal_forge.json`, `recipe/armor/infernal_cuirass.json`
Martello dei Fulmini	Un modello che solo gli operatori possono creare (`"limit": 0`), come premio di una missione; un oggetto MineDnD come aggiunta	`items/templates/thunder_rune.json`, `recipe/weapons/hammer_of_thunderbolts.json`
Giavellotto del Fulmine	Un modello nascosto senza limite, dalla pesca e dalle casseforti infauste (due alla volta); forgiatura senza aggiunta	`recipe/weapons/javelin_of_lightning.json`, `loot_injections/storm_sigil_*.json`
Periapto della Chiusura delle Ferite → Simbolo Sacro	Una catena: Amuleto della Salute (creato) → Periapto (creato, limitato a 5) → Simbolo Sacro (forgiatura senza modello)	`recipe/accessories/periapt_of_wound_closure.json`, `recipe/weapons/holy_symbol.json`
Cintura della Forza dei Giganti	Creazione con tre oggetti MineDnD, uno distillato (Pozione della Forza del Gigante delle Colline); limitata a 3; la ricetta si sblocca quando ne ottieni uno	`recipe/armor/belt_of_giant_strength.json`, `advancement/recipes/armor/belt_of_giant_strength.json`
Perla del Potere, i quattro tomi	Oggetti trovati direttamente, senza ricetta: drop dei guardiani antichi; casse delle biblioteche delle roccaforti e delle magioni nel bosco	`loot_injections/pearl_of_power.json`, `loot_injections/tome_*.json`, `…/manual_of_bodily_health.json`
Due oggetti segreti	Una pozione nascosta distillata da una pozione MineDnD, limitata per ampolla, che non è nell'elenco dell'alambicco; un anello nascosto creato dalla Perla del Potere, la cui ricetta compare nel ricettario solo quando trovi una Perla	`items/potions/`, `items/accessories/` (quelli con `"hidden": true`)
Stivali della Caduta Morbida, Armatura dell'Invulnerabilità	Livelli oltre quelli di Minecraft: Atterraggio morbido X (oltre il limite dell'80 %: protegge come il VII) e Protezione XV (con il nome dalle traduzioni XI–XX del pacchetto); l'Armatura solo dal tesoro del drago. La Spada Vorpal ha Affilatezza VIII, la Corazza Infernale Protezione dal fuoco VI. Vedi Modificare gli incantesimi di Minecraft	`items/armor/boots_of_featherfall.json`, `items/armor/armor_of_invulnerability.json`, `lang/`
Il tesoro del drago	Una tabella del bottino del pacchetto, per i game master: oggetti MineDnD con pesi, un modello con una condizione, tesori di Minecraft. I limiti valgono comunque	`loot_table/game_master/dragon_hoard.json`

Gli oggetti limitati e nascosti non sono nelle casse del mondo di esempio (lì chiunque potrebbe prenderli o vederli); gli operatori li ottengono con /dnd give, e /dnd limited list mostra quanti ne ha creati ogni mondo.

Senza di esso MineDnD funziona lo stesso: i punteggi cambiano danni, velocità, salute ed esperienza, i giocatori salgono di livello, la scheda personaggio, i comandi e le abilità degli oggetti funzionano. Semplicemente non ci sono oggetti MineDnD (la scheda creativa è vuota), regole sui requisiti, imprese e titoli MineDnD, l'esperienza d'avventura è disattivata (si sale di livello solo con i comandi /dnd), e scavare non dà esperienza della prima volta (nessun blocco è nell'elenco).

Scaricarlo¶

Dalla pagina Releases del repository, il file MineDnD-Default-Content-<version>.zip, accanto al jar della mod (e, per il suo aspetto, MineDnD-Default-Content-Resources-<version>.zip). Prendi la versione uguale a quella della tua mod. Non decomprimerlo: Minecraft legge lo zip così com'è.

Stai provando una release candidate (la versione X.Y.Z-rc della mod su Modrinth)? Il suo datapack è MineDnD-Default-Content-<versione>-rc-<commit>.zip, nella pre-release "MineDnD release candidate" (tag rc-v<versione>) sulla stessa pagina: prendi quello il cui commit corrisponde a quello della mod (l'elenco delle mod mostra X.Y.Z-rc+<commit>).

Il suo aspetto: il resource pack¶

MineDnD-Default-Content-Resources-<version>.zip, accanto al datapack, è un resource pack: 91 oggetti del pacchetto hanno le loro icone, nell'inventario e in mano: le armi, i bastoni e le bacchette, gli archi, il libro degli incantesimi e i tomi, il Piccone Nanico, le armature e gli scudi, gli anelli, gli amuleti e le pietre, e il cibo. Le armature hanno anche il loro aspetto indossate (elmi, corazze, schinieri, la cintura, stivali). È facoltativo e separato:

Installarlo: mettilo nella cartella resourcepacks del gioco (non del mondo) e attivalo in Opzioni → Pacchetti di risorse. Il modpack .mrpack ce l'ha già: basta attivarlo. Un server può inviarlo ai giocatori con resource-pack= in server.properties (come).
Senza gli oggetti funzionano allo stesso modo e hanno l'aspetto del loro oggetto base (una Spada Fiammeggiante sembra una spada di ferro). Fanno eccezione le armature indossate: senza il resource pack sono invisibili addosso (proteggono comunque). Il loro aspetto sul corpo viene dal resource pack, senza un aspetto di Minecraft a cui tornare (perché).
Senza il datapack non cambia niente: ogni spada, arco o bastone di Minecraft resta com'è.
Accanto ad altri pacchetti di aspetto: non sostituisce nessun file di Minecraft (l'aspetto di ogni oggetto è un suo file, con il suo id), quindi funziona insieme al tuo o a quello di un altro autore.
La Balestra Pesante Nanica e il Lanciadardi, le pozioni, le frecce e i modelli del banco da forgiatura per ora hanno l'aspetto del loro oggetto base.
Icone di IvoryRed (pacchetti armi, armature, oggetti e Bar Katto, CC BY 4.0); il file CREDITS.md del pacchetto ha i dettagli e cosa è stato cambiato. Come è fatto: Aspetto personalizzato, e i suoi file in resourcepacks/default-content.

Installarlo¶

Il datapack va in ogni mondo che deve averlo (i datapack appartengono a un mondo, non al gioco). Ai giocatori non serve sul loro computer: su un server ce l'ha solo il server, e la mod manda i nomi e le regole a ogni giocatore.

Un mondo nuovo¶

Giocatore singolo → Crea un nuovo mondo → Altro → Pacchetti dati.
Trascina MineDnD-Default-Content-<version>.zip sulla finestra (oppure Apri cartella pacchetti e copialo lì).
Clicca la freccia su MineDnD Default Content per spostarlo tra i Selezionati, poi Fatto.
Crea il mondo. Con il pulsante Mondo di esempio MineDnD (scheda Gioco), aggiungi prima il datapack nello stesso modo, poi premi il pulsante: le casse davanti a te conterranno tutti gli oggetti.

Un mondo esistente¶

Chiudi il mondo (o il gioco).
Metti lo zip nella cartella datapacks del mondo:

Dov'è il mondo	Cartella
Nel gioco	Giocatore singolo → seleziona il mondo → Modifica → Apri cartella del mondo → `datapacks`
Launcher di Minecraft, Windows	`%APPDATA%\.minecraft\saves\<mondo>\datapacks`
Launcher di Minecraft, macOS	`~/Library/Application Support/minecraft/saves/<mondo>/datapacks`
Launcher di Minecraft, Linux	`~/.minecraft/saves/<mondo>/datapacks`
Modrinth App	l'istanza → ⋯ → Apri cartella → `saves/<mondo>/datapacks`

Apri il mondo. Un pacchetto nuovo nella cartella si attiva quando il mondo si carica.

Riapri il mondo invece di usare /reload: il pacchetto ha degli incantesimi, e Minecraft carica gli incantesimi solo quando un mondo si carica.

Un server¶

Ferma il server.
Metti lo zip in <cartella del server>/<mondo>/datapacks/. La cartella del mondo è level-name in server.properties (di solito world). Su un pannello di hosting usa il suo gestore file o l'SFTP.
Avvia il server.

Controllare che sia attivo¶

/datapack list: file/MineDnD-Default-Content-<version>.zip è tra i pacchetti attivi.
/dnd info lo elenca con quanti oggetti, incantesimi, regole e ricette aggiunge.
La scheda creativa MineDnD ha gli oggetti; /dnd catalog chests piazza casse con tutti gli oggetti.

Aggiornarlo¶

Chiudi il mondo (o ferma il server).
Elimina il vecchio MineDnD-Default-Content-….zip da datapacks e metti lì quello nuovo. Non tenerli entrambi: sarebbero attive due versioni, e la più nuova non vincerebbe sempre.
Apri il mondo (o avvia il server).

I tuoi pacchetti che ne cambiano delle parti (vedi Modificarlo) continuano a funzionare dopo un aggiornamento; i file che hai modificato dentro il pacchetto stesso vengono sostituiti.

Disattivarlo o toglierlo¶

Disattivato, tenendo il file: /datapack disable "file/MineDnD-Default-Content-<version>.zip" (il nome si completa con Tab); /datapack enable lo riattiva. Riapri il mondo perché spariscano anche gli incantesimi.
Tolto: elimina lo zip e riapri il mondo.

Gli oggetti che i giocatori hanno già tengono nome, descrizione, bonus, requisiti e abilità (sono salvati sull'oggetto), ma perdono gli incantesimi del pacchetto; ricette, regole sui requisiti, imprese e titoli spariscono, e gli oggetti non si possono più dare con /dnd give.

Usarne solo una parte¶

Un datapack funziona anche come semplice cartella. Decomprimi il pacchetto nella cartella datapacks del mondo (ottieni una cartella con dentro pack.mcmeta e data/, ed è giusto così; pack.mcmeta deve stare direttamente in quella cartella, non un livello più giù), elimina ciò che non vuoi e riapri il mondo.

Per togliere	Elimina	Nota
Le regole sui requisiti	`data/dnd5e/crafting_requirements/`	`brewing/` da solo sono i livelli delle pozioni
Solo i livelli di distillazione	`data/dnd5e/crafting_requirements/brewing/` e `data/dnd5e/tags/potion/`
Imprese e titoli	`data/dnd5e/advancement/achievements/` e `data/dnd5e/title/`	I titoli hanno bisogno della loro impresa
Solo i titoli	`data/dnd5e/title/`	Le imprese restano
Gli incantesimi	`data/dnd5e/enchantment/` e `data/minecraft/tags/enchantment/`	Gli oggetti che li hanno li perdono
Alcuni oggetti	il loro file in `data/dnd5e/items/…`, e i file con lo stesso percorso in `recipe/` e `advancement/recipes/`	Una ricetta senza il suo oggetto non crea nulla
Lo sblocco delle ricette	`data/dnd5e/advancement/recipes/`	Allora ogni ricetta è nel ricettario di tutti fin dall'inizio
L'esperienza della prima volta dai blocchi	`data/minednd/tags/block/first_time_xp.json`
Le impostazioni del mondo	`data/minednd/settings.json`	L'esperienza d'avventura torna disattivata (il valore predefinito della mod); il resto è già predefinito

Tieni data/dnd5e/lang/: contiene i nomi e le descrizioni. Senza, gli oggetti mostrano il testo inglese di riserva e imprese e titoli mostrano le loro chiavi.

Esempi: - Solo le regole (punteggi per usare incudini, fari, strumenti di diamante, livelli delle pozioni), niente oggetti: tieni pack.mcmeta, data/dnd5e/crafting_requirements/, data/dnd5e/tags/potion/ e data/dnd5e/lang/. - Tutto tranne imprese e titoli: elimina data/dnd5e/advancement/achievements/ e data/dnd5e/title/.

Modificarlo¶

Due modi:

Modificare i file del pacchetto (decompresso, come sopra). Veloce, ma un aggiornamento sostituisce le tue modifiche.
Consigliato: un tuo piccolo pacchetto sopra. Crea un tuo datapack con solo i file che cambi, allo stesso percorso che hanno nel pacchetto Default Content, e mettilo sopra il pacchetto Default Content nell'ordine di caricamento. I suoi file sostituiscono quelli del pacchetto, e aggiornare il Default Content tiene le tue modifiche. Come si fa un pacchetto e l'ordine di caricamento: Datapack e Ordine di caricamento e sostituzioni.

Esempi, nel tuo pacchetto (data/dnd5e/… è il namespace del pacchetto Default Content, così i percorsi coincidono):

Per	File nel tuo pacchetto
Far richiedere FOR 10 alla Spada Fiammeggiante	copia `data/dnd5e/items/weapons/flame_sword.json` e cambia `"minednd:requirements": { "str": 10 }`
Togliere la regola sugli archi	`data/dnd5e/crafting_requirements/bow.json` con `{ "items": "minecraft:bow", "requirements": { "dex": 1 } }` (punteggio 1: lo soddisfano tutti)
Rendere più facile il titolo del Minatore	copia `data/dnd5e/advancement/achievements/miner_2.json` e abbassa `"min"`
Disattivare l'esperienza d'avventura, o darla anche per le uccisioni ripetute	`data/minednd/settings.json` con `{ "experience": { "enabled": false } }` o `{ "experience": { "repeat_kills": true } }`: vedi sotto

Impostazioni del mondo: il file data/minednd/settings.json del pacchetto elenca ogni impostazione (esperienza d'avventura attiva, senza uccisioni ripetute; il resto ai valori predefiniti della mod), così le vedi tutte in un posto (cosa fa ognuna: Impostazioni del mondo). Copialo nel tuo pacchetto e tieni solo i valori che cambi. Le impostazioni si uniscono chiave per chiave e il pacchetto più in alto vince per ogni valore: dato che il pacchetto Default Content li imposta tutti, il tuo pacchetto deve stare sopra, altrimenti vincono i suoi valori predefiniti. /dnd info settings mostra ogni valore cambiato e il pacchetto che l'ha impostato.

Per aggiungere i tuoi oggetti, regole o imprese accanto a quelli predefiniti: dagli un tuo namespace (data/my_campaign/…), così non si scontrano mai con i file del pacchetto. Vedi Datapack.