# Apocalypse-SDK-Cpuls

**Repository Path**: Zephdyn/Apocalypse-SDK-Cpuls

## Basic Information

- **Project Name**: Apocalypse-SDK-Cpuls
- **Description**: 天启幻境II C++ 开发SDK
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-13
- **Last Updated**: 2025-11-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 天启幻境II_SDK_C++

#### 介绍
这是天启幻境II的C++ SDK，提供了一整套用于开发游戏插件和扩展功能的接口和工具。

#### 开发环境
- IDE: Visual Studio 2022 17.14.13
- Windows SDK版本: 10.0
- 平台工具集: Visual Studio 2022 (v143)
- C++语言标准: ISO C++ 20标准
- C语言标准: ISO C17 (2018)标准

#### 内置库
- cJSON-1.7.18: 用于处理JSON数据的解析和生成。

#### 文件说明
- `tqhj.sln`: 项目解决方案文件。
- `tqhj/`: 主要源代码目录，包含以下关键文件：
  - `api_Main.h`: API总入口头文件。
  - `app_info.cpp`: 插件初始化、事件处理等扩展功能实现。
  - `app_info.h`: 扩展辅助功能的头文件。
  - `code.h`: 提供Hex与字符串之间的转换功能。
  - `constant.h`: 定义各种常量和系统命令。
  - `gm.h`: 通用API函数声明，如发送消息、日志记录等。
- `cJSON.c` 和 `cJSON.h`: cJSON库的实现和头文件，用于处理JSON数据。
- `dll.h`: 定义DLL导出函数的接口。
- `dllmain.cpp`: DLL主函数，用于初始化和清理。
- `framework.h`: 包含Windows API的最小化头文件定义。
- `pch.cpp` 和 `pch.h`: 预编译头文件。

#### 主要功能
- **插件管理**：支持插件的初始化、退出和版本控制。
- **事件处理**：提供多种事件处理函数，如消息接收、命令修改、Web消息处理等。
- **消息通信**：支持向用户、群组或公会发送消息。
- **数据操作**：提供数据库句柄获取、数据读写等功能。
- **日志记录**：支持调试日志和普通日志的记录。
- **配置管理**：提供配置文件的读写功能。
- **JSON处理**：使用cJSON库进行JSON数据的解析和生成。

#### 使用示例
1. **插件初始化**：
   在`app_info.cpp`中，`Initialization`函数用于初始化插件，传入必要的路径和参数。

2. **事件处理**：
   `Event_accept`函数用于处理接收到的消息事件，可以根据消息类型进行相应的处理。

3. **发送消息**：
   使用`gm.h`中的`tq_SendMsg`函数向指定用户或群组发送消息。

4. **日志记录**：
   使用`tq_SendDeBugLog`或`tq_SendLog`函数记录调试信息或普通日志。

5. **JSON数据处理**：
   使用cJSON库提供的函数进行JSON数据的解析和生成。

#### 贡献指南
- 如果您有兴趣贡献代码，请确保遵循项目的编码规范和风格。
- 提交PR前请确保代码通过所有测试，并更新相关文档。

#### 许可证
本项目采用MIT许可证，请查看根目录下的`LICENSE`文件以获取更多信息。