Scanning Guide

You love this game so much you have decided to scan in your cards, here is what you need to do.

First you need to scan the cards. I recommend scanning at 200 dpi, this gives images approximately 500×700 pixels for each card. OCTGN supports either jpeg or png formats. jpeg images use less disk space and work fine, so go with this. Create a separate folder for each set (B, C, 1, 2 ….) as this will make things easier later on.

Since your character and role cards are landscape, make sure you rotate these before saving them so the text is horizontal.

Next you need to decide how you are going to import the cards into OCTGN. There are 3 options

  1. If you are a subscriber, you can drag the card image into the deck editor and OCTGN will associate the image with the card you are looking at.
  2. You can create an o8c file for each set. If you play other games on OCTGN you may well have seen these files, they contain all the cards for a set and can be imported into OCTGN in the game manager section using “Add Image Packs”
  3. You can copy the files directly into the OCTGN ImageDatabase

Option 1 is by far the easiest. If you are a subscriber, you don’t need to read any further, scan away and drag and drop!

If you are not a subscriber then you’ll need to understand how the image files are named as both option 2 and 3 will require each image file to be given a name based on the card’s unique ID in OCTGN. I’d suggest you take the time to create o8c files. It is only a tiny bit more work and will allow you to reinstall the images easily (say on another machine). Please don’t make these available to other people as the images are copyright and only for your personal use.

Take a look in your OCTGN install folder. There will be a sub folder called GameDatabase. If you have Pathfinder installed it will contain a folder named after this game’s unqiue ID.
d2e34ee4-b26b-4bcd-9709-1c45feb12d40
In there is all the information about the game, including a Sets Folder.

Each set has a unique ID too, these are

Feats O 33cae22c-0c82-4e9e-b465-2422ab40d45c
Rise of the Runelords B 0aa6cc74-098e-499a-a6c5-986129863e38
Character Add On C dcbbc244-a974-42d1-a143-972fa5123362
Promo P b37bbdfc-5106-4b17-a077-259f3405cda1
Burnt Offerings 1 605e17d5-2981-4ec0-b52d-db8ed165c14c
The Skinsaw Murders 2 bcee5a76-cb0a-4496-8629-96c4e39ed322
Hook Mountain Massacre 3 d27abd73-9c8a-4f08-8684-3cb387737870
Fortress of the Stone Giants 4 f833b378-6eaf-42e5-bcae-cbffc52ece7a
Sins of the Saviours 5 3130abb9-04d8-48b8-9a44-6fedbdad8bc0
Spires of Xin-Shalast 6 d646cb57-3914-4ff4-94c2-7788c0f63d93
Fan Made JRD add5338c-0278-488a-b99d-20417c8123c5

Since you are probably starting with the base set, take a look in the 0aa6cc74-098e-499a-a6c5-986129863e38 folder and open up the file set.xml in a text editor (notepad will do).
You will see that the Ambush card has a unique ID of 0edac356-1fba-42b6-bed1-9f43828c1041. When you scan that card you need to name it 0edac356-1fba-42b6-bed1-9f43828c1041.jpg

Looking further down in the set.xml file you will find the General Store, its ID is cef53dc0-1ddc-4984-955c-55c8c4d9478f however this is double side card you you’ll have a separate image for side A and side B.
The A side should be named cef53dc0-1ddc-4984-955c-55c8c4d9478f.jpg and the B side should be cef53dc0-1ddc-4984-955c-55c8c4d9478f.B.jpg. i.e. you just add an extra “.B” before the .jpg.

Once you have renamed all your cards you are ready to create the o8c files. These are actually zip files. To see the format, download the o8c file for the JRD scenarios here. Rename it to jrd.zip and open it up.

You will see a folder structure similar to the GameDatabase. The top level folder is named after the game ID, then there is a Sets folder containing the set IDs. These contain a folder called Cards and finally you’ll see the actual image files. You need to create this same folder structure on your machine and move the scanned and correctly named image files into the Cards folder. Finally zip up the top level folder (the one named d2e34ee4-b26b-4bcd-9709-1c45feb12d40) and rename the zip file as an o8c file
i.e. Pathfinder-B.o8c

You can now install this in the GameManager section of OCTGN (Add Image Packs)

If you don’t want to create an o8c file for each set, you can copy the renamed image files directly into the OCTGN/ImageDatabase folder. This has a similar structure to the GameDatabase so you should be able to navigate to the correct Cards folder and copy in your image files.

9 thoughts on “Scanning Guide

  1. Hello

    I am having trouble with getting the character cards to appears landscape in game, can you help? I have scanned them in Landscape, and within the deck editor they are the right way round, however in game they are portrait.. I assume there is something I am missing here. Can you help?

  2. Recently finished the scans and I ran into some weird quirks:

    1. When I wrote a python script that scrapes the xml sets files and gets all of the card name unique IDs, I found that a few card names don’t match the original cards:
    “Tsuto Kaikitsu” (Henchman 1) should be “Tsuto Kaijitsu”
    “Sihedron Medalion” (Loot various) has two spaces instead of one in at least one set (1, I think)
    “Habe’s Sanitorium” (Location 2) should be “Habe’s Sanatorium”
    “Skullripper” (monster 3) should be “Skull Ripper”

    2. It took me some confirming, but for some reason, the Character, Adventure, and Scenario cards all start with side .B.png up (this would be the side with the flavor text or the deck list for the character cards). Location cards are the only two-sided card that start front side up (the side without the flavor text), although I have not seen the adventure path card anywhere. Is this intentional? Was I supposed to treat the flavor text as side B for all but the location cards?

    Thank you for your work on this.

    • This is really great feedback – thank you for taking the time to write up your findings.
      We’ll ensure the typos are fixed in the next release.

      As for the side-A, side-B issues, I’m not sure at the time I wrote the original code I followed a consistent rule. It is not obvious which side of a card is A or B. At this point I think making changes would cause more harm than good so I’m going to propose we keep things the same.
      Next time I update the scanning guide I will add something to explain which side is which.

  3. I’m having the same problem. Scanning in landscape. Deck editor shows correct orientation but in game is in portrait. Can I have some help please?

    • This is an issue with a recent update to OCTGN, and isn’t anything you’re doing wrong. I’m working on a solution to this, but for now cards will all be shown in the same (portrait) size on the board. If you hover over the card, you should still see the card in the correct dimensions in the popup.

  4. I was wondering why you made the class decks all one set instead of a separate set for each. Doesn’t this cause problems with scanning the cards, as some of the cards are duplicated across several decks (i.e. the Bard B Cure looks different than the Cleric B Cure as the logos in the upper left differ)?

Leave a Reply

Your email address will not be published. Required fields are marked *