Hoe importeer je een deck uit een CSV- of JSON-bestand

Heb je een deck in een spreadsheet of een kaartlijst uit een ander programma? Deck Builder 3.5.0 kan een heel deck importeren uit een CSV-bestand of een JSON-bestand, en een ingebouwde kolomtoewijzer laat je kiezen welke kolom welk kaartveld wordt. Hier lees je precies hoe de twee formaten werken.

Open de importkiezer

Open op het Decks-scherm het overloopmenu (⋮) en tik op Deck importeren. Deck Builder biedt drie formaten:

• Deck Builder-bestand (.dbpd): een volledige export uit een andere Deck Builder-installatie, afbeeldingen inbegrepen.
• JSON: een bewerkbaar tekstbestand dat het Deck Builder-kaartschema volgt.
• CSV: een spreadsheet, waarbij je elke kolom aan een kaartveld toewijst.

Kies CSV of JSON en wijs Deck Builder je bestand aan.

Importeren uit CSV

Een CSV is de eenvoudigste manier om een deck binnen te halen dat je al in een spreadsheet bijhoudt. Een paar regels:

• De eerste rij is een koprij. De labels ervan bepalen welke kolom aan welk veld wordt toegewezen.
• Eén kaart per rij. Om meerdere exemplaren van een kaart toe te voegen, gebruik je een Quantity-kolom (zie hieronder) of herhaal je de rij.
• Bestanden worden gelezen als UTF-8 met standaard CSV-quoting: zet een veld tussen dubbele aanhalingstekens om komma’s of regelafbrekingen erin toe te staan, en verdubbel een letterlijk aanhalingsteken ("") om het te escapen.
• De maximale bestandsgrootte is 20 MB.

Kolomnamen

Alleen Name is verplicht. Elke andere kolom is optioneel. Deck Builder wijst je koppen automatisch toe aan kaartvelden (de overeenkomst is ongevoelig voor hoofdletters, spaties en leestekens), en je kunt op het toewijzingsscherm elke kolom overschrijven of instellen op Niet importeren. Deze koppen worden herkend (de kopnamen zelf zijn Engels):

Kaartveld	Aanbevolen kop	Komt ook overeen met
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

Als twee kolommen aan hetzelfde veld worden toegewezen, staat de tweede standaard op Niet importeren, zodat je de dubbelzinnigheid bewust oplost. Onbekende koppen staan ook standaard op Niet importeren.

Lijsten en aantallen

• Lijstkolommen: Tags, Keywords, Subtypes en Supertypes kunnen meerdere waarden in één cel bevatten. Scheid ze met een puntkomma (;), bijvoorbeeld burn;red;spell. De komma is het kolomscheidingsteken, dus die kan niet ook lijstonderdelen scheiden.
• Aantal: een Quantity van 3 maakt drie afzonderlijke kaarten aan (Deck Builder heeft geen aantalveld per kaart). Een ontbrekende, lege, 0 of negatieve waarde betekent 1, en voorafgaande tekst wordt getolereerd, dus 2x wordt 2.

Een uitgewerkt voorbeeld

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

Dit importeert 27 cards (4 + 2 + 1 + 20).

Kaartillustraties

De Image URL-kolom accepteert twee soorten waarden:

• een http(s)-URL, opgeslagen als een externe verwijzing en op aanvraag geladen (op dezelfde manier als Scryfall-kaarten werken). De afbeelding wordt nooit gedownload of opnieuw verspreid.
• een ingesloten afbeelding als een data:image/...;base64,...-URI, gedecodeerd en op je apparaat opgeslagen.

Elke andere waarde (een kale bestandsnaam of een lokaal pad) wordt genegeerd, en de kaart wordt zonder illustratie geïmporteerd. Je kunt altijd later illustraties toevoegen in de kaarteditor.

Importeren uit JSON

JSON is het rijkere formaat. Het is hetzelfde tekst-only schema dat binnen een Deck Builder-export (.dbpd) wordt gebruikt, dus het draagt deckinstellingen en meer detail per kaart dan een platte spreadsheet kan. De makkelijkste manier om er een te maken is een bestaand deck als JSON te exporteren, het te bewerken en het weer te importeren.

Het bovenste niveau ziet er zo uit:

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

UUID’s zijn strings, tijdstempels zijn ISO-8601, en onbekende sleutels worden genegeerd. Let op dat het JSON-veld rulesText heet (camelCase), terwijl de CSV-kop Rules Text is. JSON draagt geen afbeeldingsbytes, dus gebruik externe afbeeldings-URL’s.

Wat je kunt verwachten

• Alleen een naam is verplicht. Al het andere is optioneel in beide formaten.
• Er wordt een nieuw deck aangemaakt met een nieuwe identiteit. Een import wordt nooit samengevoegd met een bestaand deck.
• Geïmporteerde kaarten worden gemarkeerd met de bron Imported.
• Als een bestand onjuist is opgemaakt of groter is dan 20 MB, toont Deck Builder een duidelijke melding op het importscherm in plaats van te falen.

---

Zodra je deck binnen is, kun je er meer mee doen: maak er printklare kaarten van, of publiceer het in de Deck Store zodat andere spelers het kunnen vinden.