Navigation
Overview
Cockatrice is an free, open-source, multi-platform program for playing tabletop card games over a network.
Cockatrice’s features:
Lobby for finding games and chatting with other players
Deckbuilder
Replay function - automatically records all games to review later
Built-in keyboard shortcuts to manipulate cards, add counters, and track game phases
Easy to edit plaintext format for decklists
You can make a single player game to goldfish a deck, or create a local two-player game and control both sides to test a matchup
Pre-game:
In game:
Lobby:
Deckbuilder:
Installing Cockatrice
Download Cockatrice for free here:
Copy the Cockatrice and Oracle apps to your Applications folder. You don’t need the Servatrice app.
Open Cockatrice. The app will ask you if you want to update your card database. Press “No”.
(Mac users - by default the system will not let you open an app from an unregistered developer. Double click on the Cockatrice app and it will decline to open. Then go to System Settings → Privacy and Security, scroll down to the Security section and choose "Open Anyway".)
Download the Grand Archive card images
Download the Grand Archive card images and cards.xml here
Installing Grand Archive
In the menu bar, go to “Card Database → Open custom image folder”. Put the “Grand Archive” folder of card images here.
Then go to “Card Database → Open custom sets folder”. Put the “05.ga.xml” file here.
Navigate up one level to Cockatrice/ and place the “cards.xml” file there. (Note: if you already use Cockatrice for Magic, then skip this step and keep the old cards.xml file).
Navigate to Cockatrice/themes/ and place the “GA theme” folder there.
Quit and reopen the client.
In the menu bar, go to Cockatrice → Settings → Appearance and choose “GA theme” as the current theme.
(optional) If you also use Cockatrice for Magic:
If you’d prefer to only see Grand Archive cards, then go to “Card Database → Manage Sets”, disable ALL sets, then search for “Grand Archive” and re-enable only the Grand Archive sets.
Logging in
(If you just want to test decks on your own, you don’t need to register to the server or log in. Go to Actions → Start Local Game to start a test game.)
In the menu bar, go to Actions → Register to Server and register.
Go to Actions → Connect and log in to the Rooster Ranges server (default server).
After logging in, go to the Server tab and join the "Other Games" room.
If you’re looking for someone to play against, you can join the Grand Archive TCG discord and post in the Events → Looking For Game channel.
Playing and Controls
One minute guide to the controls and playing on Cockatrice: https://github.com/Cockatrice/Cockatrice/wiki/One-minute-game-guide
Play a card face down = Shift+Drag
Reveal a face down card to everyone = drag the card to the stack zone on left. Or Right Click → Turn Over.
Look at material deck = Control-1. Or Right Click on the field → Sideboard → View Sideboard. You can leave this window open during the game.
Select multiple cards at once = Shift, Click, Drag
Set life total = Command-L, or right/left click on your portrait to add/remove damage.
Roll a die = Command-I
Draw your opening hand = Command-M
Draw a card = Command-D
Go to end step = F10
Pass the turn = Command-Enter
When playing with cards with associated tokens (Fracturize, Herbs, Automatons, Powercell), you can Right Click on the generating card to quickly create them.
Crtl-G = duplicate the last created token
Decklist format for Cockatrice
Decklist.txt:
4 Hasty Messenger
4 Creative Shock
4 (maindeck card)
sideboard
1 Lorraine, Wandering Warrior, etc.
1 Grand Crusader’s Ring
1 Blanche, Sheltering Saint
1 (material deck card or sideboard card)
Capitalization doesn't matter, but punctuation does. Card quantities can be in parentheses - “(4) Zephyr” will work.
A line with the word “sideboard” (lowercase) separates your maindeck from the other cards. Both your sideboard and material deck cards should be placed after the “sideboard” line. The order of the cards in this section doesn’t strictly matter, but it will be easier to play if all your material deck cards are grouped together.
Any line preceded by a “#” is ignored. (e.g. you can include a “#Material deck” line the make the decklist easier to read)
Sideboard and Material Deck
Since the client was built for Magic, there's no way to separate your material deck and sideboard cards by default. To simplify looking at your material deck, at the beginning of the game you can open your sideboard (uncheck the “sort by name” box), then play the sideboard cards onto the board facedown by Shift + Clicking them. Then tap them and choose Right Click → "Toggle Normal Untapping" so that they don't get mixed up with other cards during the game.
For any suggestions/feedback/typos, you can message me @blackmetallic on Discord or leave a comment on this thread.
Enjoy!
If you also play Magic, be sure to check out Time Warp Dandân, a custom format I designed:
Addendum and Misc.
(If you just want to play the game, you can ignore this section)
How to edit the cards.xml:
To add new spoilers or other cards, add entries to the Grand Archive xml file in this format:
<card>
<name>Sabrina, Spirit of Water</name>
<set>PRX</set>
<tablerow>1</tablerow>
</card>
The tablerow code determines what zone the card is played to by default:
0 = back row - fractals, reservable objects
1 = middle row - champions, regalia, items, locations, phantasia
2 = front row - allies
3 = stack - actions, attacks
You can also add a <cipt>1</cipt> tag for items that enter the field rested (Luxera’s Map).
The <related>Fraysia</related> tag lets you define associated cards that appear in a card’s right click menu (for Gather Herbs, etc.).
Add an image with the card's name anywhere in the Cockatrice/pics/CUSTOM folder.
The name of the image must exactly match the card name in the xml file, including capitalization and punctuation, except that you don't need to include a colon (":") in any card image name.
If you have a batch of card images with unformatted names (e.g. downloaded from shoutatyourdecks.com card list), running this zsh script in the directory will intelligently capitalize the names (exceptions for "of", "with", etc):
for file in *; do mv "$file" "$(echo "$file" | awk '{for(i=1;i<=NF;i++) if(i==1 || i==NF || !($i ~ /^(the|a|an|and|but|or|nor|for|from|with|so|at|by|for|in|of|on|to|as|if|is|this|your|you|are|and|it|that|with|has|have|be|of|into|as|an|by)$/)) $i=substr(toupper($i),1,1) tolower(substr($i,2)); print}')"; done
i.e. attune with the winds.jpg → Attune with the Winds.jpg