# MCS-26112

**Repository Path**: linch-games/mcs-26112

## Basic Information

- **Project Name**: MCS-26112
- **Description**: MCS-26112棋牌游戏Uno客户端项目采用Godot开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-12
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCS-26112 移动端棋牌游戏项目

基于 Godot 4.5+ 开发的移动端棋牌游戏客户端，支持微信/抖音小游戏发布。

## 📁 目录结构说明

| 目录路径 | 说明 |
| :--- | :--- |
| **addons/** | 插件目录 (包含 `due_client` 网络库等) |
| **assets/** | 静态资源根目录 |
| ├── `art/` | 美术资源 (UI、背景、游戏元素) |
| ├── `audio/` | 音频资源 (BGM、音效) |
| └── `fonts/` | 字体文件 |
| **scenes/** | 游戏场景 (按模块划分) |
| ├── `loading/` | 加载界面 (启动入口) |
| ├── `lobby/` | 游戏大厅 (登录后主界面) |
| ├── `room/` | 房间/匹配界面 |
| ├── `game/` | 核心游戏对局场景 |
| └── `common/` | 通用 UI 组件 (弹窗、提示等) |
| **scripts/** | 全局脚本与逻辑 |
| ├── `autoload/` | 全局单例 (GameManager, NetworkManager) |
| ├── `network/` | 网络协议处理逻辑 |
| ├── `data/` | 静态数据配置 |
| └── `utils/` | 通用工具类 |
| **resources/** | 自定义资源文件 (.tres) |

## 🛠 开发规划

1.  **核心框架**
    *   [x] 基础目录结构搭建
    *   [x] 场景流程管理 (Loading -> Lobby -> Room -> Game)
    *   [x] 网络层集成 (`due_client` WebSocket)

2.  **功能模块**
    *   [x] **大厅模块**: 用户登录、信息展示、创建/加入房间
    *   [x] **房间模块**: 玩家列表同步、准备状态管理
    *   [ ] **游戏核心**: 发牌逻辑、出牌交互、结算流程
    *   [x] **断线重连**: 自动检测断线、重连机制、状态恢复

3.  **平台适配**
    *   [ ] 微信小游戏 SDK 接入
    *   [ ] 抖音小游戏 SDK 接入

## 🚀 快速开始

*   **主场景**: `res://scenes/loading/loading.tscn`
*   **网络测试**: 默认连接本地服务器 `ws://127.0.0.1:3553`，可在 `config.cfg` 中修改。

## 📖 核心功能文档

### 断线重连
客户端已实现完整的断线重连功能，详细说明请查看：[docs/RECONNECT.md](docs/RECONNECT.md)

**主要特性：**
- ✅ 自动检测网络断开
- ✅ 最多 5 次自动重连尝试
- ✅ 根据用户状态自动恢复场景（大厅/房间/游戏）
- ✅ 重连进度 UI 提示
- ✅ 支持用户取消重连

**重连窗口：** 断开后 5 分钟内必须重连，超时后状态会被清除。