qequ/poker-night-hand-teller

# Poker Night Hand Teller 一款用于 **Poker Night at the Inventory** (Remastered) 的内存读取覆盖层模组，可实时显示你当前最佳的扑克牌型。  ## 功能 - 直接从游戏的 Lua 堆中读取你的底牌和公共牌 - 从所有可用的牌中评估你所能组成的最佳牌型 - 在游戏顶部的微型覆盖层中显示牌型名称（例如“Full House”、“Flush”、“Two Pair”） - 仅在游戏窗口处于活动状态时显示覆盖层 - 游戏退出时自动关闭 ## 下载 从 [Releases 页面](https://github.com/qequ/poker-night-hand-teller/releases)获取最新的 `HandTeller.exe`。无需安装，下载即可运行。 ## 杀毒软件说明 HandTeller 可能会被某些杀毒软件标记为可疑。这是一个**误报**。该模组使用 `ReadProcessMemory` 从游戏中读取卡牌数据——这与恶意软件使用的 Windows API 相同，因此会被标记。Poker Night 没有模组 SDK，因此读取内存是获取卡牌数据的唯一途径。源代码完全公开——你可以对其进行审计或自行从源代码构建。 ## 系统要求 - Windows 10/11 (x64) - .NET Framework 4.0+ (Windows 已包含) - Poker Night at the Inventory (Remastered) / `CelebrityPoker.exe` ## 用法 ### 方式 1：Steam 启动选项（推荐） 在 Steam 中右键点击游戏 > **属性** > **常规** > **启动选项**，添加： ``` cmd /c start "" "C:\path\to\HandTeller.exe" & %command% ``` 将 `C:\path\to\` 替换为 `HandTeller.exe` 的实际路径。这会随游戏自动启动模组，并在游戏退出时将其关闭。 ### 方式 2：手动启动 1. 启动游戏 2. 运行 `HandTeller.exe` 3. 等待约 20 秒以完成初始内存扫描 4. 开始玩扑克。覆盖层将显示你的最佳牌型。 ## 覆盖层控制 - **拖动** 覆盖层以调整位置 - **Retry** 重新扫描玩家锚点（如果卡牌未显示时使用） - **Restart** 从头开始进行完整重新扫描 - **X** 关闭模组 ## 工作原理 HandTeller 读取游戏进程内存，以遍历 Telltale 的 Lua 5.1 虚拟机堆。它通过 TString 扫描找到人类玩家对象，然后沿着指针链 `HumanPlayer > cHand > holeCards/cards > Card[rank, suit]` 读取你的卡牌，每 3 秒更新一次。 牌型评估器会尝试从你 2-7 张可用卡牌中进行所有 C(n,5) 组合，并返回最佳的牌型。 有关逆向工程过程的详细文章，请参阅 [博客文章](https://qequ.dev/posts/poker-night-hand-teller)。 ## 从源代码构建 需要 .NET Framework 4.0 C# 编译器（Windows 已包含）： ``` .\build.ps1 ``` 或手动执行： ``` C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe ` /out:HandTeller.exe /target:winexe /unsafe+ /platform:x64 ` /r:System.Windows.Forms.dll /r:System.Drawing.dll ` src\HandTeller\MemoryReader.cs src\HandTeller\AnchorNav.cs ` src\HandTeller\HandEvaluator.cs src\HandTeller\Overlay.cs ` src\HandTeller\Program.cs ``` ## 许可证 MIT

标签：Lua堆, ReadProcessMemory, Steam游戏, Windows API, 二进制发布, 作弊工具, 全屏助手, 内存扫描, 内存读取, 字典生成, 实时叠加层, 开源工具, 德州扑克, 手牌识别, 扑克之夜, 游戏Mod, 游戏修改器, 游戏辅助, 端点可见性, 覆盖层, 辅助软件