卡牌游戏作弊器

# 卡牌游戏作弊器 — 斗牌辅助 MOD

CardGameHacker 是《红色沙漠》斗牌小游戏的辅助 MOD，帮助你查看牌面、判断牌型并比较当前手牌与藏牌组合的获胜机会。

## 主要功能

- 用图片显示自己的手牌、藏牌和对手明牌；藏牌尺寸更小，便于区分。
- 显示当前牌型、胜率、平局率、败率和重比率。
- 藏牌只能替换尚未明牌的第二张手牌。面板显示换牌后的牌型及其胜率，供换牌时参考；不会自动换牌。
五张牌玩法「凑整数」单独显示：左边小藏牌，右边五张牌排成一行。凑得出来时，凑数的三张下面有标记，牌型写成「九点（凑 10）」；凑不出是荒。
凑整数的藏牌可以换四张没亮出来的牌里的一张，但换完必须比现在大。面板给出胜率最高的一种，并标出要换的那张；没有更大的换法时显示「—」。不会自动换牌。
- 显示各对手赢下底池的概率。双人局还会列出可能压过你的暗牌。
- 支持开启窥牌，查看对手未公开的手牌及当前牌局结果。
- 支持中文、英文、日文、韩文、俄文，以及自定义显示快捷键。

## 本次更新

- 调整为更紧凑的排版：顶部显示“我的牌”或“对手1、对手2、对手3”，下方依次展示小藏牌和两张手牌。
移除座位行和重复的牌面说明文字，不显示头像。
“最佳组合胜率”改为“换牌后牌型（牌型名）胜率”。只按替换第二张手牌后的那一个牌型计算；无藏牌或数据未就绪时显示“—”。
- 界面改回游戏画面内显示，导入 ASI 后按 Insert 即可打开，不用再单独运行界面程序。
- 支持五张牌玩法「凑整数」：按游戏顺序排五张牌，显示凑数标记、牌型和精确胜率。
- 隐藏界面、切换到其他程序或最小化游戏时暂停全量扫描。已经认出凑整数牌桌后，隐藏界面仍会轻量跟踪这一桌，以免错过发牌。

本版已完成本地构建和自动化测试，仍需实际游戏与不同 DMM 环境验证，暂不保证所有崩溃情况均已解决。

## 安装

只需要插件。界面画在游戏自己的画面上，不用再打开另一个程序。

1. 关闭游戏，在 DMM 中移除或禁用旧版插件，并退出旧的界面程序。
2. 将 **CardGameHacker-DMM.zip** 导入 DMM，启用并挂载其中的 `CardGameHacker.asi`。如果 ZIP 无法识别，可解压后单独导入 ASI。
3. 启动游戏，进入斗牌，按 **Insert** 显示面板。再按一次，或点击右上角关闭按钮，即可隐藏。

配置文件 `CardGameHacker.ini` 会在 ASI 旁边自动生成。更新时替换 ASI，已经改过的 ini 可以留着。窗口化、无边框和独占全屏都可以显示。若同时开着帧生成，界面会跳过那条画面，避免画错队列。

## 使用与更新

- 拖动顶部标题可移动窗口；底部可切换语言、开启窥牌和录制快捷键。
- 第一次进入牌桌可能需要稍等片刻才能识别。
- 界面随游戏加载，不需要每次重新打开一个程序。
- 更新时替换 ASI；可保留 ASI 旁边自己的 `CardGameHacker.ini`。
- 双人局换牌只替换第二张手牌，玩家和 NPC 相同。无藏牌或数据未就绪时，换牌后牌型和胜率显示“—”。
- 凑整数换的是四张未亮出的牌之一，而且换完必须更大。没赶上发牌、看不清哪张是明牌时，不显示换牌胜率。

## 遇到问题

如果按 Insert 没有面板，请确认 DMM 已启用并挂载这一版 ASI，并且游戏是重新启动后加载的。

反馈问题时请说明游戏版本、DMM 版本、窗口模式，以及“启动失败”“界面不显示”还是“按键后崩溃”，并附上 ASI 所在目录的 `CardGameHacker.log`。

## 英语

CardGameHacker 是《红色沙漠》中 Duo 小游戏的辅助 MOD。它可以帮助你查看卡牌、识别牌型，并比较当前手牌与备选组合的获胜几率。

### 功能

将你的手牌、备用牌和对手的可见牌以图像形式显示。备用牌显示得较小，以便于区分。
- 显示当前手牌类型以及胜利、平局、失败和再战率。
- 备用牌只能替换第二张尚未揭示的手牌。面板会显示换牌后的手牌及其胜率供参考，不会自动换牌。
- 五张牌游戏“凑十”有自己的一行：先是一小叠备用牌，然后是五张牌。当三张牌凑成10、20或30时，这三张牌会被标记，该手牌显示为“9点（凑十）”。无法凑成总点数的手牌即为爆牌。
在《凑十》中，后备牌可以替换四张未展示到桌面上的牌之一，且仅当手牌变得更强时才会替换。面板会显示胜率最高的替换方案并标记该牌。若无更强的替换方案，则显示“—”。它不会自动替换牌。
- 显示每位对手赢得底池的几率。双人模式还会列出可能击败你的隐藏牌。
- 可选揭示模式，用于查看对手未揭示的卡牌及当前回合结果。
简体中文、英语、日语、韩语和俄语，另加可自定义的显示快捷键。

### 新内容

- 紧凑布局：标题显示“我的牌”或“对手 1 / 2 / 3”，下方有一张较小的后备牌和两张手牌。
已移除座位行和多余的卡牌描述；无头像。
“最佳手牌获胜”现改为“换牌后（手牌）获胜”。仅使用替换第二张牌后形成的手牌。无备用牌或数据未就绪时显示“—”。
- 面板已重新在游戏内绘制。导入 ASI 并按 Insert 键；不再需要单独的程序界面。
- 支持凑十：桌上顺序五张牌，带有凑十标记、牌型名称和精确胜率。
- 当面板隐藏、切换到其他程序或游戏最小化时，暂停完整内存扫描。找到接龙牌桌后，隐藏面板仍会刷新那几个对象，因此不会错过发牌。

本地自动化检查已通过。实际游戏和DMM兼容性仍需测试；并非所有报告的崩溃都已确认修复。

### 安装

只需要安装插件即可。面板会绘制在游戏自身的画面上，无需打开其他程序。

1. 关闭游戏，在DMM中移除或禁用旧版插件，并退出所有旧的配套程序。
2. 将 **CardGameHacker-DMM.zip** 导入 DMM，然后启用并挂载 `CardGameHacker.asi`。如果 ZIP 无法识别，请解压后单独导入 ASI。
3. 启动游戏，进入双排模式，按 **Insert** 键显示面板。再次按 Insert 键，或点击右上角的关闭按钮，即可隐藏面板。

`CardGameHacker.ini` 会在 ASI 文件旁边自动生成。更新时，请替换 ASI 文件，如果你已经修改过 ini，请保留现有的 ini 文件。该面板在窗口化、无边框和独占全屏模式下均可使用。如果同时启用了帧生成，叠加层会跳过该路径，因此不会被绘制到错误的队列上。

### 用法与更新

- 拖动标题栏可移动窗口。在底部你可以切换语言、启用显示和录制热键。
第一次坐上牌桌时，可能需要一点时间才能认出来。
面板随游戏一同加载，无需每次单独启动程序。
- 更新时，替换ASI文件即可。你可以将你自己的`CardGameHacker.ini`保留在其旁边。
- 在双人模式中，换牌仅替换第二张手牌，对玩家和NPC均如此。当没有备用牌或数据尚未准备好时，换牌后的手牌和胜率显示为“—”。
- 在《凑十》中，换牌会替换四张未展示的牌中的一张，且仅在手牌变强时才会换牌。如果发牌时明牌未被看到，则不会显示换牌机会。

### 故障排除

如果按 Insert 键没有显示面板，请确认 DMM 已启用并挂载此 ASI，且游戏已重新启动，以便新插件能够加载。

报告问题时，请提供游戏版本、DMM版本、窗口模式，并说明是“启动失败”、“面板未显示”还是“热键后崩溃”，同时附上ASI目录中的`CardGameHacker.log`。