[MD]
# ItemsAdder多服务器同步工具
## 软件介绍
ItemsAdder多服务器同步工具是一款专为Minecraft服务器管理员设计的实用软件，用于解决多服务器环境下ItemsAdder插件资源同步的问题。通过此工具，您可以轻松地将一个主服务器上的ItemsAdder资源（如自定义物品、模型、材质等）同步到多个子服务器，确保所有服务器使用相同的资源配置。
## 主要功能
- **多任务管理**：可同时配置多个同步任务，分别针对不同的资源目录
- **实时同步**：支持文件的添加、修改和删除操作的同步
- **可视化界面**：直观的图形用户界面，易于操作和监控
- **详细日志**：提供详细的同步过程日志，方便排查问题
- **灵活配置**：可自定义源目录和多个目标目录
- **任务控制**：支持启用/禁用特定同步任务
## 系统要求
- Windows操作系统（Windows 7/8/10/11）
## 安装说明
1. 下载软件压缩包并解压到任意目录
2.双击开启软件
## 使用指南
### 首次使用
1. 首次启动时，软件会自动创建默认配置文件`sync_config.json`
2. 默认配置包含两个示例任务：同步ItemsAdder的contents和storage目录
3. 根据您的服务器环境修改这些示例任务或创建新任务
### 配置同步任务
1. 点击"添加任务"按钮创建新的同步任务
2. 输入任务名称（如"textures"、"models"等）
3. 选择源文件夹（主服务器上的ItemsAdder资源目录）
4. 添加一个或多个目标文件夹（子服务器上的对应目录）
5. 勾选"启用此任务"复选框以激活任务
6. 点击"确定"保存任务配置
### 执行同步
1. 在主界面查看已配置的任务列表
2. 确认需要执行的任务已启用（显示为绿色背景）
3. 点击"开始全部同步"按钮执行所有已启用的任务
4. 在右侧日志区域查看同步进度和结果
5. 如需中断同步过程，点击"取消同步"按钮
### 管理任务
- **编辑任务**：选中任务后点击"编辑任务"按钮
- **删除任务**：选中任务后点击"删除任务"按钮
- **启用/禁用任务**：选中任务后点击"启用/禁用"按钮
- **保存配置**：点击"保存配置"按钮将当前配置保存到文件
## 同步原理
本工具采用以下策略确保目标目录与源目录完全一致：
1. **删除多余文件**：删除目标目录中存在但源目录中不存在的文件和目录
2. **更新修改文件**：比较文件内容，更新已修改的文件
3. **添加新文件**：复制源目录中存在但目标目录中不存在的文件和目录
## 常见问题
### Q: 同步过程中出现"权限被拒绝"错误
A: 请确保软件有权限访问和修改目标目录。可能需要以管理员身份运行软件或调整目录权限。
### Q: 同步后服务器仍使用旧资源
A: 完成同步后，您可能需要在目标服务器上执行`/iareload`命令或重启服务器以应用更改。
### Q: 如何只同步特定类型的文件？
A: 当前版本不支持按文件类型过滤。建议通过合理组织目录结构，创建针对特定目录的同步任务。
## 配置文件说明
配置文件`sync_config.json`使用JSON格式存储所有同步任务信息。示例结构如下：
```json
{
"sync_tasks": [
{
"name": "contents",
"source": "D:/server1/plugins/ItemsAdder/contents",
"targets": [
"D:/server2/plugins/ItemsAdder/contents",
"D:/server3/plugins/ItemsAdder/contents"
],
"enabled": true
}
]
}
```
感谢使用ItemsAdder多服务器同步工具！
[/MD]
