thedeck - 跨平台回合制卡牌游戏引擎

项目说明

<img src="demo/icon.png" alt="alt text" style="max-width: 96px; display: inline-block; : middle;">
<span style="display: inline-block; : middle; margin-left: 10px;">
<h1> The Deck</h1>
</span>

<b>🕹️ Mobile multiplayer offline card games aggregator 🚀</b>
<b>👨‍💻 Written 💯 in Dart and Flutter 🔨</b>

<i>The inspiration for “The Deck” came from a situation many of us ha. Imagine gathering with friends for a 游戏 night, only to realize that nobody has the necessary cards. Frustrating, right? This dilemma sparked the idea of le technology to create a solution.</i>

<p align="center">
<img src="demo/6.jpg" alt="alt text" style="max-width: 600px">
</p>

The primary goal of “The Deck” is to provide a user-friendly and cooperati 游戏 en for playing classic games that were usually played with cards on paper. One of the standout features of “The Deck” is its unique ability to assign one device as the “table” (a.k.a. deck). By placing this device in the middle of the group, all players can witness the real-time state of the cards. This adds a new level of immersion making it a truly capti experience.

<p align="center">
<img src="demo/2.jpg" alt="alt text" style="max-width: 600px;">
</p>

Gameplay

1. Select a game 📚
2. Connect to the room 🔗
3. Start game 🚀

<table>
<tr>
<td><img src="demo/3.jpg" alt="Image 3" style="max-width: 400px;"></td>
<td><img src="demo/4.jpg" alt="Image 4" style="max-width: 400px;"></td>
<td><img src="demo/5.jpg" alt="Image 5" style="max-width: 400px;"></td>
</tr>
</table>

Read more

* <b> ⚙️ How it works 👀: </b>
* Dev.to
* Medium
* PlantUML diagrams here - /documentation

Other

* Personal blog: 游戏 Night Just Got a Digital Upgrade: The Deck*
* getthedeck.com
* ProductHunt
* Hacker News
* Reddit

* 🍎 AppStore
* 🤖 PlayStore
* PlayStore Web

Contribute

Contribution is welcome 🤝

<b>If you contributed and build a new 游戏, ping me if you wish it to be released on the store markets.</b>

Flutter

Setup

Use FVM to manage Flutter SDK

* install fvm with brew
* Setup Flutter from pubspec fvm use x.y.z
* Read here: fvmrc
* run with f run

MR / Pull Request

Naming con, start commit description with:

* (FEAT) - feature
* (FIX) - bug fix
* (CHORE) - refactoring, updating dependencies, etc
* (TEST) - tests

Release

Android

* For App Store release ⭐️
* f build appbundle --release
* Fat APK with all ABI
* f build apk --release
* Upload file to Play store
* For split-abi APK testing
* f build apk --release --split-per-abi

iOS

* Archive for App store upload ⭐️
* f build ipa --release
* open file with Xcode, and upload
* IPA file to drag & drop into iphone:
* f build ipa --release --export-options-plist="/Users/igor.steblii/Projects/foundation_tone/ft_fe/build/ios/archi.xcarchive/Info.plist"

Common errors

* In case VS 代码 fail with missing Cocoapods
* * f clean + f pub get + Reload

* For normalize': Unicode Normalization not appropriate for ASCII-8BIT (Encoding::CompatibilityError)
* Run: export LC_ALL=en_US.UTF-8

* for wrong locale export LANG="en_US.UTF-8
* Run locale if there is any C, then run export LC_ALL=en_US.UTF-8

* For flutterfire script fails with "unhandle JSON exception"
* Download json/plist form Firebase and update in respecti ()

* iOS Device require permission to connect to local 网络, which cannot be access from 代码. To emulate access query local IP address
* Another way is to add permission to Info.plist to ask on app start:
* * <key>NSLocalNetworkUsageDescription</key>
* * <string>Access to the local 网络 required to create and connect to 游戏 rooms</string>

* For Error when reading 'lib/objectbox.g.dart': No such file or directory
* * Run: f pub run build_runner watch --delete-conflicting-outputs

Tools

To generate a new Redux template see scripts

License

This project is licensed under the terms of the MIT license.

技术栈

开发语言：Dart

项目类型：跨平台回合制卡牌游戏引擎

Star 数：762

功能特点

这是一套跨平台回合制卡牌游戏引擎，代码结构清晰，适合开发者学习游戏的客户端渲染、服务端逻辑、场景管理与资源加载。项目涵盖了游戏的核心玩法、界面交互、地图与角色系统等模块，对理解游戏开发的完整流程具有较高的参考价值。

从技术实现角度看，游戏项目的难点在于：游戏循环与状态管理、资源加载与渲染优化、客户端与服务端的协议同步、以及多平台适配。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C# / Unity / Godot 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再运行客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到游戏的核心玩法实现、场景与资源管理、网络协议设计、以及渲染优化等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了游戏项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整游戏项目的架构，对后续开发其他类型游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。