CalcStack

CalcStack Plugin Documentation

Are you tired of staring at endless lists of materials in tutorials, unsure of how many stacks, boxes, or items you actually need? This plugin was created just for you!

Features

CalcStack allows players to easily calculate the stack count of items in hand and the required number of boxes with a simple command. It supports custom stack sizes and can display the raw materials needed for crafting items along with their stacking requirements.

Key Features

- Automatic translation to Chinese - Automatically retrieves the stack count of items - Easily solves large quantity to unit conversion issues - Perfect estimation system - For example, 1x Log -> 4x Planks, automatically estimating maximum values like 2x Planks -> 1x Log, 3x Planks -> 1x Log, 6x Planks -> 2x Logs - Automatic unit conversion for raw materials - Highly customizable language files

Command Usage

``` /calculate <quantity> or /calculate <itemID> <quantity> ```

- <itemID>: The number of items to calculate. - <itemID>: The specific item ID (defaults to the item in hand). (Includes automatic ID completion)

You can also use the shorthand command `/calc`.

Example

Players can use `/calculate 500` to calculate the stack and box requirements for 500 items in hand, or use `/calculate diamond 500` to calculate the stack and box requirements for storing 500 specified diamonds.

Configuration File

Max Stack Size Setting

This setting is used to define the maximum stack size of items. If custom stack sizes are enabled, you can adjust the stack size as needed.

```yaml custom-stack-size: enabled: false # Enable custom stack size value: 64 # Maximum stack size ```

Chest Size (Number of Slots)

Set the number of slots in each chest. The default is 27 slots (standard chest size).

```yaml chest-size: 27 # Size of each chest (number of slots) ```

Language File

Usage Prompt

Displays the correct command usage.

```yaml usage: "§eUsage: /calculate <quantity> or /calculate <itemID> <quantity>" ```

Error Messages

Provides user-friendly error messages.

```yaml error: not_player: "§cThis command can only be used by players!" no_item_in_hand: "§cPlease hold a valid item, or specify the item ID in the command!" invalid_item: "§cInvalid item ID: {item}" invalid_number: "§cPlease enter a valid quantity!" ```

Calculation Result Display

Shows the stacking situation of items, remaining item count, required number of boxes, and other details.

```yaml result: header: "§a===== Calculation Result =====" item: "§bItem: {item}({translated_name})" quantity: "§bQuantity: {quantity}" stacks: "§bStacks: {stacks} groups ({stack_size} items/group)" remaining: "§bRemaining: {remaining} items" chests: "§bChests needed: {chests} (each chest has {chest_size} slots)" footer: "§a====================" ```

Raw Materials Display

Calculates the raw materials required for the item and their stacking needs.

```yaml ingredients: header: "§a===== Raw Materials =====" item: "§b- {ingredient}({translated_name}) - {quantity} items" stacks: " §7- {stacks} groups ({stack_size} items/group)" remaining: " §7- Remaining {remaining} items" chests: " §7- Chests needed: {chests} (each chest has {chest_size} slots)" ```

Feel free to customize the configuration and enjoy using CalcStack!