MTG Card Primers

by Diogo Leal
5
4
3
2
1
Score: 30/100

Description

Obsidian plugin: Magic: The Gathering card primers with Scryfall data, card symbols and hover previews.

Reviews

No reviews yet.

Stats

1
stars
96
downloads
0
forks
17
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
4
total issues
4
open issues
0
closed issues
21
commits

Latest Version

5 days ago

Changelog

Shared cards: compact view

The mtg-shared block has a Cards / Compact switch in its header (saved in the block as view: compact). The compact view shows each card on one line: its art, its name, how many copies and decks, and a pill per deck with the commander's art. The deck that has the card is green with a check; click another pill to move the card there.

The compact view

Fixes

  • Moving a shared card, or switching the view of a decklist, hand or sideboard block, no longer sends the cursor and the scroll to the top of the note in the editor.

README file from

Github

MTG Card Primers

CI GitHub release Obsidian Downloads License


Write study notes ("primers") for Magic: The Gathering cards and decks, right in your vault.

MTG Card Primers treats your Magic knowledge the way Obsidian treats everything else: as plain Markdown notes you own. Decklists, combos and sideboard plans are short text blocks inside your notes, so they stay readable without the plugin, and the card data and images come from Scryfall.

A card primer with the card, its symbols and a hover preview

Feature Highlights

📝 Card primers

Run New card primer, pick a card, and you get a note made from your template, with the card's data saved in the frontmatter. Every printing of a card shares the same primer, so you never end up with duplicates. Find cards by name, by pasting a Moxfield line (1 Sol Ring (C21) 263), or by their name in another language (Anel Solar).

🏰 Deck primers

New deck primer asks for a commander and creates a note ready to fill in: the decklist, how the deck wins, combos, tutors, the opening hands to keep or mulligan, what shuts it down and a log of the changes you make.

🃏 Decklists

Paste a list from Moxfield, Arena or MTGO into an mtg-deck block and see it as a text list, stacks of cards or a grid of whole cards, sorted by type, name, mana value or colour. Pick the edition of each card, mark your foils, and click a card to open its primer in the side panel while the deck stays in view.

A decklist shown as stacks of cards

🔄 Sideboard and deck changes

Write Fabled Passage -> Verdant Catacombs in an mtg-sideboard or mtg-changes block and see what comes out of the deck and what goes in, with an arrow between the cards, the totals and the reason for each change. Group the changes by matchup, or keep a dated log of your deck.

A sideboard guide: the cards that come out, an arrow, and the cards that go in

✋ Opening hands

List seven cards in an mtg-hand block, write keep or mulligan and why, and see the hand fanned out with a green Keep or red Mulligan badge and its count of lands and spells. Show which hands your deck keeps and which it sends back.

Keep Mulligan
A hand to keep, with a green Keep badge A hand to mulligan, faded, with a red Mulligan badge

🔗 Shared cards

Own one Blackblade Reforged for three decks? List the card and the decks that share it in an mtg-shared block, and mark the deck that has it now. Each deck shows its commander's art, and Move here updates the note when the card changes decks. Switch to the Compact view to see every shared card on one line, with a pill per deck.

Cards Compact
Blackblade Reforged shared by three decks, with Arahbo holding it The compact view: one line per card and a pill per deck

♾️ Combos

The mtg-combo block draws a combo the way it sits on the table: each card in its zone (battlefield, graveyard, stack…), with sacrificed and tapped cards marked, targets and tokens. Add the result, how it works and its weak points, in Markdown.

A combo with each card in its zone: sacrificed cards marked, a target, results and how it works

🔮 Symbols

Write {1}{B}, {T}, [+1], {set:dsc:m} or [BRACKET 3] in any note and they turn into mana symbols, loyalty shields, set symbols and Commander bracket badges.

What you write and the symbols you see: mana, loyalty, level, set symbols and Commander brackets

👁️ Hover previews

Hover a [[Card name]] link and the card appears, even if you haven't written a primer for it yet.

🖼️ Insert into notes

Insert a card's text, its art, the full card image of any edition, or its set symbol at the cursor, as plain Markdown.

[!TIP] Each feature has its own page with every option and many examples: primers and commands · decklists · sideboard and deck changes · opening hands · shared cards · combos · symbols and hover previews.

Installation

Obsidian community directory

MTG Card Primers is in the Obsidian community plugin directory. Open Settings → Community plugins → Browse, search for MTG Card Primers, then install and enable it.

You can also see the listing at https://community.obsidian.md/plugins/mtg-card-primers

Manual

  1. Download main.js, manifest.json and styles.css from the latest release.
  2. Create the folder <your vault>/.obsidian/plugins/mtg-card-primers/.
  3. Copy the three files into that folder.
  4. Reload Obsidian and enable MTG Card Primers in Settings → Community plugins.

Getting started

  1. Open the command palette (Ctrl/Cmd+P) and run New card primer.
  2. Type a card name and pick it. The primer is created in MTG/Primers and opens.
  3. Write about the card. In any note, [[Card name]] links show the card on hover, and {2}{U} becomes mana symbols.
  4. For a deck, run New deck primer, pick your commander and paste the rest of the list under Deck.

The folders and templates can be changed in Settings → MTG Card Primers.

[!NOTE] The plugin only sends card lookups to Scryfall (names, set codes, card ids). Your notes are never sent. Images are links to Scryfall; nothing is downloaded into your vault. Details in Development.

License

MIT