# CalcStack 插件文档
你是否厌倦了在教程中盯着无尽的材料列表，不确定你实际上需要多少堆叠、箱子或物品？ 这个插件就是为你创建的！
## 功能
**CalcStack** 允许玩家使用简单的命令轻松计算手中物品的堆叠数量以及所需的箱子数量。 它支持自定义堆叠大小，并且可以显示制作物品所需的原始材料及其堆叠要求。
### 主要功能
- 自动翻译成中文
- 自动检索手中物品的堆叠数量
- 轻松解决大数量到单位的转换问题
- 完美的估算系统
- 例如，1x 原木 -> 4x 木板，自动估算最大值，例如 2x 木板 -> 1x 原木，3x 木板 -> 1x 原木，6x 木板 -> 2x 原木
- 自动转换原材料 单位
- 高度可定制的语言文件
## 命令用法
```
/calculate <数量> 或 /calculate <物品ID> <数量>
```
- **<数量>**: 要计算的物品数量。
- **<物品ID>**: 特定物品的 ID（默认为手中的物品）。(包含自动 ID 补全)
你也可以使用简写命令 `/calc`。
### 示例
玩家可以使用 `/calculate 500` 来计算手中 500 个物品的堆叠和箱子要求，或者使用 `/calculate diamond 500` 来计算存储 500 个指定钻石的堆叠和箱子要求。
## 配置文件
### 最大堆叠大小设置
此设置用于定义物品的最大堆叠大小。 如果启用自定义堆叠大小，你可以根据需要调整堆叠大小。
```yaml
custom-stack-size:
enabled: false # 启用自定义堆叠大小
value: 64 # 最大堆叠大小
```
### 箱子大小（槽数）
设置每个箱子的槽数。 默认值为 27 个槽（标准箱子大小）。
```yaml
chest-size: 27 # 每个箱子的尺寸（槽数）
```
## 语言文件
### 用法提示
显示正确的命令用法。
```yaml
usage: "§e用法: /calculate <数量> 或 /calculate <物品ID> <数量>"
```
### 错误消息
提供用户友好的错误消息。
```yaml
error:
not_player: "§c此命令只能由玩家使用！"
no_item_in_hand: "§c请手持有效的物品，或者在命令中指定物品 ID！"
invalid_item: "§c无效的物品 ID: {item}"
invalid_number: "§c请键入有效的数量！"
```
### 计算结果显示
显示物品的堆叠情况、剩余物品数量、所需的箱子数量和其他详细信息。
```yaml
result:
header: "§a===== 计算结果 ====="
item: "§b物品: {item}({translated_name})"
quantity: "§b数量: {quantity}"
stacks: "§b堆叠: {stacks} 组 ({stack_size} 物品/组)"
remaining: "§b剩余: {remaining} 物品"
chests: "§b需要的箱子: {chests} (每个箱子有 {chest_size} 个槽)"
footer: "§a===================="
```
### 原始材料显示
计算制作物品所需的原始材料及其堆叠需求。
```yaml
ingredients:
header: "§a===== 原始材料 ====="
item: "§b- {ingredient}({translated_name}) - {quantity} 物品"
stacks: " §7- {stacks} 组 ({stack_size} 物品/组)"
remaining: " §7- 剩余 {remaining} 物品"
chests: " §7- 需要的箱子: {chests} (每个箱子有 {chest_size} 个槽)"
```
请随意自定义配置并享受使用 CalcStack 的乐趣！