mirror of
https://github.com/Card-Forge/forge.git
synced 2025-11-11 16:26:22 +00:00
106 lines
4.5 KiB
Markdown
106 lines
4.5 KiB
Markdown
# ⚔️ 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.
|
||
|
||
<img width="1282" height="752" alt="Shandalar World" src="https://github.com/user-attachments/assets/9af31471-d688-442f-9418-9807d8635b72" />
|
||
|
||
### 🔍 Quest Modes
|
||
Engage in focused gameplay without the overworld exploration—perfect for quick sessions!
|
||
|
||
<img width="1282" height="752" alt="Quest Duels" src="https://github.com/user-attachments/assets/b9613b1c-e8c3-4320-8044-6922c519aad4" />
|
||
|
||
### 🤖 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).
|
||
|
||
<img width="1282" height="752" alt="Sealed" src="https://github.com/user-attachments/assets/ae603dbd-4421-4753-a333-87cb0a28d772" />
|
||
|
||
---
|
||
|
||
## 💬 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)
|
||
<div align="center" style="display: flex; align-items: center; justify-content: center;">
|
||
<div style="margin-left: auto;">
|
||
<a href="#top">
|
||
<img src="https://img.shields.io/badge/Back%20to%20Top-000000?style=for-the-badge&logo=github&logoColor=white" alt="Back to Top">
|
||
</a>
|
||
</div>
|
||
</div>
|