finds.dev

Card-Forge/forge

An unofficial rules engine for the world's greatest card game.

View on GitHubHomepage ↗

★ 2,866JavaGPL-3.0updated Oct 2026

// the take

Forge is a from-scratch Java implementation of Magic: The Gathering's rules engine, bundled with desktop (Win/Mac/Linux), Android, and early iOS clients. It's for MTG players who want a free, offline-capable client with solo modes (Adventure, Quest) and AI opponents across draft, sealed, commander, and cube formats, not for developers looking for an embeddable rules library.

The scope of card coverage is the real achievement here — the forge-ai module alone has hundreds of ability-specific AI classes (CountersProliferateAi, MutateAi, DiscoverAi, etc.), meaning someone has hand-implemented AI behavior for most of MTG's genuinely weird card text, not just a generic stack-based resolver. It actually ships more than a dueling simulator: Adventure mode is a full single-player overworld game built on top of the rules engine. CI covers both PC and Android snapshot builds via GitHub Actions, and the project has been producing daily snapshots long enough to have real release infrastructure, not just a one-off student project.

Being an unofficial reimplementation of a commercial card game's full text and rules carries permanent legal exposure — WotC/Hasbro could request changes or a takedown at any point, and the project has no say in that. The one-Ai-class-per-ability design is a maintenance trap: every new card with novel wording needs a bespoke AI handler written by a contributor, so AI quality and new-set support will always lag behind actual MTG releases, and there's no way to tell from the repo how many cards currently have broken or missing AI logic. It's Java desktop/Android only — no web client, and the README gives no indication of a documented API for driving the engine programmatically, so it's not something you'd pull in as a library. Android needs 6GB RAM, which is steep for what's ultimately a card game, and the iOS build requires self-signing via third-party sideloading tools rather than anything resembling a normal install.

We read the README, the directory tree and a key source file in October 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,866
Forks
1,211
Language
Java
License
GPL-3.0
Last commit
31 Oct 2026

// nearby

If forge isn't quite it.

All repos →