# MinecraftEnchantCalculator

**Repository Path**: liihoo/minecraft-enchant-calculator

## Basic Information

- **Project Name**: MinecraftEnchantCalculator
- **Description**: 我的世界附魔计算器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-17
- **Last Updated**: 2025-08-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 我的世界附魔计算器
我的世界附魔计算器是一款基于 Avalonia 框架开发的跨平台 - 平台桌面应用，专为《我的世界》玩家设计，用于精确计算附魔书与物品的最优合并方案，帮助玩家以最低经验成本获得理想的附魔效果。
### ✨ 核心功能
- 智能合并计算：自动规划多个附魔书与物品的最优合并顺序，降低总经验消耗
- 冲突检测：实时检测附魔之间的互斥关系（如保护与火焰保护不可共存）
- 成本分析：精确计算合并过程中的总经验成本和单次最大经验消耗
- 步骤可视化：清晰展示每一步合并操作，包括参与物品、结果及消耗
- 灵活配置：支持自定义附魔等级、物品类型，实时更新计算结果
### 🚀 技术亮点
- 采用 MVVM 架构模式，使用 CommunityToolkit.Mvvm 实现清晰的关注点分离
- 基于二叉树算法优化附魔合并顺序，确保成本最低
- 使用 Avalonia 框架实现 Windows、Linux、macOS 跨平台支持
- 依赖注入设计，便于单元测试和功能扩展
- 数据驱动架构，所有游戏数据通过 JSON 配置文件管理

### 📥 安装指南
#### 预编译版本
1. 访问项目[Releases](https://gitee.com/liihoo/minecraft-enchant-calculator/releases)页面下载最新预编译包。

#### 各平台安装步骤
##### 1. Windows 系统
1. 确认已安装.NET 6.0+ 运行时
2. 下载 `MinecraftEnchantCalculator-Win-x64.zip`
3. 解压到任意目录
4. 双击运行 `MinecraftEnchantCalculator.exe` 即可启动

##### 2. Linux 系统
1. 确认已安装.NET 6.0+ 运行时（可通过 `dotnet --version` 验证）
2. 下载 `MinecraftEnchantCalculator-Linux-x64.tar.gz`
3. 解压文件：`tar -zxvf MinecraftEnchantCalculator-Linux-x64.tar.gz`
4. 进入解压目录：`cd MinecraftEnchantCalculator-Linux-x64`
5. 赋予执行权限：`chmod +x MinecraftEnchantCalculator`
6. 运行程序：`./MinecraftEnchantCalculator`

##### 3. macOS 系统
1. 确认已安装.NET 6.0+ 运行时
2. 下载 `MinecraftEnchantCalculator-macOS-x64.zip`
3. 解压文件：`tar -zxvf MinecraftEnchantCalculator-macOS-x64.zip`
4. 进入解压目录：`cd MinecraftEnchantCalculator-macOS-x64`
5. 赋予执行权限：`chmod +x MinecraftEnchantCalculator`
6. 运行程序：`./MinecraftEnchantCalculator`

##### ⚠️ 常见问题
- **启动报错"找不到.NET运行时"**：请重新检查是否已安装.NET 6.0+ 运行时，或尝试重启电脑
- **Linux系统依赖缺失**：除.NET运行时外，需额外安装：`sudo apt install libgtk-3-0 libx11-6`（Ubuntu/Debian）
- **macOS验证失败**：在「系统设置-隐私与安全性」中手动允许应用运行

#### 源码编译
```bash
# 克隆仓库
git clone git@gitee.com:liihoo/minecraft-enchant-calculator.git

# 进入项目目录
cd MinecraftEnchantCalculator

# 编译项目（需要.NET 6 SDK或更高版本）
dotnet build -c Release

# 运行应用
dotnet run --project MinecraftEnchantCalculator -c Release
```
### 📖 使用教程
1. 选择物品：从左侧物品列表中选择需要附魔的工具、武器或防具
2. 初始附魔（可选）：勾选物品本身已有的附魔属性及等级
3. 添加附魔书：在附魔书列表中选择需要合并的附魔，设置相应等级
4. 开始计算：点击 "计算" 按钮，系统将自动生成最优合并方案
5. 查看结果：右侧面板将展示详细的合并步骤、总消耗及单次最大消耗
### 📊 数据说明
应用程序的所有游戏数据均存储在Assets/ItemJson目录下的 JSON 文件中：

- Items.json：包含所有可附魔物品的基础信息
- Enchantments.json：定义所有附魔的属性（最大等级、乘数等）
- Applicables.json：记录物品与附魔的适用关系
- Conflicts.json：定义附魔之间的冲突规则

这些文件可根据游戏版本更新进行手动修改，以适应不同版本的附魔机制。

### 🔧 开发指南
#### 项目结构
```plaintext
MinecraftEnchantCalculator/          # 项目根目录
├── Abstractions/                    # 抽象接口定义
├── Assets/                          # 游戏数据文件
│   └── ItemJson/                    # 游戏数据JSON文件
├── Attach/                          # Avalonia 附加属性
├── Converters/                      # 数据转换器
│   ├── Json/                        # JSON数据转换器
│   └── Xaml/                        # XAML数据转换器
├── Core/                            # 核心功能实现
├── Data/                            # 程序数据定义
│   ├── Entity/                      # 游戏实体模型
│   └── Table/                       # 数据表结构
├── Enums/                           # 枚举类型
├── Models/                          # 数据模型
├── Resources/                       # AXAML资源文件
│   ├── DataTemplate/                # AXAML数据模板
│   └── Styles/                      # AXAML样式
│       └── MainWindow/              # 主窗口样式
├── ViewModels/                      # MVVM视图模型
│   └── Windows/                     # 窗口视图模型
│       └── MainWindowComponents/    # 主窗口组件
└── Views/                           # 界面视图
    └── Windows/                     # 窗口界面
```
#### 贡献指南
1. Fork 本仓库
2. Star 本仓库

#### 📄 许可证
不限制任何使用规则
#### 💬 反馈与支持
- 报告问题：请在GitHub Issues提交
- 功能建议：欢迎通过 Issue 或 Pull Request 提出

如果觉得这个工具对你有帮助，别忘了给项目点个⭐哦！