Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
New Users Guide
This guide will teach you the basics on how OCTGN works, so that you can start playing games stress-free!
Introduction to OCTGN
OCTGN is a community-driven, open-source card game engine capable of playing many different types of games.
File Types Associated with OCTGN
Game packages have the file extension
.o8g. These files define the rules of the game and provide OCTGN with all the necessary information and file assets to handle that game. Things like card text, sets/expansion data, markers, player groups, game documents, fonts, and game scripting are all provided by this file.
OCTGN does not come pre-installed with any games. Nowadays, most games are organized into Game Feeds -- URLs you can subscribe to via the Games Manager which contain many different games for you to install. Game developers can upload new versions of games to their Game Feeds, and OCTGN will be able to detect these updates and automatically update your games for you!
Please note that most games do not come bundled with card images. Most game developers provide Card Image Packages (see below) which contain the images. You can find more information about a game and its resources in the Games Manager listing for that game.
Card Image Package (.o8c)
Card Image Packages have the extension .o8c. These files contain images for the cards in the Game Package, and can be installed via the Games Manager. Most games have a Proxy template which will automatically generate proxy images if there are no images installed for a card. It is usually up to the game's developer to determine how these image packs are made available to players.
Deck Files (.o8d)
OCTGN uses the .o8d Deck file format to store the contents of decks. The .o8d deck file can be associated with OCTGN in Windows, and doing so will quickly launch the OCTGN Deck Editor to display that deck.
Finding and Installing Game Packages
Game Packages are normally found in Game Feeds. These are special URL links to OCTGN game packages hosted online. OCTGN includes a few built-in feeds already; to add a new games feed, simply click the "New Game Feed" button in the Games Manager, and enter the URL in the popup window (along with a name to display).
Selecting a Game Feed in the drop-down menu will display the games available in this feed. Simply select the game you wish to install and an "Install" button will appear. This will install your game.
All games installed through a Game Feed will automatically update when you load OCTGN, if a new version is available.
Changing OCTGN's Directory
Some games require a large amount of hard drive space for all the card images. If you want to change the directory that OCTGN installs the Game/Set Plugins to, you may do so by clicking
Options and changing the
Data Directory option. You will need to restart OCTGN for this to take affect.
OCTGN features its own dedicated server for hosting and joining games. You'll need to create an account and log in to access the server. Once logged in, you can browse to the Custom Games tab to view currently open games. You can also click the "Host Game" button to host your own game.
You can find many OCTGN players in our OCTGN Discord server, found here: https://discord.gg/Yn3Jrpj