Configuration Guide

2026-07-12

This page explains how MinerTrack configuration is structured and how to adjust it safely.

Main configuration files

MinerTrack uses three layers of configuration:

  • config.yml — global options, thresholds, logging, and webhook behavior.
  • Configuration/.yml — detection settings for each world profile.
  • language.yml — user-facing messages and formatting.

config.yml

The global file controls plugin-wide behavior. Typical topics include:

  • update checks
  • log file handling
  • webhook alerts
  • VL decay behavior
  • threshold commands

Example:

check_update: true
log_file: true

DiscordWebHook:
  enable: false
  WebHookURL: ""
  vl-required: 4

World-specific files

World profiles let you tune detection differently for each environment. You can define settings like:

  • rare ores to monitor
  • detection height limits
  • path tracking length
  • natural-detection behavior

language.yml

The language file changes visible messages such as:

  • kick messages
  • verbose notifications
  • prefixes and formatting

Tuning advice

  • Start with the defaults.
  • Change one area at a time.
  • Keep logging enabled while testing.
  • Avoid aggressive threshold changes until you understand the server's normal mining behavior.

Next step

See Commands for staff actions and Troubleshooting for common problems.