Skip to main content

Best Practices

Recommended configurations and practices for running SigmaTools on your server.

Server Setup​

  • 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​

  1. Monitor Performance

    /sigmatools debug queue
    /sigmatools debug ops

  2. Check Integration Status

    /sigmatools debug info

  3. 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​

  1. Reduce per-tick-limit
  2. Reduce global-concurrent-cap
  3. Enable dynamic throttling
  4. Reduce max-blocks-per-use

Economy Issues​

  1. Verify economy plugin is working
  2. Check currency setting matches plugin
  3. Test with /balance or /coins
  4. Check integration enabled in config

Protection Issues​

  1. Verify protection plugin is installed
  2. Check integration enabled in config
  3. Test permissions in protected area
  4. Check server logs for errors

Security Considerations​

Prevent Abuse​

  1. Enable Protection Integration

    • Prevents griefing
    • Respects claims

  2. Set Reasonable Limits

    • Per-tick limits
    • Queue sizes
    • Max blocks per use

  3. Use Permissions Wisely

    • Don't grant bypasses to everyone
    • Use groups for organization
    • Regular permission audits

Monitor Usage​

  1. Enable debug logging
  2. Monitor performance metrics
  3. Check for unusual activity
  4. Review logs regularly

Next Steps​