Skip to content
tooomm edited this page Jul 1, 2023 · 19 revisions

Welcome to the Magic-Token wiki!

Helpful links:

Contributing:

See Contributing to the Cockatrice Tokens File

Documentation:

(First draft, complete file structure not covered yet)

  • The <reverse-related> element connects the a card to a current token. Main Case
    It lists a card or token, which the parent token can be created from - its source.

    That way Cockatrice can pick the information up and displays the correct token in the right-click menu of a card; Cockatrice will create a single copy of that token when clicked. This information is placed at the end of the token's <card> element and contains card names that create that particular token, as well as information about the created quantity.
    This is the most-used case as it allows to link external cards/token creators to the in this file described token details:
    Token <---(reverse-related)--- Card

    <!-- right clicking the named card will allow you to create the parent token: "Goblin" -->
    <reverse-related>Goblin Instigator</reverse-related>
    • You can adjust the quantity of tokens that are created to match the card's need:
      <!-- no count / one token will be created -->
      <reverse-related>Goblin Instigator</reverse-related>
      
      <!-- count "2" / two tokens will be created -->
      <reverse-related count="2">Goblin Marshal</reverse-related>
      
      <!-- count "x" / dialog box will ask how many. The minimum number that Cockatrice will display is 1. -->
      <reverse-related count="x">Goblin Goliath</reverse-related>
      
      <!-- count "x=2" / dialog box will ask how many, 2 pre set as default -->
      <reverse-related count="x=2">Goblin Gathering</reverse-related>
    • Exclude certain token relations from the create All tokens option
      <!-- "exclude" defined / the all token option will only create 2 tokens, not 2+4 -->
      <reverse-related count="2">Grizzly Fate</reverse-related>
      <reverse-related count="4" exclude="exclude">Grizzly Fate</reverse-related>
      In contrast, the option will create 3 different tokens at once for Bestial Menace, Somberwald Beastmaster or Trostani's Summoner as none of their <reverse-related> entries are marked for exclusion.
    • If the card should attach itself to the token, use the attach attribute
      <!-- Living weapon examples. The token is a 0/0 germ -->
      <reverse-related attach="attach">Batterbone</reverse-related>
      <reverse-related attach="attach">Batterskull</reverse-related>
      <reverse-related attach="attach">Bonehoard</reverse-related>
      <reverse-related attach="attach">Flayer Husk</reverse-related>
  • The <related> element connects a token source to the created token, instead of the created token to the token source.
    This is only used where a token (e.g. an Emblem) creates another token:
    Token ---(related)---> Token

    <!-- right clicking the parent token will allow you to create the named token: "Kraken" -->
    <related>Kraken</related>

    There is no functional difference between correct usage of <related> and <reverse-related>, but some might consider it lazy.

Clone this wiki locally