Installation & Updates¶

Complete guide for installing, updating, and maintaining SigmaTools on your Minecraft server.

System Requirements¶

Minimum Requirements¶

• Minecraft Version: 1.17+ (Spigot/Paper)
• Java Version: 17 or higher
• RAM: 512MB+ recommended
• Storage: 10MB for plugin files

Recommended Requirements¶

• Minecraft Version: 1.20+ (Paper recommended)
• Java Version: 17 or higher (21 recommended)
• RAM: 1GB+ for larger servers
• Storage: 50MB+ for logs and data

Installation Steps¶

Step 1: Download the Plugin¶

1. Go to the GitHub Releases page
2. Download the latest SigmaTools-X.X.X.jar file
3. Do not download source code or other files - only the JAR

Step 2: Install on Server¶

1. Stop your server (recommended, but not required)
2. Place SigmaTools-X.X.X.jar in your server's plugins/ folder
3. Start your server

Step 3: Verify Installation¶

When the server starts, you should see:

[INFO]   _____ _                         _______          _     
[INFO]  / ____(_)                       |__   __|        | |    
[INFO] | (___  _  __ _ _ __ ___   __ _     | | ___   ___ | |___ 
[INFO]  \___ \| |/ _` | '_ ` _ \ / _` |    | |/ _ \ / _ \| / __|
[INFO]  ____) | | (_| | | | | | | (_| |    | | (_) | (_) | \__ \
[INFO] |_____/|_|\__, |_| |_| |_|\__,_|    |_|\___/ \___/|_|___/
[INFO]            __/ |                                         
[INFO]           |___/                                          
[INFO] » Version: 1.0.3
[INFO] ✓ SIGMA TOOLS successfully enabled!

If you see errors, check the Troubleshooting section.

Step 4: Initial Configuration¶

The plugin creates default configuration files on first run:

• plugins/SigmaTools/config.yml - Main configuration
• plugins/SigmaTools/messages.yml - Message templates

Edit these files to customize the plugin. See the Configuration Guide for details.

Updating SigmaTools¶

Backup First¶

Always backup before updating:

1. Backup plugins/SigmaTools/ folder
2. Backup your server (recommended)
3. Note your current version

Update Process¶

1. Stop your server (recommended)
2. Delete the old SigmaTools-X.X.X.jar from plugins/
3. Place the new SigmaTools-X.X.X.jar in plugins/
4. Start your server

Post-Update Checklist¶

After updating, verify:

• Plugin loads without errors
• Configuration files are intact (they should be)
• Tools still work correctly
• Economy integration still works (if enabled)
• Protection integration still works (if enabled)

Configuration Migration¶

SigmaTools automatically handles configuration updates. However:

• New config keys are added with defaults
• Removed config keys are ignored (no errors)
• Changed config structure may require manual updates

Check the Changelog for breaking changes between versions.

Uninstallation¶

To completely remove SigmaTools:

1. Stop your server
2. Delete plugins/SigmaTools-X.X.X.jar
3. (Optional) Delete plugins/SigmaTools/ folder to remove all data
4. Restart your server

Note: Deleting the plugin folder will remove all configuration and data. Backup first if you want to keep settings.

Version Compatibility¶

Minecraft Versions¶

Server Software¶

Java Versions¶

Dependency Installation¶

Required Dependencies¶

None - SigmaTools works standalone.

Optional Dependencies¶

Install these for additional features:

Economy Plugins: - Vault - Economy integration - CoinsEngine - Alternative economy

Protection Plugins: - Lands - Land protection - WorldGuard - Region protection - GriefPrevention - Claim protection

Install these plugins before or after SigmaTools - the plugin will detect them automatically.

Installation Verification¶

Run these commands to verify installation:

# Check plugin version
/sigmatools debug info

# Check integrations
/sigmatools debug status

# Test tool creation
/sigmatools give pickaxe YourName

Common Installation Issues¶

Plugin doesn't load¶

Symptoms: Plugin doesn't appear in /plugins list

Solutions: - Check Java version: java -version (must be 17+) - Verify JAR file is not corrupted - Check server logs for errors - Ensure file is named correctly (not .jar.jar)

Configuration errors¶

Symptoms: Errors about invalid configuration

Solutions: - Delete config.yml and let plugin regenerate it - Check YAML syntax (use online YAML validator) - Ensure file encoding is UTF-8

Integration not working¶

Symptoms: Economy/protection features don't work

Solutions: - Verify dependency plugin is installed and enabled - Check integration is enabled in config - Check server logs for integration errors - Restart server after installing dependencies

Next Steps¶

• Configuration Guide - Configure all settings
• Quickstart Guide - Get started quickly
• Troubleshooting - Solve common issues