Card-Forge / forge

# ⚔️ Forge: The Magic: The Gathering Rules Engine
Join the **Forge community** on Discord!
---
## ✨ 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 Steps
### 📥 Desktop
1. **Latest Releases:** Download the latest version here.
2. **Snapshot Build:** For the latest development version, grab the `forge-gui-desktop` tarball from our Snapshot Build.
 - **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
- _(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. On the first launch, Forge will automatically download all necessary assets.
### 📱 iOS (early stage)
- Build the **IPA** according to Wiki
- No jailbreak needed, only developer mode and iOS 16-27
- Connect your device to a PC to self-sign and upload the app file, multiple tools exist e.g. Sideloadly
---
## 🎮 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 Mode
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.
---
## 💬 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 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:** | |
| **🍴 Forks:** | |
| **👥 Contributors:** | |
---
**📄