PeggleCommunity/haggle

GitHub: PeggleCommunity/haggle

Haggle 是 Peggle Deluxe 与 Peggle Nights 的 Mod 开发SDK,通过对游戏内部框架函数的封装让开发者能从外部修改和扩展游戏逻辑。

Stars: 54 | Forks: 5

Haggle Mod SDK

适用于 Peggle Deluxe(即将支持 Peggle Nights)

## Haggle 是什么? ### Hack Peggle Haggle 将一系列 SexyFramework 和 Peggle 函数封装在 wrapper 中,以便从游戏外部调用,从而让你能随心所欲地对其进行操作! ## 著名用途 - [CrowdControl](https://crowdcontrol.live/item-pricing/Peggle) ## 安装说明 要运行 mod,你必须执行以下步骤: - [安装 Mod Loader](#installing-the-mod-loader) - [将 mods 安装到 mods 文件夹中](#installing-mods-into-the-mods-folder) ### 安装 Mod Loader 当 Haggle mods 与 Peggle 一起使用时,它们会在启动时被加载到 Peggle 的可执行代码中。 Mod Loader 负责执行此操作。请按照以下步骤安装 Mod Loader。 1. 获取 Mod Loader 的 `Haggle.exe` 文件: 1. 从 [Haggle Mod Loader Github 发布页面](https://github.com/PeggleCommunity/haggle-mod-loader/releases)下载,或者 2. 从 [mod-loader](https://github.com/PeggleCommunity/haggle-mod-loader/tree/main)编译。详情请参阅[编译](#compiling)部分。 2. 将 `Haggle.exe` 文件复制到你的游戏目录中。对于 Steam,请在游戏库中右键点击游戏,将鼠标悬停在“管理”上,然后点击“浏览本地文件”。
Steam Mod Folder Install Location - Image

3. 如果这是你第一次运行 Haggle,请先运行 Peggle.exe,然后在它打开的状态下运行 `Haggle.exe`。 4. 测试 Mod Loader 是否已正确安装。 1. 启动 Peggle 2. 如果一个名为“Haggle Mod Loader”的窗口随 Peggle 一起打开,则说明 Mod Loader 已正确安装! 此时,如果尚未安装任何 mods,Mod Loader 会提示找不到 mod 文件夹。 请参阅关于[将 mods 安装到 mods 文件夹中](#installing-mods-into-the-mods-folder)的部分。 ### 将 mods 安装到 mods 文件夹中 1. 在 Peggle 安装目录中创建一个名为“mods”的文件夹。 2. 将 `haggle-sdk.dll` 放在 `Haggle.exe` 和 `mods` 文件夹旁边。 3. 将 mod 的文件放入创建的文件夹中。mod 文件通常具有 `.dll` 或 `.asi` 扩展名。 4. 测试 mod 是否已正确安装。 1. 启动 Peggle,前提是已完成[安装 Mod Loader](#installing-the-mod-loader)这一步。 2. 在 Haggle Mod Loader 窗口中,Mod Loader 会识别它所加载的 mods。 确保上一步中放入“mods”文件夹的所有 mod 文件都已被加载。
成功加载 mod 的 Haggle Mod Loader - 图片

## 编译 ### 前置条件 - 安装了 C++ 模块的 Visual Studio 2022(或其他首选版本) ### 编译说明 - 运行 `generate.bat`(用于 `haggle-sdk.dll`),然后运行 `generate_example.bat`(用于 `example-mod.dll`)以生成 VS2022 工程 - 如果需要用于其他 IDE,请编辑 `generate.bat`,查看 [premake](https://premake.github.io/docs/Using-Premake/) 了解更多信息 - 编译 ## 贡献指南 请参阅[贡献指南](https://github.com/PeggleCommunity/haggle/blob/master/CONTRIBUTING.md)获取更多信息。 ## 依赖项 有关许可证信息,请查看 `./deps` 中相应的依赖文件夹,或查看它们的网站和/或代码库页面 - [MinHook](https://github.com/TsudaKageyu/minhook) - Hooking 库
标签:C++, Mod SDK, Peggle, 云资产清单, 数据擦除, 游戏, 游戏模组, 逆向工程