# DNF__GM_Tools

**Repository Path**: AsakuraYou/dnf__-gm_-tools

## Basic Information

- **Project Name**: DNF__GM_Tools
- **Description**: DNF GM Tool
根据能找到的资源 ，逐步慢慢写。尽量满足自己的操作习惯。
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 77
- **Forks**: 21
- **Created**: 2024-01-21
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AY.DNF.GMTool

[![Version](https://img.shields.io/badge/version-v1.2.20250114-blue.svg)](https://github.com/your-repo/dnf-gm-tool)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)](https://www.microsoft.com/windows)
[![Sponsor](https://img.shields.io/badge/sponsor-support%20us-pink.svg)](#-支持项目)

> 💖 **如果这个项目对您有帮助，请考虑赞助支持我们！** [点击查看赞助方式](#-支持项目)

## 📖 项目简介

AY.DNF.GMTool 是一个专为 Dungeon & Fighter (DNF) 私服设计的游戏管理工具，提供了丰富的GM功能，包括角色管理、邮件系统、任务管理、活动管理等核心功能。该工具基于 WPF + .NET 6.0 开发，采用现代化的UI设计，提供直观易用的管理界面。

## ✨ 主要功能

### 🔐 数据库连接管理
- 支持MySQL数据库连接
- 实时连接状态监控
- 自动重连机制
- 连接异常处理

### 👥 角色管理
- 角色信息查询和编辑
- 角色删除和恢复
- 角色转职和觉醒
- 装备等级管理
- 背包和时装清理

### 📧 邮件系统
- 发送游戏内邮件
- 支持道具和装备附件
- 批量邮件发送
- 邮件模板保存
- 图标预览功能

### 📋 任务管理
- 查看角色当前任务
- 完成任务操作
- 任务状态管理
- 道具型任务自动发放

### 🎯 活动管理
- 服务器活动配置
- 活动事件管理
- 活动参数设置

### ⏰ 泡点系统
- 定时发放D币/D点
- 可配置发放间隔和数量
- 实时发放日志

### 📊 在线管理
- 在线玩家查看
- 角色状态监控
- 批量操作功能

## 🛠️ 技术栈

- **前端框架**: WPF (.NET 6.0)
- **架构模式**: MVVM + Prism
- **ORM框架**: SqlSugar
- **UI组件**: HandyControl
- **数据库**: MySQL
- **日志系统**: NLog
- **依赖注入**: Prism IoC

## 📦 系统要求

- **操作系统**: Windows 10/11
- **.NET版本**: .NET 6.0 Runtime
- **数据库**: MySQL 5.7+
- **内存**: 至少 4GB RAM
- **硬盘**: 至少 100MB 可用空间

## 📚 使用说明

### 🔧 初始设置

#### Script.pvf 数据导入
- **首次使用必须进行Script.pvf导入**
- 导入数据包括：地下城、装备、道具、职业、任务
- 导入后的数据用于邮件、任务管理等功能
- 版本更新时需重新导入对应版本的Script.pvf

#### ImagePacks2 路径设置
- 设置游戏客户端的ImagePacks2目录路径
- 用于邮件物品图标显示
- 支持点击查询结果显示对应图标

### ⚠️ 重要注意事项

#### 超级功能
- SP充值、TP充值、QP充值需要重启服务后才能生效
- VIP相关功能暂未实现

#### 任务管理
- 完成任务需要将角色切换到其他角色中后，再刷新、完成所需要角色任务
- 非道具型任务，角色登录后即可完成
- 道具型任务会自动发放对应物品

#### 泡点功能
- 需要保持GM Tool开启状态
- 定时发放D币、D点，具体发放数量可设定
- 只支持分钟为间隔发放单位

#### 已知问题
- 部分版本选择人物闪退，因pvf文件格式不同导致兼容性问题
- 邮件物品图标可能有部分图标找不到的情况

### 更新说明

##### v1.2.20250114 - UI美化和性能优化版本

**🔧 核心修复**
1. **数据库连接稳定性修复**
   - 修复数据库连接立即断开问题
   - 移除连接成功后立即ping服务器的逻辑，避免连接建立时立即断开
   - 修复ping任务中错误的取消令牌变量引用
   - 完善断开连接时的任务清理逻辑
   - 改进数据库连接的异常处理机制

2. **内存泄漏修复**
   - 修复Task.Delay未使用await导致的CPU占用100%问题
   - 实现IDisposable接口，正确释放资源
   - 优化CancellationTokenSource的使用和释放
   - 改进后台任务的生命周期管理

**🎨 UI界面优化**
3. **界面美化和体验提升**
   - 全面美化界面样式，提升视觉效果
   - 修复角色列表选中后文字不可见问题
   - 修复功能tab鼠标悬浮时文字不可见问题
   - 改进连接按钮的启用/禁用状态显示
   - 加高标题栏高度，改善界面布局
   - 优化DataGrid选中行的视觉效果
   - 修复角色管理删除和恢复按钮大小不一致问题

4. **连接状态优化**
   - 连接成功后状态栏立即显示连接成功状态
   - 连接失败时显示明确的错误状态
   - 断开连接时状态栏正确更新
   - 连接状态颜色和文字提示更加直观

**⚡ 性能改进**
5. **代码质量和稳定性提升**
   - 优化SqlSugar配置，移除错误的连接参数
   - 改进连接管理机制，提高连接稳定性
   - 完善异常处理，避免程序崩溃
   - 实现标准的资源释放模式
   - 优化后台任务的异步处理

### 更新说明

##### v1.2.20251020

1. 主界面高度增加
2. 超级功能段位下拉选择bug修复
3. pvf解析兼容性调整（针对70S2A1的pvf暴露出的问题）
4. 增加解除每日角色限制功能

##### v1.2.20250114 - UI美化和性能优化版本

**🔧 核心修复**
1. **数据库连接稳定性修复**
   - 修复数据库连接立即断开问题
   - 移除连接成功后立即ping服务器的逻辑，避免连接建立时立即断开
   - 修复ping任务中错误的取消令牌变量引用
   - 完善断开连接时的任务清理逻辑
   - 改进数据库连接的异常处理机制

2. **内存泄漏修复**
   - 修复Task.Delay未使用await导致的CPU占用100%问题
   - 实现IDisposable接口，正确释放资源
   - 优化CancellationTokenSource的使用和释放
   - 改进后台任务的生命周期管理

**🎨 UI界面优化**
3. **界面美化和体验提升**
   - 全面美化界面样式，提升视觉效果
   - 修复角色列表选中后文字不可见问题
   - 修复功能tab鼠标悬浮时文字不可见问题
   - 改进连接按钮的启用/禁用状态显示
   - 加高标题栏高度，改善界面布局
   - 优化DataGrid选中行的视觉效果
   - 修复角色管理删除和恢复按钮大小不一致问题

4. **连接状态优化**
   - 连接成功后状态栏立即显示连接成功状态
   - 连接失败时显示明确的错误状态
   - 断开连接时状态栏正确更新
   - 连接状态颜色和文字提示更加直观

**⚡ 性能改进**
5. **代码质量和稳定性提升**
   - 优化SqlSugar配置，移除错误的连接参数
   - 改进连接管理机制，提高连接稳定性
   - 完善异常处理，避免程序崩溃
   - 实现标准的资源释放模式
   - 优化后台任务的异步处理


##### v1.1.20240307

1. 增加自动更新功能
   
   显示最后版本更新日志；增加自动更新器；主程序增加下载更新功能

2. 增加服务器在线状态检测（每一分钟一检）

3. 邮件物品未勾选红字时也带红字问题修复

4. PVF解析功能增加字符集检测兼容，解决导入乱码问题

5. 活动管理增加小白添加活动功能

6. 部分功能优化

7. 部分界面微调

未解决：部分版本选择人物闪退，因pvf文件格式与我手里的不一样，我没有对应文件无法做兼容。

##### v1.0.20240221

1. 任务管理界面微调

2. 邮件和超级功能消息自动清除时间间隔调整

3. 邮件内容保存可修改并自动记录

4. 增加NPK文件解析。目前只限于道具和装备（sprite_item_*命名的文件）

5. 邮件发送增加ImagePacks2路径设置

6. 邮件发送增加点击查询物品列表显示对应图片功能

7. 道具表、装备表扩展字段

8. 兼容Charac_Info表VIP字段因版本库不同，可能没有的情况

9. 邮件功能增加装备详情展示功能

10. pvf解析增加异常捕获

##### v1.0.20240215

1. 邮件及超级功能消息自动清除bug修复

2. 超级功能角色转职块增加职业觉醒信息显示

3. pvf职业解析去除特殊处理，保证pvf原职业数据的解读

4. 主界面账号信息增加觉醒信息显示

##### v1.0.20240212

    核心功能点基本都齐备，作为正式版进行发布

1. 增加pvf解析任务数据功能

2. 增加任务管理模块功能

3. pvf解析功能道职业、任务数据导入均在"其他"项中显示操作日志

4. 邮件、超级功能操作消息自动清除

5. 超级功能中增加清理时装、清理宠物功能

##### v0.0.20240204

1. pvf解析数据入库

2. pvf数据中文转为简体入库

3. 邮件查询功能改为查询pvf导入数据

##### v0.2.20240130

1. 登录信息表删除非必要字段，兼容85版本登录问题。其他版本暂未测

2. 增加数据库连接切换密码按钮

3. 邮件功能界面微调

4. 活动管理界面微调

##### v0.1.20240130

1. 邮件查询相关数据从Access库转移到Sqlite，尽可能兼容环境机无office等情况

2. 去掉Access数据库相关

3. 增加部分异常Log日志

4. 数据库空时间问题导致的程序异常修复兼容

##### v0.0.20240129

1. 增加活动管理功能

2. 修复部分发现的bug

##### v0.0.20240127

临时发布完整版，提供试用。

## 🤝 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

## 📝 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🆘 支持与反馈

如果您遇到问题或有建议，请：

1. 查看 [Issues](https://github.com/your-repo/dnf-gm-tool/issues) 页面
2. 创建新的 Issue 描述您的问题
3. 提供详细的错误信息和复现步骤

## 💖 支持项目

如果这个项目对您有帮助，欢迎通过以下方式支持我们：

### 💰 赞助支持

您的支持是我们持续改进的动力！请扫描下方二维码进行赞助：

<div align="center">

| 微信赞助 | 支付宝赞助 |
|---------|-----------|
| ![微信收款码](images/赞助-微信.jpg) | ![支付宝收款码](images/赞助-支付宝.jpg) |

</div>

### 🎁 赞助说明
- 所有赞助将用于项目的持续开发和维护
- 赞助者将在README中特别感谢（可选）
- 大额赞助者可获得技术支持优先权

### 🙏 其他支持方式
- ⭐ 给项目一个Star
- 🐛 报告Bug或提出建议
- 📢 分享给更多需要的人
- 💬 参与讨论和交流

## 🙏 致谢

### 特别感谢
感谢所有为这个项目做出贡献的开发者！

### 💎 赞助者列表
感谢以下赞助者的支持：

<!-- 赞助者列表 - 按赞助时间排序 -->
- **匿名赞助者** - 感谢您的支持！ 💖
- **开发者支持** - 感谢您的赞助！ 💖

> 💡 如果您希望匿名显示，请在赞助时备注"匿名"

### 🤝 贡献者
感谢所有提交代码、报告Bug、提出建议的贡献者！

## 📈 项目状态

[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)](https://github.com/your-repo/dnf-gm-tool)
[![Code Quality](https://img.shields.io/badge/code%20quality-A-green.svg)](https://github.com/your-repo/dnf-gm-tool)
[![Maintenance](https://img.shields.io/badge/maintained%3F-yes-green.svg)](https://github.com/your-repo/dnf-gm-tool)
[![Sponsor](https://img.shields.io/badge/sponsor-support%20us-pink.svg)](https://github.com/sponsors/your-username)

---

⭐ 如果这个项目对您有帮助，请给我们一个 Star！