Best Practices¶

Recommended configurations and practices for running SigmaTools on your server.

Server Setup¶

Recommended Server Software¶

Paper - Recommended for best performance
Purpur - Good alternative with additional optimizations
Spigot - Minimum requirement, works but less optimized

Java Version¶

Java 17 - Minimum required
Java 21 - Recommended for best performance

Server Resources¶

RAM: 1GB+ recommended for larger servers
CPU: Multi-core recommended for async operations
Storage: SSD recommended for faster I/O

Configuration Best Practices¶

Performance Tuning¶

For Small Servers (< 20 players):

general:
  global-concurrent-cap: 25
  max-global-queue-size: 500
  max-player-queue-size: 50

tools:
  pickaxe:
    per-tick-limit: 15
    max-blocks-per-use: 50

For Medium Servers (20-50 players):

general:
  global-concurrent-cap: 50
  max-global-queue-size: 1000
  max-player-queue-size: 100

tools:
  pickaxe:
    per-tick-limit: 20
    max-blocks-per-use: 80

For Large Servers (50+ players):

general:
  global-concurrent-cap: 100
  max-global-queue-size: 2000
  max-player-queue-size: 150

tools:
  pickaxe:
    per-tick-limit: 25
    max-blocks-per-use: 100

Economy Configuration¶

Balanced Economy:

economy:
  enabled: true
  currency: "vault"
  costs:
    pickaxe: 5.0
    axe: 3.0
    bucket: 1.0
    hoe: 2.0
  rewards:
    pickaxe: 0.5  # Small reward per block
    axe: 0.3
    bucket: 0.1
    hoe: 0.2

Premium Tools (Higher Costs):

economy:
  enabled: true
  costs:
    pickaxe: 50.0
    axe: 30.0
    bucket: 10.0
    hoe: 20.0
  rewards:
    pickaxe: 0.0  # No rewards

Free Tools (No Economy):

economy:
  enabled: false

Protection Integration¶

Recommended Settings:

general:
  lands-integration: true
  worldguard-integration: true
  griefprevention-integration: true

tools:
  pickaxe:
    check-protection: true  # Always enable

Why: - Prevents griefing - Respects player claims - Maintains server security

Permission Setup¶

Default Players¶

# LuckPerms
/lp group default permission set sigmatools.use.* true

VIP Players¶

/lp group vip permission set sigmatools.use.* true
/lp group vip permission set sigmatools.bypass.cooldown true
/lp group vip permission set sigmatools.bypass.durability true

Moderators¶

/lp group moderator permission set sigmatools.admin true
/lp group moderator permission set sigmatools.use.* true

Administrators¶

/lp group admin permission set sigmatools.* true

Tool Distribution¶

Give Tools on Join¶

Use a plugin like EssentialsX or CMI:

# EssentialsX config
on-first-join:
  - give {player} sigmatools:pickaxe 1

Shop Integration¶

Sell tools in shops: - Use economy costs to balance - Make tools available but not free - Consider durability limits

Quest Rewards¶

Integrate with quest plugins: - Reward tools for completing quests - Use as milestone rewards - Balance with economy costs

World Configuration¶

Survival World¶

tools:
  pickaxe:
    worlds:
      - world
      - world_nether
      - world_the_end

Creative World¶

tools:
  pickaxe:
    worlds:
      - creative
  # Consider disabling economy in creative

Resource World¶

tools:
  pickaxe:
    worlds:
      - resources
    # Higher limits for resource world
    max-blocks-per-use: 100
    per-tick-limit: 25

Monitoring and Maintenance¶

Enable Debug Logging¶

For troubleshooting:

debug:
  enabled: true
  operations: true
  performance: true
  log-to-file: true

Regular Checks¶

Monitor Performance

/sigmatools debug queue
/sigmatools debug ops

Check Integration Status
```
/sigmatools debug info
```
Review Logs
Check logs/sigmatools-debug.log
Look for errors or warnings

Backup Configuration¶

Regularly backup: - plugins/SigmaTools/config.yml - plugins/SigmaTools/messages.yml

Common Server Types¶

Survival Server¶

Configuration: - Economy enabled with balanced costs - Protection integration enabled - Moderate performance limits - Durability enabled

Permissions: - All players can use tools - VIPs get bypasses - Admins have full access

Economy Server¶

Configuration: - Economy enabled with higher costs - Rewards for operations - Protection integration enabled - Performance limits for balance

Permissions: - Tools available in shop - VIPs get discounts - Admins bypass economy

Creative Server¶

Configuration: - Economy disabled - Higher performance limits - Durability disabled or high - Protection integration enabled

Permissions: - All players can use tools - No restrictions

PvP Server¶

Configuration: - Economy enabled - Protection integration enabled - Moderate limits - Durability enabled

Permissions: - Tools available but costly - VIPs get advantages - Admins have full access

Troubleshooting Tips¶

Server Lag¶

Reduce per-tick-limit
Reduce global-concurrent-cap
Enable dynamic throttling
Reduce max-blocks-per-use

Economy Issues¶

Verify economy plugin is working
Check currency setting matches plugin
Test with /balance or /coins
Check integration enabled in config

Protection Issues¶

Verify protection plugin is installed
Check integration enabled in config
Test permissions in protected area
Check server logs for errors

Security Considerations¶

Prevent Abuse¶

Enable Protection Integration
Prevents griefing
Respects claims
Set Reasonable Limits
Per-tick limits
Queue sizes
Max blocks per use
Use Permissions Wisely
Don't grant bypasses to everyone
Use groups for organization
Regular permission audits

Monitor Usage¶

Enable debug logging
Monitor performance metrics
Check for unusual activity
Review logs regularly

Next Steps¶

Configuration Guide - Detailed configuration
Troubleshooting - Solve issues
FAQ - Common questions