Come importare un mazzo da un file CSV o JSON

Hai un mazzo in un foglio di calcolo, o un elenco di carte da un altro strumento? Deck Builder 3.5.0 può importare un intero mazzo da un file CSV o da un file JSON, e un mappatore di colonne integrato ti permette di scegliere quale colonna diventa quale campo della carta. Ecco esattamente come funzionano i due formati.

Apri il selettore di importazione

Nella schermata Mazzi, apri il menu a tre puntini (⋮) e tocca Importa mazzo. Deck Builder offre tre formati:

• File Deck Builder (.dbpd): un’esportazione completa da un’altra installazione di Deck Builder, immagini incluse.
• JSON: un file di testo modificabile che segue lo schema delle carte di Deck Builder.
• CSV: un foglio di calcolo, dove mappi ogni colonna a un campo della carta.

Scegli CSV o JSON e indica a Deck Builder il tuo file.

Importazione da CSV

Un CSV è il modo più semplice per importare un mazzo che tieni già in un foglio di calcolo. Alcune regole:

• La prima riga è una riga di intestazione. Le sue etichette determinano quale colonna corrisponde a quale campo.
• Una carta per riga. Per aggiungere più copie di una carta, usa una colonna Quantity (vedi sotto) oppure ripeti la riga.
• I file vengono letti come UTF-8 con la consueta gestione delle virgolette CSV: racchiudi un campo tra virgolette doppie per consentire virgole o interruzioni di riga al suo interno, e raddoppia una virgoletta letterale ("") per applicarne l’escape.
• La dimensione massima del file è 20 MB.

Nomi delle colonne

Solo Name è obbligatorio. Ogni altra colonna è facoltativa. Deck Builder mappa automaticamente le tue intestazioni ai campi della carta (la corrispondenza ignora maiuscole/minuscole, spazi e punteggiatura), e puoi sovrascrivere qualsiasi colonna, o impostarla su Non importare, nella schermata di mappatura. Queste intestazioni vengono riconosciute (i nomi delle intestazioni sono in inglese):

Campo carta	Intestazione consigliata	Corrisponde anche a
Name	Name	cardname, card, title
Quantity	Quantity	qty, count, copies, amount
Type	Type	cardtype, typeline
Subtypes	Subtypes	subtype
Supertypes	Supertypes	supertype
Rarity	Rarity
Set name	Set Name	set, edition, expansion
Set number	Set Number	collectornumber, cardnumber, number, no
Cost	Cost	mana, manacost, price, value
Cost unit	Cost Unit
Power	Power	attack, atk, strength
Power unit	Power Unit
Health	Health	toughness, defense, hp, life
Health unit	Health Unit
Game	Game
Rules text	Rules Text	rules, text, oracle, oracletext, ability, effect, body
Flavor text	Flavor Text	flavourtext, flavor, flavour, quote
Description	Description	desc, notes, comment
Tags	Tags	tag, labels, categories, category
Keywords	Keywords	keyword
Image URL	Image URL	image, img, art, artwork, picture, url, imageuri, imagelink

Se due colonne corrispondono allo stesso campo, la seconda viene impostata come predefinita su Non importare, così risolvi l’ambiguità in modo consapevole. Anche le intestazioni sconosciute vengono impostate su Non importare.

Elenchi e quantità

• Colonne di tipo elenco: Tags, Keywords, Subtypes e Supertypes possono contenere più valori in una singola cella. Separali con un punto e virgola (;), per esempio burn;red;spell. La virgola è il separatore di colonna, quindi non può separare anche gli elementi dell’elenco.
• Quantità: una Quantity di 3 crea tre carte separate (Deck Builder non ha un campo di conteggio per carta). Un valore mancante, vuoto, 0 o negativo significa 1, e il testo iniziale viene tollerato, quindi 2x diventa 2.

Un esempio pratico

Name,Quantity,Type,Cost,Power,Health,Rarity,Tags,Keywords,Rules Text,Flavor Text,Image URL
Lightning Bolt,4,Instant,R,,,Common,burn;red,,"Lightning Bolt deals 3 damage to any target.","The sparkmage shrieked...",https://cards.scryfall.io/normal/front/c/e/ce711943-c1a1-43a0-8b89-8d169cfb8e06.jpg
Grizzly Bears,2,Creature,1G,2,2,Common,green;beatdown,,,"Don't try to outrun one of Dominaria's grizzlies...",https://cards.scryfall.io/normal/front/4/0/409f9b88-f03e-40b6-9883-68c14c37c0de.jpg
Serra Angel,1,Creature,3WW,4,4,Uncommon,white;flyer,Flying;Vigilance,"Flying, vigilance","Never resting, never faltering.",
Island,20,Land,,,,Common,land;blue,,"({T}: Add {U}.)",,

Questo importa 27 cards (4 + 2 + 1 + 20).

Grafica delle carte

La colonna Image URL accetta due tipi di valore:

• un URL http(s), memorizzato come riferimento esterno e caricato su richiesta (allo stesso modo in cui funzionano le carte Scryfall). L’immagine non viene mai scaricata né ridistribuita.
• un’immagine incorporata come URI data:image/...;base64,..., decodificata e salvata sul tuo dispositivo.

Qualsiasi altro valore (un semplice nome di file o un percorso locale) viene ignorato, e la carta viene importata senza grafica. Puoi sempre aggiungere la grafica in seguito nell’editor delle carte.

Importazione da JSON

JSON è il formato più ricco. È lo stesso schema di solo testo usato all’interno di un’esportazione di Deck Builder (.dbpd), quindi porta con sé le impostazioni del mazzo e più dettagli per carta di quanti ne possa contenere un foglio di calcolo piatto. Il modo più semplice per crearne uno è esportare un mazzo esistente come JSON, modificarlo e reimportarlo.

Il livello superiore ha questo aspetto:

{
  "formatVersion": 1,
  "exportedAt": "2026-07-15T12:00:00Z",
  "deck": {
    "uuid": "…", "name": "My Deck",
    "source": "IMPORTED",
    "tags": ["standard"]
  },
  "settings": { "handCardsCount": 1, "discardPileEnabled": true },
  "cards": [
    {
      "uuid": "…", "name": "Lightning Bolt", "cardDeckIndex": 0,
      "type": "Instant", "cost": "R",
      "rulesText": "Lightning Bolt deals 3 damage to any target.",
      "tags": ["burn"], "keywords": [],
      "source": "IMPORTED"
    }
  ]
}

Gli UUID sono stringhe, i timestamp sono in ISO-8601, e le chiavi sconosciute vengono ignorate. Nota che il campo JSON è rulesText (camelCase), mentre l’intestazione CSV è Rules Text. Il JSON non contiene byte di immagine, quindi usa URL di immagini esterne.

Cosa aspettarsi

• È richiesto solo un nome. Tutto il resto è facoltativo in entrambi i formati.
• Viene creato un nuovo mazzo con una nuova identità. Un’importazione non viene mai unita a un mazzo esistente.
• Le carte importate sono contrassegnate con la sorgente Importato.
• Se un file è malformato o più grande di 20 MB, Deck Builder mostra un messaggio chiaro nella schermata di importazione invece di fallire.

---

Una volta importato il mazzo, puoi fare un passo in più: trasformalo in carte pronte per la stampa, oppure pubblicalo nel Deck Store così altri giocatori possono trovarlo.