Comment importer un deck depuis un fichier CSV ou JSON

Vous avez un deck dans un tableur, ou une liste de cartes provenant d’un autre outil ? Deck Builder 3.5.0 peut importer un deck entier depuis un fichier CSV ou un fichier JSON, et un outil de correspondance des colonnes intégré vous laisse choisir quelle colonne devient quel champ de carte. Voici exactement comment fonctionnent les deux formats.

Ouvrir le sélecteur d’import

Sur l’écran Decks, ouvrez le menu de dépassement (⋮) et tapez sur Importer un deck. Deck Builder propose trois formats :

• Fichier Deck Builder (.dbpd) : un export complet depuis une autre installation de Deck Builder, images comprises.
• JSON : un fichier texte modifiable suivant le schéma de carte de Deck Builder.
• CSV : un tableur, dans lequel vous faites correspondre chaque colonne à un champ de carte.

Choisissez CSV ou JSON et indiquez votre fichier à Deck Builder.

Importer depuis un CSV

Un CSV est le moyen le plus simple d’amener un deck que vous conservez déjà dans un tableur. Quelques règles :

• La première ligne est une ligne d’en-tête. Ses libellés déterminent quelle colonne correspond à quel champ.
• Une carte par ligne. Pour ajouter plusieurs exemplaires d’une carte, utilisez une colonne Quantity (voir ci-dessous) ou répétez la ligne.
• Les fichiers sont lus en UTF-8 avec l’échappement CSV standard : entourez un champ de guillemets doubles pour y autoriser des virgules ou des sauts de ligne, et doublez un guillemet littéral ("") pour l’échapper.
• La taille maximale du fichier est de 20 MB.

Noms des colonnes

Seul Name est obligatoire. Toutes les autres colonnes sont facultatives. Deck Builder fait automatiquement correspondre vos en-têtes aux champs de carte (la correspondance ignore la casse, les espaces et la ponctuation), et vous pouvez remplacer n’importe quelle colonne, ou la régler sur Ne pas importer, sur l’écran de correspondance. Ces en-têtes sont reconnus (les noms d’en-tête eux-mêmes sont en anglais) :

Champ de carte	En-tête recommandé	Correspond aussi à
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

Si deux colonnes correspondent au même champ, la seconde est réglée par défaut sur Ne pas importer, pour que vous leviez l’ambiguïté de façon délibérée. Les en-têtes inconnus sont eux aussi réglés par défaut sur Ne pas importer.

Listes et quantités

• Colonnes de type liste : Tags, Keywords, Subtypes et Supertypes peuvent contenir plusieurs valeurs dans une seule cellule. Séparez-les par un point-virgule (;), par exemple burn;red;spell. La virgule est le séparateur de colonnes, elle ne peut donc pas aussi séparer les éléments d’une liste.
• Quantité : une Quantity de 3 crée trois cartes distinctes (Deck Builder n’a pas de champ de comptage par carte). Une valeur absente, vide, égale à 0 ou négative signifie 1, et un texte en préfixe est toléré, donc 2x devient 2.

Un exemple concret

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}.)",,

Cela importe 27 cards (4 + 2 + 1 + 20).

Illustration des cartes

La colonne Image URL accepte deux types de valeur :

• une URL http(s), stockée comme référence externe et chargée à la demande (de la même façon que les cartes Scryfall). L’image n’est jamais téléchargée ni redistribuée.
• une image intégrée sous forme d’URI data:image/...;base64,..., décodée et enregistrée sur votre appareil.

Toute autre valeur (un simple nom de fichier ou un chemin local) est ignorée, et la carte est importée sans illustration. Vous pouvez toujours ajouter une illustration plus tard dans l’éditeur de cartes.

Importer depuis un JSON

Le JSON est le format le plus riche. C’est le même schéma en texte seul que celui utilisé à l’intérieur d’un export Deck Builder (.dbpd), il transporte donc les réglages du deck et davantage de détails par carte qu’un simple tableur. La façon la plus simple d’en créer un est d’exporter un deck existant en JSON, de le modifier et de le réimporter.

Le niveau supérieur ressemble à ceci :

{
  "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"
    }
  ]
}

Les UUID sont des chaînes de caractères, les horodatages sont au format ISO-8601, et les clés inconnues sont ignorées. Notez que le champ JSON est rulesText (camelCase), tandis que l’en-tête CSV est Rules Text. Le JSON ne transporte aucun octet d’image, utilisez donc des URL d’image externes.

À quoi s’attendre

• Seul un nom est obligatoire. Tout le reste est facultatif dans les deux formats.
• Un nouveau deck est créé avec une nouvelle identité. Un import n’est jamais fusionné dans un deck existant.
• Les cartes importées sont marquées avec la source Imported.
• Si un fichier est mal formé ou dépasse 20 MB, Deck Builder affiche un message clair sur l’écran d’import au lieu d’échouer.

---

Une fois votre deck importé, vous pouvez aller plus loin : transformez-le en cartes prêtes à imprimer, ou publiez-le dans le Deck Store pour que d’autres joueurs le trouvent.