Getting Started

Drop the Kronos jar into your plugins/ folder and restart your server. Kronos will generate all config files automatically on first run.

───────────────────────────────────────────────────────────

File Structure

───────────────────────────────────────────────────────────

⚡ TPS Thresholds

Kronos has four alert levels. You can configure the TPS value for each one in config.yml:

Alerts are only sent after consecutive-samples-before-alert consecutive readings below the threshold, preventing false alarms from brief spikes.

───────────────────────────────────────────────────────────

Chunk Analysis

Kronos scores every loaded chunk based on what's inside it. Each type of problematic content adds to the score:

• Entities over threshold → +3 per entity
• Item drops over threshold → +4 per item
• Hoppers over threshold → +5 per hopper
• Comparators/Pistons/Observers → +2 each
• Probable mob farm detected → +50 flat bonus

Thresholds for each category are configurable in config.yml under the chunks: section.

Mob Farm Detection: A chunk is flagged as a probable farm if it exceeds your mob threshold AND a single mob type makes up 60% or more of the mobs in that chunk.

───────────────────────────────────────────────────────────

⚙ Auto-Actions

Edit autoactions.yml to define automated responses. Example:

Available Triggers

• TPS_BELOW — fires when TPS drops below threshold
• TPS_ABOVE — fires when TPS recovers above threshold
• SPIKE_DETECTED — fires when a lag spike is recorded
• ENTITY_COUNT — fires when a chunk exceeds entity threshold
• HOPPER_COUNT — fires when a chunk exceeds hopper threshold

Available Action Prefixes

• console: — runs a command as console
• broadcast: — broadcasts a message to all players
• alert: — sends a message to players with kronos.alerts permission

Available Placeholders in Actions: {tps}, {mspt}, {world}, {chunk_x}, {chunk_z}

───────────────────────────────────────────────────────────

Scheduled Scans

Edit schedules.yml to run automated reports at set times. Example:

Times use 24-hour HH:mm format. Actions can be any combination of REPORT_CONSOLE, REPORT_DISCORD, and REPORT_FILE.

───────────────────────────────────────────────────────────

Discord Setup

No bot required — Kronos uses webhooks only.

1. Go to your Discord channel → Edit Channel → Integrations → Webhooks → New Webhook
2. Copy the webhook URL
3. Paste it into config.yml

You can use separate webhooks for general alerts, daily reports, and spike reports, or point them all at the same one.

───────────────────────────────────────────────────────────

Web Dashboard Setup

Enable the web dashboard in config.yml:

Then visit http://your-server-ip:8080 in your browser. If binding to 127.0.0.1, you'll need an SSH tunnel or reverse proxy (nginx/Apache) to access it externally.

Tip: Leave username and password blank to disable authentication (not recommended for public servers).

───────────────────────────────────────────────────────────

Chunk Whitelist

Stand in a chunk and run:

Whitelisted chunks are excluded from chunk analysis and scoring. Useful for spawn areas, admin shops, or intentional farms you don't want flagged.

───────────────────────────────────────────────────────────

PlaceholderAPI

Install PlaceholderAPI and use these placeholders anywhere that supports PAPI:

───────────────────────────────────────────────────────────

❓ FAQ

Why does /sla stats show 20.00 TPS all the time?
Your server is running fine! Kronos caps TPS display at 20.00. Paper servers often report slightly above 20 internally which Kronos normalizes.

The web dashboard won't load externally.
By default it binds to 127.0.0.1 (localhost only). Change bind-address to 0.0.0.0 to expose it, and make sure your firewall allows the port. We recommend using a reverse proxy with HTTPS for security.

How do I reload Kronos without restarting?
Run /sla reload. This reloads config.yml, lang files, auto-actions, and the whitelist without a server restart.

Where are lag spike reports saved?
In plugins/Kronos/spikes/ as timestamped .txt files. You can also list them in-game with /sla spikes.

Can I translate Kronos into another language?
Yes. Copy lang/en.yml, translate it, save it as (e.g.) lang/de.yml, and set general.language: de in config.yml.