Skip to content

WatchTower · Behind the Scenes

How WatchTower Helps Keep Your Desk Organized

WatchTower is a simple tool that works quietly inside your NeoForge server. It keeps an eye on your server's health, checks for problems in the background, and provides an easy-to-use web dashboard right on your computer.

Pipeline

3 Active Stages

Lightweight

< 1% Overhead

Architecture Overview

The WatchTower Event & Triage Engine

[ COLLECT ]

01VitalsTPS, MSPT, heap, CPU, disk
02Logslatest.log tail, crash reports
03ModsJar inventory, checksums
04WorldChunk load, entity and item counts
05BackupsPresence, age
Background Checks Every Minute
Ready

About once a minute, WatchTower reviews logs, crash reports, mod lists, and game performance. It automatically sorts this information into helpful cards in your Fix inbox.

Now reading
Crash patterns
01 / 13
fingerprint · group + classify

[ ADVISE ]

01Fix inboxRanked issues, one next step each
Critical1
  • Disk runway under 14 days
Warning3
  • Entity spike near spawn
  • create - 14 log errors (missing item)
02Overview gradeHealth grade, needs-attention list
BNeeds attention
Server statuscreate-smp

Playable, but the desk has open work.

12 low-TPS minutes (24h). MSPT p95 86ms. Disk runway under 14 days.

03Insights trendsSchedule, load, and storage over time
Busy hours
20:00-21:00 UTC16.2 players62.4 ms MSPT
21:00-22:00 UTC14.8 players58.1 ms MSPT
19:00-20:00 UTC12.1 players48.2 ms MSPT
04Support packRedacted bundle to share
Support packReady
  • facts.jsonRedacted
  • brief.mdPlain English
  • evidence/Logs + crashes
Layer 101

Watching: Live stats while the game is running.

While Minecraft is running, WatchTower keeps an eye on things like how smoothly the game is working, how long each tick takes, how much memory and CPU the game uses, available disk space, and how many players are online. It also saves past data so you can see if current lag issues are worse than usual, even if you're not looking at it.

/// Designed to use very little resources and collect information quietly in the background.

Layer 202

Background Checks Every Minute

About once a minute, WatchTower reviews logs, crash reports, mod lists, and game performance. It automatically sorts this information into helpful cards in your Fix inbox, easily spotting script mistakes, duplicate files, and players who couldn't join.

/// It continuously monitors everything quietly in the background, unlike manual checks that take more time.

Layer 303

Support Packs: Ready-to-Use Redacted Snapshots

Need help from a mod creator or community Discord? With just one click, you can package your logs, crash reports, and system details into a secure, redacted zip file. Sensitive information like passwords, IP addresses, and tokens are automatically removed before you download or share it.

/// Focuses on safety and making it simple to get support from others.

First Time Use

Get Started in Less Than Two Minutes

When you turn it on for the first time, just go to http://your-ip:8787 in your web browser. A helpful step-by-step guide will show you how to set your admin password, make sure your server is found correctly, check your backup locations, and set up recommended security features.

INITIAL WIZARD URLPORT 8787
$http://your-server-ip:8787

Set password → Verify backup paths → Lock down security posture.

Integrations

Works smoothly with your favorite tools.

WatchTower improves your current server setup without making you change how you do things.

Spark Integration

Profiler

Reads .sparkprofile files and helps turn complicated CPU slowdown reports into simple steps you can take.

Modrinth Lookups

Catalog

Optional checks that compare your installed mods with available updates, check for conflicts, and show safety ratings.

How We Think About Things

Your Server. Your Choices.

WatchTower is here to help you. It suggests when to restart your server, points out settings that might cause problems, and warns you about risky updates to mods. But it will never make changes or take actions unless you give it the okay first.

[ Close ]

Ready to Make Your Server Run Smoother?

Just drop the file into the mods folder, restart your server once, and open port 8787. It's free, open for everyone, and made for NeoForge 1.21.x.

WatchTower is free and open-source software released under GPL-3.0. Minecraft is a registered trademark of Mojang Synergies AB. WatchTower is not affiliated with or endorsed by Mojang, Microsoft, or NeoForge.