Skip to main content

Overview

SigmaTools is a comprehensive Minecraft server plugin that enhances gameplay by providing powerful, customizable utility tools. This page explains what the plugin does, why it matters, and what makes it unique.

What Does SigmaTools Do?​

SigmaTools adds four specialized tools to your Minecraft server, each with unique abilities that automate and enhance common gameplay tasks:

Core Tools​

  1. Pickaxe - Breaks blocks in a 3x3 area (9 blocks total) for efficient mining
  2. Axe - Automatically chops entire trees by detecting connected logs
  3. Bucket - Provides infinite water and lava placement without consuming the bucket
  4. Hoe - Automatically replants crops after harvesting for efficient farming

Why This Matters​

Traditional Minecraft tools require repetitive actions and manual work. SigmaTools automates these tasks while maintaining game balance through:

  • Durability systems - Tools wear out with use
  • Cooldown/charge systems - Prevents spam and maintains balance
  • Economy integration - Optional costs and rewards
  • Protection compatibility - Respects land claims and regions
  • Performance limits - Prevents server lag

Key Value Propositions​

For Server Administrators​

  • Easy Configuration - Everything is configurable via YAML files
  • Performance Optimized - Async operations and throttling prevent lag
  • Protection Compatible - Works with major protection plugins
  • Economy Integration - Supports Vault and CoinsEngine
  • Debug System - Comprehensive logging for troubleshooting

For Players​

  • Efficient Gameplay - Automate repetitive tasks
  • Visual Feedback - Action bar shows charges, durability, and economy stats
  • Fair Balance - Cooldowns and durability prevent abuse
  • Customizable - Admins can tune costs, rewards, and limits

For Developers​

  • Public API - Integrate SigmaTools into your plugins
  • Event System - Listen to tool usage, economy transactions, and more
  • Service Provider - Access via Bukkit ServicesManager

Supported Minecraft Versions​

SigmaTools supports Minecraft 1.17+ (Spigot/Paper). The plugin requires Java 17 or higher.

Dependencies​

Required​

  • Spigot/Paper 1.17+
  • Java 17+

Soft Dependencies (Optional)​

  • Vault - Economy integration
  • CoinsEngine - Alternative economy system
  • Lands - Protection integration
  • WorldGuard - Protection integration
  • GriefPrevention - Protection integration

The plugin works without these dependencies, but features that require them will be disabled.

Architecture Overview​

SigmaTools is built with a modular architecture:

SigmaToolsPlugin (Main)
├── ConfigManager (Configuration loading/validation)
├── ToolManager (Tool creation and identification)
├── CooldownManager (Charge system)
├── DurabilityManager (Durability tracking)
├── EconomyManager (Economy integration)
├── ProtectionManager (Protection plugin integration)
├── PerformanceManager (Performance limits and throttling)
├── DebugManager (Logging system)
└── MessageUtils (Message formatting)

Each manager handles a specific aspect of the plugin, making it easy to maintain and extend.

What Makes SigmaTools Unique?​

  1. NBT-Based Tool Identification - Tools are identified via PersistentDataContainer, not item names
  2. Charge-Based Cooldown - Multiple charges that recharge over time (not simple cooldowns)
  3. Cumulative Economy Tracking - Action bar shows cumulative costs/rewards over time
  4. Dynamic Performance Throttling - Automatically reduces performance when server TPS drops
  5. Comprehensive Debug System - Category-based logging for precise troubleshooting
  6. Item Binding System - Bind custom items (vanilla or ItemsAdder) to tools via GUI
  7. Public API - Full API for plugin developers to integrate

Use Cases​

Survival Servers​

  • Efficient resource gathering
  • Automated farming
  • Balanced economy integration

Economy Servers​

  • Configurable costs per tool use
  • Rewards for successful operations
  • Multi-currency support

Creative Servets​

  • Fast building with area tools
  • Infinite resources with bucket tool
  • Protection-compatible operations

Next Steps​