# โ๏ธ Forge: The Magic: The Gathering Rules Engine
Join the **Forge community** on [Discord](https://discord.gg/HcPJNyD66a)!
[](https://github.com/Card-Forge/forge/actions/workflows/test-build.yaml)
---
## โจ Introduction
**Forge** is a dynamic and open-source **Rules Engine** tailored for **Magic: The Gathering** enthusiasts. Developed by a community of passionate programmers, Forge allows players to explore the rich universe of MTG through a flexible, engaging platform.
**Note:** Forge operates independently and is not affiliated with Wizards of the Coast.
---
## ๐ Key Features
- **๐ Cross-Platform Support:** Play on **Windows, Mac, Linux,** and **Android**.
- **๐ง Extensible Architecture:** Built in **Java**, Forge encourages developers to contribute by adding features and cards.
- **๐ฎ Versatile Gameplay:** Dive into single-player modes or challenge opponents online!
---
## ๐ ๏ธ Installation Guide
### ๐ฅ Desktop Installation
1. **Latest Releases:** Download the latest version [here](https://github.com/Card-Forge/forge/releases/latest).
2. **Snapshot Build:** For the latest development version, grab the `forge-gui-desktop` tarball from our [Snapshot Build](https://github.com/Card-Forge/forge/releases/tag/daily-snapshots).
- **Tip:** Extract to a new folder to prevent version conflicts.
3. **User Data Management:** Previous playersโ data is preserved during upgrades.
4. **Java Requirement:** Ensure you have **Java 17 or later** installed.
### ๐ฑ Android Installation
- _(Note: **Android 11** is the minimum requirement with at least **6GB RAM** to run smoothly. You need to enable **"Install unknown apps"** for Forge to initialize and update itself)_
- Download the **APK** from the [Snapshot Build](https://github.com/Card-Forge/forge/releases/tag/daily-snapshots). On the first launch, Forge will automatically download all necessary assets.
---
## ๐ฎ Modes of Play
Forge offers various exciting gameplay options:
### ๐ Adventure Mode
Embark on a thrilling single-player journey where you can:
- Explore an overworld map.
- Challenge diverse AI opponents.
- Collect cards and items to boost your abilities.
### ๐ Quest Modes
Engage in focused gameplay without the overworld explorationโperfect for quick sessions!
### ๐ค AI Formats
Test your skills against AI in multiple formats:
- **Sealed**
- **Draft**
- **Commander**
- **Cube**
For comprehensive gameplay instructions, visit our [User Guide](https://github.com/Card-Forge/forge/wiki/User-Guide).
---
## ๐ฌ Support & Community
Need help? Join our vibrant Discord community!
- ๐ Read the **#rules** and explore the **FAQ**.
- โ Ask your questions in the **#help** channel for assistance.
---
## ๐ค Contributing to Forge
We love community contributions! Interested in helping? Check out our [Contributing Guidelines](CONTRIBUTING.md) for details on how to get started.
---
## โน๏ธ About Forge
Forge aims to deliver an immersive and customizable Magic: The Gathering experience for fans around the world.
### ๐ Repository Statistics
| Metric | Count |
|----------------|-------------------------------------------------------------|
| **โญ Stars:** | [](https://github.com/Card-Forge/forge/stargazers) |
| **๐ด Forks:** | [](https://github.com/Card-Forge/forge/network) |
| **๐ฅ Contributors:** | [](https://github.com/Card-Forge/forge/graphs/contributors) |
---
**๐ License:** [GPL-3.0](LICENSE)
