# BlackUtils
**版本:** 1.0-SNAPSHOT
**作者:** BlackDev
**API 版本:** 1.21
BlackUtils 是一个多功能的 Minecraft 插件，提供了一系列必备的命令，以增强服务器管理并改善玩家体验。从便捷的玩家实用工具到世界管理，BlackUtils 为服务器管理员和玩家提供一站式解决方案。
## 功能
BlackUtils 添加了以下命令类别：
- **玩家命令:** 有助于玩家管理自己生命值和饥饿度。
- **工作站命令:** 快速访问各种工作站和实用方块。
- **世界命令:** 易于使用的命令，用于在世界中导航和传送。
- **实用工具命令:** 有趣且有用的工具，包括掷骰子和设置可穿戴的“帽子”的能力。
- **家园命令:** 一个全面的家园管理系统，提供设置、列出、重命名和删除家园的选项。
- **传送门命令:** 高效地设置、管理和传送到自定义传送门点。
## 命令和权限
每个命令都与一个权限节点相关联，允许服务器管理员根据需要自定义玩家访问权限。
### 玩家命令
- `/feed` - 补充饥饿值（权限：`blackutils.command.feed`）
- `/heal` - 恢复生命值（权限：`blackutils.command.heal`）
### 工作站命令
- `/anvil` - 打开铁砧 UI（权限：`blackutils.command.anvil`）
- `/craft` - 打开工作台 UI（权限：`blackutils.command.crafting`）
- `/enderchest` - 远程访问你的末影箱（权限：`blackutils.command.enderchest`）
- `/grindstone` - 打开砂轮 UI（权限：`blackutils.command.grindstone`）
- `/loom` - 打开织布机 UI（权限：`blackutils.command.loom`）
- `/smithingtable` - 访问锻造台 UI（权限：`blackutils.command.smithingtable`）
- `/stonecutter` - 打开石匠工作台 UI（权限：`blackutils.command.stonecutter`）
### 世界命令
- `/spawn` - 将玩家传送到服务器的出生点（权限：`blackutils.command.spawn`）
### 实用工具命令
- `/hat` - 将手中的物品戴在头上作为帽子（权限：`blackutils.command.hat`）
- `/dice` - 掷骰子以获得随机结果（权限：`blackutils.command.dice`）
- `/back` - 返回到上一个位置（权限：`blackutils.commands.back`）
### 家园命令
- `/home` - 传送到你设置的家园（权限：`blackutils.commands.home`）
- `/sethome` - 将你的当前位置设置为家园（权限：`blackutils.commands.sethome`）
- `/renamehome` - 重命名现有家园（权限：`blackutils.commands.renamehome`）
- `/listhomes` - 列出你保存的所有家园（权限：`blackutils.commands.listhomes`）
- `/delhome` - 删除家园（权限：`blackutils.commands.delhome`）
### 传送门命令
- `/setwarp` - 设置公共传送门点（权限：`blackutils.commands.setwarp`）
- `/warp` - 传送到传送门点（权限：`blackutils.commands.warp`）
- `/delwarp` - 删除传送门点（权限：`blackutils.commands.delwarp`）
- `/listwarps` - 列出所有可用的传送门（权限：`blackutils.commands.listwarps`）
### 消息命令
- `/msg` - 向其他玩家发送私人消息（权限：`blackutils.command.msg`）
- `/reply` - 回复收到的最后一条消息（权限：`blackutils.command.reply`）
## 安装
1. 从 [Modrinth](https://modrinth.com/) 下载 BlackUtils 的最新版本。
2. 将下载的 `.jar` 文件放入服务器的 `plugins` 文件夹中。
3. 重新启动服务器以加载插件。
## 配置
可以使用权限插件（如 LuckPerms 或 PermissionsEx）配置权限。根据服务器的需求自定义命令访问权限。
## 贡献
如果您想为 BlackUtils 做出贡献，请随时向我们的 GitHub 仓库提交拉取请求或提出问题，以建议新功能或改进。
## 许可
本项目使用 ARR 许可协议进行授权。