# Orewell
一个用于 Minecraft 服务器的插件，用于跟踪玩家挖掘的自然生成的方块数量，
排除玩家放置的方块。支持方块 ID 和标签！
我制作这个插件是为了跟踪玩家找到的钻石数量，
同时防止使用带有丝绸触摸和财富镐的镐子导致分数虚增。
作者：Vilgot
源代码：https://github.com/VilgotS/Orewell
## 功能
* 仅计算未由玩家放置的方块
* 使用 Minecraft 标签跟踪方块类别（例如普通钻石矿和深板岩钻石矿）。完整列表在此处。
* 使用 Minecraft 内置的计分板系统
* 易于使用的 YAML 配置文件
## 要求
* Minecraft 服务器：Paper 服务器（已测试）或兼容版本
* Java 版本：Java 21 或更高版本
* Minecraft 版本：1.21+ (已在 1.21.7 上测试)
## 安装
1. 下载最新版本 ([GitHub](https://github.com/VilgotS/Orewell/releases), [Hangar](https://hangar.papermc.io/VilgotS/Orewell), [Modrinth](https://modrinth.com/plugin/orewell)) 或从源代码构建
2. 将 Orewell.jar 文件复制到服务器的 plugins/ 目录
3. 启动你的服务器
4. 配置插件（请参阅下面的 [配置](#configuration) 部分）
5. 重新启动服务器以应用配置更改
## 配置
插件将在首次运行时在 plugins/Orewell/ 目录中创建一个 config.yml 文件。
### 默认配置
```yaml
# 按材质名称单独跟踪的方块
tracked-blocks:
- NETHER_QUARTZ_ORE
- ANCIENT_DEBRIS
# 要跟踪的标签（跟踪标签中的所有方块）
tracked-tags:
- diamond_ores
- gold_ores
- iron_ores
- coal_ores
- copper_ores
- emerald_ores
- lapis_ores
- redstone_ores
```
### 配置选项
大小写不重要。
#### tracked-blocks
要跟踪的单个方块类型的列表。使用 Bukkit/Spigot 中 Material 枚举名称的精确名称。[完整列表在此处](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)。
**示例：**
- DIAMOND_ORE
- DEEPSLATE_DIAMOND_ORE
- ANCIENT_DEBRIS
- BIRCH_PRESSURE_PLATE
#### tracked-tags
要跟踪的 Minecraft 标签列表。这允许您跟踪方块的整个类别。[列表在此处](https://mcreator.net/wiki/minecraft-block-tags-list)。
目前，包含斜杠 "/" 的标签（例如 "mineable/axe"）不起作用。
**常用矿物标签：**
diamond_ores - 所有钻石矿石变种（深板岩和普通）
gold_ores - 所有金矿石变种
iron_ores - 所有铁矿石变种
coal_ores - 所有煤矿石变种
copper_ores - 所有铜矿石变种
emerald_ores - 所有绿宝石矿石变种
lapis_ores - 所有蓝宝石矿石变种
redstone_ores - 所有红石矿石变种
**其他示例：**
logs - 所有类型的原木
enderman_holdable
**自定义标签：**
您也可以（理论上，未经测试）使用数据包中的自定义标签:
mypack:custom_ores - 数据包中的自定义矿物标签
## 使用
### 服务器管理
管理员可以使用标准的 Minecraft 计分板命令查看和修改玩家统计信息：
**示例：**
查看玩家的钻石矿石数量
```
/scoreboard players get PlayerName tag_diamond_ores
```
设置玩家的钻石矿石数量
```
/scoreboard players set PlayerName tag_diamond_ores 50
```
在玩家名称下方显示分数
```
/scoreboard objectives setdisplay below_name tag_diamond_ores
```
查看所有目标
```
/scoreboard objectives list
```
## 许可
Orewell 采用 GNU Lesser General Public License Version 3 的条款提供，
或（您有权选择）任何后续版本。请参阅 LICENSE.md 和 LICENSE.LESSER.md 以获取完整的许可文本。