dev.malpercio.cards.set

A card set manifest, published by a provider. Declares every card in the set with its rarity, supply cap, and canonical art. Print runs are auditable against this record.

Details · record, key tid
Kindrecord
Record keytid
Authoritycards.malpercio.dev
Indexed

Record

record · key tid

Properties

cards

requiredarray
  • minLength: 1
itemsref
Reference

code

string

Short set code printed on every card, e.g. 'EXM'. Uppercase letters and digits. A reissue is a new set record with a new code, tied to the original by series.

  • maxLength: 8

createdAt

requiredstring · datetime
  • maxLength: 2048

name

requiredstring
  • maxLength: 128
itemsref
Reference

series

string

Optional grouping across sets (e.g. a season or year).

  • maxLength: 128

#attribute

object

Properties

name

requiredstring
  • maxLength: 64

value

requiredstring
  • maxLength: 256

#cardDef

object

Properties

artists

array

Who made the art. A provider's claim; see #credit.

  • maxLength: 8
itemsref
Reference

asset

requiredblob

Canonical full-size art, stored in the provider repo so the PDS retains the blob. assetCid is its fingerprint.

  • maxSize: 5000000
  • accept: image/*

assetCid

requiredstring · cid

CID of the canonical full-size art. Owner copies must match.

Free-form stats or flavor fields (team, position, year...).

itemsref
Reference

cardId

requiredstring

Stable identifier within this set, e.g. 'the_one_ring'.

  • maxLength: 64
  • maxLength: 2048

flavor

string

Flavor text shown with the card. Separate from description, which is reserved for rules text.

  • maxLength: 2000
  • maxGraphemes: 200

icon

blob
  • maxSize: 1000000
  • accept: image/*

iconCid

string · cid

maxSupply

integer

Hard cap on gives for this cardId across all variants. Omit for unlimited.

  • minimum: 1

number

integer

Collector number within the set, printed with the set code (e.g. EXM 001). Explicit so editing the cards array never renumbers cards.

  • minimum: 1

rarity

requiredref
Reference

title

requiredstring
  • maxLength: 128

Optional finishes (foil, etc). Each may carry its own cap and art.

itemsref
Reference

#credit

object

Attribution for card art. Give did when the artist has an atproto identity, name otherwise (at least one). Listed by the provider, so it is a claim until the artist confirms it from their own repo.

Properties

did

string · did

name

string

Display name, for artists without a DID or as a fallback.

  • maxLength: 256
  • maxGraphemes: 64

role

string

What they did, when a card has more than one artist.

  • maxLength: 64
  • knownValues: art | animation | color

#odds

object

Properties

rarity

requiredref
Reference

variantId

string

Weights this variant of cards of this rarity. Omit to weight the base cards.

  • maxLength: 64

weight

requiredinteger
  • minimum: 1

#packDef

object

Properties

asset

blob

Sealed pack art.

  • maxSize: 5000000
  • accept: image/*

assetCid

string · cid

Sealed pack art.

cardCount

requiredinteger
  • minimum: 1
  • maxLength: 2048

maxSupply

integer
  • minimum: 1

odds

array

Weights for drawing pack contents, per rarity and optionally per variant. Printings not listed have weight 0. Omit for a uniform draw over base cards.

itemsref
Reference

packId

requiredstring
  • maxLength: 64

title

requiredstring
  • maxLength: 128

#rarity

string
  • knownValues: common | uncommon | rare | legendary | unique

#variantDef

object

Properties

artists

array

Overrides the card's artists for this variant, e.g. when an animated version has its own animator.

  • maxLength: 8
itemsref
Reference

asset

blob

Overrides the card art for this variant.

  • maxSize: 5000000
  • accept: image/*

assetCid

string · cid

Overrides the card's assetCid for this variant.

flavor

string

Overrides the card's flavor for this variant.

  • maxLength: 2000
  • maxGraphemes: 200

icon

blob
  • maxSize: 1000000
  • accept: image/*

iconCid

string · cid

maxSupply

integer
  • minimum: 1

title

string
  • maxLength: 128

variantId

requiredstring

e.g. 'foil', 'signed'.

  • maxLength: 64

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • A specific printing of a Magic: The Gathering card

  • Issuance of a single card instance or a sealed pack, written by the provider into its own repo. This record is the root of a card's provenance chain and its at-URI is the card's permanent identity. The rkey is a TID, so issuance order is implicit.

  • org.swappulse.collectionEntry

    record not from the namespace authority

    A Pokémon TCG card held in a collector's digital binder. Mirrored from the SwapPulse CollectionEntry entity so collection state is portable across PDSs.