背包自动开启器

# TCG卡牌商店模拟器 | 自动拆包器

## 用途
这个脚本可以自动处理**TCG Card Shop Simulator**中当前需要手动抓取并打开任意数量卡包的繁琐操作。我预计游戏开发者可能会对开包流程的时机进行调整，比如增加选择开包数量的选项，而随着新功能的加入，这个脚本很可能会失效，因为它依赖于预测当前游戏的时机，并没有真正扫描游戏中的任何进程。不过，在游戏版本~~v0.34 v0.37~~ v0.38中，它仍然可以正常使用。

即使遇到稀有掉落也能正常运行，会暂停开卡流程。这个脚本让你无需在出现稀有卡时不断点击，并且在最后计算卡包总价值时故意设置了延迟，比实际所需时间稍长，以确保如果卡包中有多张稀有卡，不会破坏脚本的计时。你可以随意离开房间。

## 用法
要使用此脚本：
1. 打开 `config.ini` 文件：
   如果你的显示器分辨率不是 `1920 x 1080`，请将 `width` 和 `height` 的值替换为你显示器的值。
   如果新的开包游戏内速度未设置为最大值，则应将 `speed` 设置为 1。（10 是默认最大速度）
2. 可以直接运行exe文件，或下载[autohotkey](https://www.autohotkey.com/)并直接运行未编译的ahk脚本。
3. 打开一个箱子——按键盘上的 `1` 键开始单个箱子的开箱流程。（默认32）
3. 要打开多个箱子——按 `4` 或 `6` 可打开多个箱子/货架。（默认是2个货架或总共64包，每个货架32包）
   - `4` 每清空一个架子后，角色会向左移动，这意味着你必须**从最右边的架子开始**。
   - `6` 每清理完一个货架后，你的角色都会向右移动，这意味着你必须**从最左边的货架开始**。
4. 完成后，按 `3` 退出脚本，否则它会保持激活状态，并在你按 `1` 时触发。

手牌数量和每手牌组数可以在INI文件中设置，你可以用记事本等文本编辑器打开该文件。
# [示例：开2盒 - 4手8包](https://youtu.be/yAKYqAP0y3w)
[](https://youtu.be/yAKYqAP0y3w)


新卡会有稍长的延迟，因为自动开包遇到新卡时会直接停止翻牌，无论你开启了什么游戏设置，所以为了应对这一点，自v0.38起新增了以下功能，详见下方说明

#### APO v0.2 适用于游戏 v0.38

在config.ini中新增了通过`speed`变量实现快速开卡的支持，只需将`speed`设为10即可达到最快速度，设为1则为最低速度。目前仅测试并支持这两种模式，因此请将其视为切换功能，而非可调节的缩放功能。

为希望自动打开指定数量货架/箱子的玩家添加了新的按键绑定。详见用法说明。

现在通过像素检测来检查新卡牌，从而避免了需要考虑稀有卡牌延迟的问题。下面的演示在游戏内设置中以最高速度运行，并且在config.ini文件中将`speed`设为10。
   - 更新了提示信息以明确显示箱子编号。
    
你可以通过在文本编辑器中修改配置文件来自定义此脚本打开的卡包数量。默认情况下，它会处理四组八包，共计32包。

分辨率需要通过像素检测来处理，因此请在config.ini的`width`和`height`变量中填入你的显示器分辨率，默认设置为1080，但支持任意分辨率。注意：已在1440和1080下测试，只要保持16:9宽高比，预计不会出现问题。

## 游戏设置
为确保脚本正常运行，请确保在游戏中应用以下设置：

- **设置 > 游戏 > 开包 > 显示新卡**: *未勾选*
- **设置 > 游戏 > 打开卡包 > 自动下一张卡牌**：*已勾选*
- **设置 > 游戏 > 开包 > 速度**：将滑块拖到最右侧**  

## 配置
你可以通过修改`config.ini`文件中的数值来调整每次开启的卡包数量：
包数：每手牌包含的卡包数量（默认为8）。
- `handCount`：要处理的手牌数量（默认为4）。
新
- `boxCount`：要处理的箱子数量（默认按 `4` 或 `6` 键位时为 2 箱，每箱 4 手，每手 8 包（共 64）；按 `1` 键位时默认为 1 箱 32 包）
你可以通过修改 `config.ini` 文件中的以下数值，将工具提示和像素检测缩放调整为你的显示器分辨率：
- `height` : 更改为当前游戏所用显示器分辨率的垂直像素值（例如：1080p 默认值为 1920，1440p 为 2560，以此类推）
- `width` : 更改为当前游玩时显示器分辨率的宽度（例如1080p默认为1080，1440p为1440等）
你可以通过修改 `config.ini` 文件中下面的值来更改每场会话中卡包开启的速度：
- `speed`：用于控制是否将开包速度设为最高。10 是相对于游戏内滑块的最大速度，1 是正常或最低速度，即游戏 v0.38 补丁之前默认且唯一的速度。目前请将其视为开关。（仅设为 10 或 1）

## 自动开包器 - 发布信息
- v0 创建、调试并于 **2024-09-20** 发布。
- v0.1，适用于游戏版本`v0.37`，此脚本版本发布于**2024-09-23**。
   - 通过从开卡循环中移除活动游戏窗口焦点，解决了用户反馈的脚本性能不一致问题。
- v0.2，适用于**2024-09-24**补丁的游戏版本`v0.38`，此脚本版本发布于**2024-09-25**。
    - 为自动开包器新增了按键绑定，用于玩家移动、左移和右移，以便其能够处理用户在 config.ini 中定义的第 n 个货架/箱子。
    - 更新了提示信息，现在会显示当前已开启的箱子数量占用户设定的总开启箱数的进度。
    - ~~*开发中*~~ 已更新以支持 v0.38 的新快速开包设置，可通过 config.ini 中的用户自定义值进行控制。
    - 已更新缩放比例，以适配所有显示器，用于新稀有卡牌的像素检测