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>

• : The number of items to calculate.
• : 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.

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).

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

Language File

Usage Prompt

Displays the correct command usage.

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

Error Messages

Provides user-friendly error messages.

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.

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.

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!