Forge: The Open-Source MTG Rules Engine with AI Opponents
An unofficial rules engine for the world's greatest card game.
At a glance
- What is it?
- Forge is a community-built, Java-based rules engine for Magic: The Gathering that runs AI-vs-player games across Windows, Mac, Linux, and Android without any subscription. It enforces rules locally and supports Commander, Draft, Sealed, and an Adventure mode with an overworld map.
- Who is it for?
- Forge is the right tool for MTG players who want rules-accurate AI opponents, Commander support, and full-format draft on hardware they already own, with no ongoing cost. It is not the right tool for rated online play against other humans or for tracking official format legality.
- Can I use it commercially?
- Yes, with conditions. GPL-3.0 is a copyleft licence: if you distribute software that includes it, you must release that software's source code under the same licence. Running it internally without distributing it does not trigger that obligation.
- Is it still maintained?
- Yes. The repository received new commits within the last day.
- What is it written in?
- Mainly Java, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on September 29, 2026, and from our analysis. They are not legal advice.
Editorial analysis
What Forge Solves for MTG Players Without an Official Alternative
Magic: The Gathering has two official digital platforms. Magic Online charges for cards directly, and MTG Arena restricts its format selection to Standard, Historic, and certain limited queues. Neither gives free access to Commander games or Cube draft against a rules-enforcing opponent. Forge fills that gap.
Forge is an unofficial open-source rules engine developed by community volunteers and is not affiliated with Wizards of the Coast. It targets four groups. First, players who want to test Commander decks against a rules-accurate AI before investing in paper cards. Second, developers who want to study or extend a Java-based card game engine. Third, Android users who cannot run Arena with acceptable performance. Fourth, players who want to run Cube drafts or older formats that official tools do not support.
The project has been in development for many years and continues to receive releases. The most recent stable release at the time of writing is forge-2.0.14, published on 2026-08-08.
Java Module Architecture: How Forge Enforces the Rules
The repository separates concerns across distinct Java modules. forge-core handles data models and card definitions. forge-game manages game state, the priority system, and the stack. forge-ai houses the computer opponent logic. forge-gui holds shared UI components that desktop and mobile builds both use. forge-gui-desktop targets the standalone desktop application. forge-gui-mobile and forge-gui-android cover the Android and early iOS builds. The adventure-editor module handles the overworld content for Adventure mode.
Card behavior is defined in scripts that describe each card's abilities. The rules engine reads those scripts and enforces triggered abilities, state-based actions, and the stack in the same order that the official rulebook specifies. This is what distinguishes Forge from tools like Cockatrice, which present a shared digital table but leave rule enforcement to the players. In Forge, the engine tracks and applies the rules itself, so a player does not need to know every ruling to play correctly.
Building from source requires Maven. The repository root contains a pom.xml that coordinates the multi-module Maven build.
Installing Forge on Desktop, Android, and iOS
Desktop installation requires Java 17 or later. The README instructs users to download the forge-gui-desktop tarball from the latest tagged GitHub release. For the most recent stable build, use the forge-2.0.14 release. For unreleased features, the daily-snapshots release tag provides a tarball that the build pipeline updates automatically.
The README says to extract the tarball into a new folder rather than over an existing installation, to avoid version conflicts. User data from previous versions is preserved during upgrades.
Android requires version 11 or later and at least 6 GB of RAM. The APK is distributed through the daily-snapshots release tag, not through the Play Store, so the README states that users must enable the Install unknown apps setting before the APK can be installed. On first launch, Forge downloads all required assets automatically.
iOS support is in an early stage. The README describes building the IPA from instructions in the project wiki, self-signing it with a tool such as Sideloadly, and loading it onto a device in developer mode. No jailbreak is required. iOS 16 through 26 is listed as supported. This path has several manual steps that the desktop installation does not require.
There is no apt, Homebrew, or pip package. The build system is Maven, and the main entry point for a build from source is the pom.xml at the repository root.
Gameplay Modes: Adventure, Quest, Draft, and Commander AI
Forge provides several single-player modes. Adventure Mode places the player on an overworld map, where they fight AI opponents and collect cards and items. Quest Mode removes the overworld and puts the player directly into card games, which the README describes as suited to focused, shorter sessions. Both modes pit the player against the built-in AI.
For competitive format practice, the AI can be used across Sealed, Draft, Commander, and Cube. These run entirely on the local machine without a network connection to any external server. The README also mentions online multiplayer as a feature, though the README does not document how to host or join a remote game.
The Adventure mode overworld content is editable through a separate adventure-editor module included in the repository, which means community members can author or modify the overworld scenarios.
The project releases under names like "The Hobbit Release" (forge-2.0.14) and "Marvel Super Heroes Release" (forge-2.0.13), suggesting that major releases are themed around particular card sets or expansions. The daily-snapshots tag provides continuous access to the most recent development build without waiting for named releases.
Known Limitations and Cases Where Forge Is the Wrong Choice
Forge is not an official Wizards of the Coast product. It does not connect to official card databases, which means newly released cards and rules errata must be manually scripted by community contributors. Some newer cards or unusual interactions may be incomplete or incorrect in the rules engine at any given time.
The Android requirement of 6 GB of RAM is a hard limit. Devices below that threshold will not run the application correctly, according to the README. Budget phones and older Android devices are likely excluded.
The iOS path requires developer mode, a manual build, and self-signing. This is a substantial hurdle compared to installing from an app store, and the README explicitly labels iOS support as an early stage feature.
Forge does not provide any mechanism for rated ladder play against other humans. Players who want competitive ranking or to play against the wider MTG player population need to use an official platform or a different tool. Forge's AI is good for rules practice and format exploration, but it is not a substitute for human opponents in competitive preparation.
For developers, the GPL-3.0 license requires that any distributed modification of Forge be published under the same license. Incorporating Forge's source into a proprietary product is not straightforward under that terms.
How Forge Compares to Cockatrice
Cockatrice is the other widely used open-source MTG tool. The two projects take opposite approaches. Cockatrice is a networked client for human-vs-human games. It provides a shared digital table where two players connect, see each other's cards, and apply rules manually by agreement. There is no engine enforcing state-based actions or the stack. Players need to know the rules themselves.
Forge enforces rules programmatically and provides an AI opponent. A player can run Forge with no second human and receive legally correct rule enforcement. The trade-off is that Forge's AI has limitations and plays at a fixed difficulty that is not comparable to a prepared human opponent.
The choice between them depends on the use case. A player who wants to test a deck's consistency or learn how specific interactions resolve should use Forge. A player who wants to play against other humans online should use Cockatrice or an official platform.
Maintenance History and GPL-3.0 License Implications
The repository is not archived. The last push was on 2026-09-27, and the project publishes named releases on a regular schedule: forge-2.0.14 arrived on 2026-08-08 and forge-2.0.13 on 2026-06-22. The build pipeline also produces daily snapshot builds, which indicates automated continuous integration.
The repository structure includes separate modules for Android and iOS in addition to the desktop application, which shows that the project actively targets multiple platforms rather than treating mobile as an afterthought.
The project is licensed under GPL-3.0. The practical meaning for end users is that Forge is free to use, modify, and distribute. For developers, distributing a modified version of Forge in any form requires releasing the source code of those modifications under GPL-3.0 as well. There is no commercial license option mentioned in the repository. Forge's explicit statement that it is not affiliated with Wizards of the Coast places responsibility for compliance with any applicable trademark or intellectual property considerations on the user.
Editorial conclusion
Forge is the right tool for MTG players who want rules-accurate AI opponents, Commander support, and full-format draft on hardware they already own, with no ongoing cost. It is not the right tool for rated online play against other humans or for tracking official format legality. Before installing on Android, verify that your device runs Android 11 or later and has at least 6 GB of RAM. Before using any Forge code in another project, check your obligations under GPL-3.0.
Frequently asked questions
Does Forge require a paid Magic: The Gathering subscription?
No. Forge is free, open-source software under GPL-3.0. It is not affiliated with Wizards of the Coast and does not connect to any official MTG servers or require any paid account.
What Java version does Forge require for desktop installation?
The README specifies Java 17 or later as a requirement. The application will not run correctly without it.
Can Forge play Commander format games against an AI opponent?
Yes. According to the README, Commander is one of the formats supported for AI play, alongside Sealed, Draft, and Cube.
Is Forge available on Android, and what are the minimum requirements?
Forge is available on Android 11 or later. The README states that at least 6 GB of RAM is required for smooth operation, and users must enable the Install unknown apps setting because the APK is not distributed through the Play Store.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/card-forge-forge)