In-Depth Description of SimpleCalculator
SimpleCalculator is a robust and lightweight Minecraft Spigot plugin designed to provide players with a high-performance calculator directly within the game. Compatible with Minecraft versions 1.21, 1.21.1, 1.21.3, and 1.21.5, this plugin allows users to perform mathematical calculations using simple commands, making it a versatile tool for educational purposes, in-game problem-solving, or just for fun. The plugin is built with efficiency in mind, leveraging the JavaScript ScriptEngine for complex calculations while offering a fallback mode for basic operations if the engine is unavailable.

Feature Highlights

• Commands: Supports three intuitive commands: /calculate, /calc, and /c, each performing the same calculation function but offering flexibility in command preference.
• Mathematical Operations: Handles core operations including addition (+), subtraction (-), multiplication (*), division (/), and exponentiation (^). Advanced functions like sin, cos, tan, and pow are also supported via the JavaScript engine.
• Tab Completion: Provides structured tab completion to guide users through the input format <number> <operator> <number>. For example, typing /c and pressing tab suggests numbers (e.g., "1"), then operators (e.g., "+"), and finally another number (e.g., "2").
• Customizable Configuration: Includes a config.yml file where administrators can customize settings such as:
  • Message prefix and colors for errors, results, and operations.
  • Decimal place formatting (enable/disable and set precision).
  • Option to toggle the use of the JavaScript engine for calculations.
  • Calculation timeout to prevent server lag from complex expressions.
• Permission System: Implements a permission node calculator.use (default: true) to control access to the calculator commands.
• Error Handling: Robust error handling with user-friendly messages for invalid expressions, division by zero, or syntax errors, along with server-side logging for debugging.
• Performance Optimization: Uses the JavaScript ScriptEngine for efficient calculation of complex expressions, with a fallback to basic parsing for environments where the engine is unavailable.

Important Information

• Dependencies: Requires a Spigot server running Minecraft 1.21 or a compatible version (1.21.1, 1.21.3, 1.21.5). The plugin uses the Spigot API and Java 17 for compilation.
• Limitations: Does not support sqrt or cbrt operations as they were explicitly removed per user request. Complex expressions beyond basic operations may require the JavaScript engine to be enabled.
• Usage Example: Typing /c 5 + 3 will return [Calculator] 5 + 3 = 8.00 (with default formatting). If the input is invalid, a clear error message is displayed, e.g., [Calculator] Invalid expression: Division by zero.

This plugin is ideal for server administrators looking to add a functional calculator to their Minecraft server, offering both simplicity for players and customization options for server owners.