# AutoSort 📦
一个强大且直观的箱子整理插件，它可以自动整理你的物品栏，具有可自定义的热键、多种排序类型和高级筛选选项，适用于 Minecraft 服务器。
## 🌟 核心功能
- **多种排序类型** - 按名称、类型、数量或稀有度排序
- **灵活的热键** - Shift+点击、右键点击和中键点击排序选项
- **智能堆叠** - 整理时自动堆叠相似物品
- **打开时自动整理** - 可选的在打开容器时自动整理选项
- **冷却系统** - 通过可配置的延迟防止垃圾排序
- **声音和视觉反馈** - 为排序操作提供可定制的声音和消息
- **世界限制** - 禁用在特定世界中的整理
- **基于权限** - 对谁可以使用功能进行细粒度控制
- **容器支持** - 支持箱子、桶、漏斗、发射器等
## 📋 命令
```
/autosort help - 显示帮助消息和可用命令
/autosort sort - 整理当前打开的箱子
/autosort info - 显示插件信息和设置
/autosort reload - 重新加载插件配置
/autosort toggle - 切换特定的插件设置
```
**可切换的设置:**
- `enabled` - 启用/禁用整个插件
- `shift-click` - 切换 shift-click 排序
- `right-click` - 切换右键点击排序
- `auto-sort-on-open` - 切换打开箱子时自动排序
**命令别名:** `/asort`, `/sort`
## ⌨️ 热键
- **Shift + 左键点击** (空槽) - 整理箱子内容
- **中键点击** (空槽) - 整理箱子内容
- **Shift + 右键点击** (箱子方块) - 从外部整理箱子
## ⚙️ 配置
```yaml
# AutoSort 插件配置
settings:
# 启用/禁用整个插件
enabled: true
# 排序类型: name, type, amount, rarity
sort-type: "name"
# 反转排序顺序
reverse-sort: false
# 排序方法
shift-click-sort: true # Shift + 左键点击空槽
right-click-sort: true # Shift + 右键点击箱子方块
command-sort: true # /autosort sort 命令
auto-sort-on-open: false # 打开箱子时自动排序
# 项目管理
stack-similar-items: true # 将相似项目堆叠在一起
move-to-top: false # 将排序的项目移动到顶部
# 冷却时间（以秒为单位）（防止垃圾）
cooldown: 1.0
# 声音和视觉反馈
play-sound: true
sort-sound: "BLOCK_CHEST_CLOSE"
send-message: true
# 世界限制
disabled-worlds: []
# 插件消息
messages:
sort-success: "&a箱子整理成功!"
no-permission: "&c您没有使用 AutoSort 的权限!"
reload-success: "&aAutoSort 配置已重新加载!"
cooldown: "&c请稍等片刻再进行排序!"
# 基于稀有度的排序优先级
rarity-priorities:
NETHERITE_BLOCK: 100
DIAMOND_BLOCK: 90
EMERALD_BLOCK: 85
GOLD_BLOCK: 80
# ... 更多项目
```
## 🔒 权限
```yaml
permissions:
autosort.*:
description: "完整的 AutoSort 权限"
default: op
children:
autosort.use: true
autosort.command: true
autosort.reload: true
autosort.use:
description: "使用排序功能的简单权限"
default: true
autosort.command:
description: "使用 AutoSort 命令的权限"
default: true
autosort.reload:
description: "重新加载 AutoSort 配置的权限"
default: op
```
## 💻 要求
- **服务器类型:** Paper, Spigot, 或 Bukkit
- **Minecraft 版本:** 1.21+ (API 版本 1.21)
- **Java 版本:** 21 或更高
- **依赖:** 无需任何依赖
- **支持的容器:** 箱子, 桶, 漏斗, 发射器, 放置器, 僵尸箱, 末影箱
## 🔧 安装
1. **下载** AutoSort 插件 jar 文件
2. **停止** 你的服务器
3. **放置** 插件到你的 `plugins/` 文件夹中
4. **启动** 你的服务器以生成默认配置
5. **定制** `config.yml` 以符合你的喜好
6. **重新加载** 使用 `/autosort reload` 或重启服务器
7. **测试** 游戏内的排序功能
## 🎮 使用示例
### 基本排序
```
/autosort sort - 整理你的当前打开的箱子
/autosort toggle enabled - 启用/禁用插件
/autosort info - 查看当前插件设置
```
### 热键使用
- 打开任何支持的容器 (箱子，桶等)
- **Shift + 左键点击** 空槽以进行排序
- **中键点击** 空槽以进行排序
- **Shift + 右键点击** 箱子方块从外部进行排序
### 高级配置
- 将 `sort-type` 设置为 "rarity" 以优先显示有价值的物品
- 启用 `auto-sort-on-open` 以进行自动排序
- 调整 `cooldown` 以防止排序垃圾
- 将世界名称添加至 `disabled-worlds` 以限制使用
## 📊 功能概览
### 排序选项
- **名称排序** - 字母顺序组织
- **类型排序** - 按材质类型分组
- **数量排序** - 按堆叠大小排序
- **稀有度排序** - 优先考虑贵重物品
- **反向模式** - 反转任何排序顺序
### 容器支持
- **箱子** - 普通箱子和陷阱箱子
- **存储块** - 桶，僵尸箱
- **红石容器** - 漏斗，发射器，放置器
- **特殊容器** - 末影箱等
### 智能功能
- **项目堆叠** - 自动合并部分堆叠
- **冷却保护** - 防止垃圾邮件造成服务器滞后
- **权限集成** - 安全访问控制
- **世界限制** - 在创造/出生世界中禁用
- **声音反馈** - 成功排序的音频确认
## 🛡️ 安全性和性能
- **轻量级设计** - 最小的服务器影响
- **线程安全操作** - 稳定的多人游戏使用
- **错误处理** - 优雅的故障恢复
- **权限检查** - 安全的命令执行
- **冷却系统** - 防止滥用和滞后
## 💝 支持开发
如果你觉得 AutoSort 有用：
- ⭐ **在 Modrinth 上对插件进行评分**
- 💬 **与其他服务器所有者分享**
- 💡 **建议未来更新的功能**
- 📝 **撰写评论以帮助其他人发现 AutoSort**
## 📞 支持和社区
- **问题:** 在 GitHub 上报告错误和请求功能
- **文档:** 完整的设置指南和示例
- **更新:** 发布常规更新，带来改进和新功能
- **兼容性:** 维护最新的 Minecraft 版本
---
❤️ 为重视组织力的服务器管理员制作 | 非常适合生存服务器、创造性建筑和存储管理