Home›Java›Mods›DeadServer
DeadServer
ModsJava

DeadServer

Java mod listed for Minecraft 1.21–26.x. Downloads from the MC Java Mods app on Android.

⬇ Download on Spigot
Why I made this plugin

My server was dead. Players joined, played for a few minutes, and left most didn't even last a day. I had no idea why. Was the TPS bad? Was the economy broken? Were new players dying too fast? I had zero data.

I built DeadServer because I needed answers. Real answers, not guesses. This plugin tracks everything: server performance, player retention, economy health, and new player experience. It calculates a multi-factor health score so you know exactly what's wrong and what to fix.

Now my server isn't dead anymore. Yours doesn't have to be either.


Features

Server Health (Multi-Factor)
Composite health score combining:
Code (Text):
  Health = Performance×35% + Economy×20% + Retention×30% + NewPlayer×15%
• TPS (1m/5m/15m), RAM (heap/non-heap), CPU load, tick time
• Entities, chunks, loaded worlds per server
• GC pause monitoring (count & total time)
• Color-coded health (green/yellow/red)​

Player Analytics
• Active players: Today, 7d, 30d
• Returning player rate: 7d/14d/30d
• Playtime distribution histogram (<1h, 1-5h, 5-20h, 20-100h, 100h+)
• Average session length
• Top 5 most active players
• Player profiles with retention prediction (HIGH/MODERATE/LOW/UNCERTAIN)
• Client brand detection (vanilla, fabric, forge, neoforge, quilt)​

Economy Monitoring
• Money supply & Gini coefficient with trend chart
• Top 1% wealth ownership
• Economy health labels (GOOD/FAIR/BAD/CRITICAL)
• Trend chart with Unicode bar visualization
• Vault integration​

Newbie Guardian
• Automatic detection of struggling new players
• Risk factors: starvation, high deaths, no chest/bed
• Retention prediction per player
• Staff alerts when new players are at risk​

Reports & Insights
• Daily server report (health, players, deaths, retention, economy)
• Why Players Leave analysis with factor breakdown
• Recently inactive player tracking
• Player comparison tool​

Discord Webhook
• Scheduled health reports (configurable interval)
• Real-time critical alerts (when health drops)
• Player milestone celebrations (10, 25, 50, 100, 250, 500, 1000 unique players)
• Color-coded embeds (green/yellow/red)​

Database
• SQLite (embedded, zero config)
• Automatic YAML → SQLite migration on first run
• Scheduled backups with auto-cleanup
• HikariCP connection pooling​


⌨ Commands

Code (Text):
/deadserver pulse          — Server health overview (aliases: sp)
/deadserver whyleave       — Player retention analysis (aliases: wpl)
/deadserver economy        — Economy health check (aliases: ed, ecodoctor)
/deadserver guardian [p]   — New player status (aliases: ng)
/deadserver player <name>  — Player profile & stats
/deadserver top [n]        — Playtime leaderboard
/deadserver compare <a> <b>— Compare two players
/deadserver report         — Daily server report
/deadserver reload         — Reload configuration
/deadserver                — Show all subcommands
Shortcut:
Code (Text):
/ds pulse
works as
Code (Text):
/deadserver pulse

Permissions

Code (Text):
deadserver.pulse          — /deadserver pulse        (default: true)
deadserver.whyleave       — /deadserver whyleave     (default: true)
deadserver.economy        — /deadserver economy      (default: op)
deadserver.guardian       — /deadserver guardian     (default: op)
deadserver.player.view    — /deadserver player       (default: true)
deadserver.player.compare — /deadserver compare      (default: true)
deadserver.top            — /deadserver top          (default: true)
deadserver.update         — Update notifications     (default: op)
deadserver.admin          — All admin permissions    (default: op)
Permission children:
Code (Text):
deadserver.admin:
  children:
    deadserver.pulse: true
    deadserver.whyleave: true
    deadserver.economy: true
    deadserver.guardian: true
    deadserver.player.view: true
    deadserver.player.compare: true
    deadserver.top: true
    deadserver.update: true

PlaceholderAPI

Code (Text):
%deadserver_health%         — Server health score (0-100)
%deadserver_retention%      — Retention rate (0-100)
%deadserver_economy%        — Economy health (0-1)
%deadserver_players_online% — Online player count
%deadserver_players_unique% — Total unique players
%deadserver_uptime%         — Server uptime in hours

Dependencies

Required:
• Paper 1.21+ (or compatible fork Purpur, Pufferfish)
• Java 21+

Soft dependencies (optional):
• Vault — Economy tracking
• PlaceholderAPI — Placeholder expansion

Built-in (no external plugin needed):
• SQLite (embedded database)
• Discord webhook


⚙ Configuration

Code (Text):
thresholds:
  retention_good: 50.0
  retention_fair: 25.0
  retention_critical: 20.0
  death_multiplier: 2.0
  economy_critical: 60.0
  tps_good: 18.0
  health_good: 70.0

database:
  type: sqlite
  backup:
    interval_ticks: 432000    # 6 hours
    max_age_days: 7

cache:
  health_score_ttl: 10        # seconds
  economy_cache_ttl: 300      # 5 minutes

discord:
  webhook_url: ""             # Your Discord webhook URL
  report_interval_ticks: 432000
  alert_on_critical: true

data:
  save_interval_ticks: 6000   # 5 minutes
Full configuration in
Code (Text):
plugins/DeadServer/config.yml

Installation

  1. Download DeadServer.jar
  2. Place it in your
    Code (Text):
    /plugins
    folder
  3. Restart your server (or use
    Code (Text):
    /reload
    )
  4. The plugin will automatically create
    Code (Text):
    config.yml
    and the SQLite database
  5. Configure
    Code (Text):
    discord.webhook_url
    in config.yml for Discord notifications
  6. If you have existing YAML data from a previous version, it will be migrated automatically


Notes

• All player data is stored in
Code (Text):
plugins/DeadServer/data/deadserver.db
(SQLite)
• Backups are automatically created and old backups cleaned up
• Economy features require Vault + an economy plugin (EssentialsX, CMI, etc.)
• Player profiles work for both online and offline players
• The plugin is fully async no main thread lag from database operations

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

DeadServer is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 36 times (via Spigot). Download it and open it directly in the game.

Explore more