## 一、产品概述
《奇迹宝石游戏机 V1.0》是一款基于 **奇迹 (MuOnline) 游戏账户体系** 开发的宝石主题积分游戏机客户端。程序以 12 种奇迹经典宝石 / 物品为转盘元素（祝福、创造、灵魂、大天剑、生命、玛雅、守护、大天奴、天魔杖、大天杖、洛克、再生），玩家使用奇迹游戏账号一键登录，直接以**账户点券作为游戏积分**参与押注、转盘、结算，输赢实时读写服务器数据库，真正做到 "账户即钱包、积分即点券"。
采用 C++ / Win32 / GDI+ 原生开发，纯客户端 + 数据库直连架构，无中间服务，单文件主程序，配套独立后台管理工具，开箱即用。
## 二、核心亮点
### 1. 奇迹账户直登，免注册免建号
登录框输入**奇迹游戏账号密码**即可进入游戏，无需单独注册本机账号：
- 通过 ODBC 直连奇迹服务器数据库（DSN：`MuOnline_YG75`），使用 `MEMB_INFO` 表校验账号密码（`memb___id` / `memb__pwd`），与游戏服务器完全同源；
- 登录成功即锁定该奇迹账号，游戏内所有积分操作都绑定此账户；
- 支持 "记住账号密码"，本地 INI 自动填充，方便快速进入。
### 2. 积分 = 奇迹账户点券，输赢实时同步
游戏积分直接对接奇迹商城点券字段 `CashShopData.WCoinC`：
- 登录时自动读取该账户当前点券作为游戏初始积分；
- 每次押注实时扣减、中奖实时增加，并通过 `UPDATE`/`INSERT` 即时写回数据库；
- 游戏运行期间每 500ms 自动与数据库同步一次积分、盈亏、设置与记录，防止数据不一致；
- 下机即走，积分与奇迹账户完全一致，无需人工对账。
## 三、游戏玩法
- **12 宫格转盘**：12 个奇迹宝石图标环形排列，鼠标悬停显示物品与倍率提示；
- **灵活押注**：每个物品可独立押注（每注 10 积分），支持押注倍率切换（1 / 10 / 20 / 30 / 40 等档位），一键拉高倍数；
- **转盘结算**：启动转盘后按概率权重抽取结果，命中已押物品即按对应倍率派彩，中奖红 / 绿高亮框与音效提示；
- **猜大小翻倍**：中奖后可进入 "猜大小" 小游戏，答对赢分翻倍，答错赢分清零，增加刺激度；
- **数据面板**：实时显示积分、赢分、总押注、盈亏四大统计卡片，右侧展示最近 10 条中奖记录（物品 + 金额）；
- **返奖率标识**：界面直接展示当前整体返奖率百分比。
## 四、后台管理（双端齐全）
表格
| 管理端 | 形式 | 能力 |
| --- | --- | --- |
| 游戏内后台（F2 冰蓝控制台） | 主程序内置窗口 | 12 个物品中奖权重滑杆（0–100）、独立倍率滑杆（1–50 倍）、整体返奖率（50%–200%）、押注倍率，一键保存 / 重置默认 |
| AdminTool 图形管理端 | 独立 EXE（GUI） | SQL 服务器连接配置（IP / 账号 / 密码 / 库名 / DSN 直连）、逐物品概率与倍数编辑、一键保存、公告内容发送 |
| AdminTool 控制台版 | 独立 EXE（字符界面） | 查看最近 20 条中奖日志（账号 / 物品 / 押注 / 中奖 / 时间）、设置物品中奖概率与倍数、查看当前全部设置 |
后台调整的参数（概率、倍率、返奖率、DSN）统一写入数据库 `FruitMachine_Settings` 表，所有客户端运行中自动热更新，无需重启。
## 五、技术架构与数据
- **开发语言 / 框架**：C++，Win32 SDK + GDI+ 绘图，纯原生界面，深色主题 + 转盘动画 + 粒子特效；
- **数据库**：SQL Server（奇迹服务器库），ODBC 驱动直连；
- **核心数据表**：
- `MEMB_INFO` —— 奇迹账号密码校验（登录鉴权）
- `CashShopData` —— 账户点券 `WCoinC`（游戏积分来源与写回）
- `FruitMachine_Settings` —— 概率权重、赔率、返奖率、DSN 等运行参数
- `FruitMachine_Records` —— 每一局的押注、中奖、积分流水日志
- **工程**：Visual Studio 2022（vc143），x64 Debug / Release 双配置，可直接编译出可执行文件；
- **资源**：12 个宝石图标（res/slot_0~11.png，缺图时自动回退彩色圆点）、多套中奖音效、应用图标。
## 六、运行环境
- Windows 64 位系统；
- SQL Server 数据库（奇迹服务端库 `MuOnline`）；
- 配置 ODBC 数据源 `MuOnline`（或通过后台管理端直接输入服务器 IP 连接）。
## 七、目录结构
```
游戏机源码V1.0/
├── FruitMachine/ # 主游戏程序（Win32 + GDI+）
│ ├── fruit_machine.cpp # 单文件主程序（登录 + 游戏 + 内置后台）
│ ├── res/ # 图标、宝石图片、音效
│ └── x64/ # Debug / Release 编译产物
├── AdminTool/ # 后台管理工具
│ ├── admin_gui.cpp # 图形版管理端
│ ├── admin.cpp # 控制台版管理端
│ └── AdminTool.exe # 已编译成品
├── FruitMachine.sln # VS2022 解决方案
└── fruit_machine.cpp # 主程序副本
