BossTimer-Mod

BossTimer is a lightweight, server-side Fabric mod that lets server owners create and run configurable countdown timers displayed using Minecraft’s boss bar.

What it does

BossTimer allows you to define named timers in a simple JSON config and start them with commands. Each timer:

• Displays a live countdown in a boss bar
• Updates text and progress in real time
• Can run commands before and after the timer ends
• Supports trigger messages at specific remaining times (for example, “10 seconds left”)
• Automatically syncs to players who join while a timer is already running

Why download it

This mod is ideal for:

• Server restart warnings
• Event countdowns
• Scheduled announcements
• Any situation where players need a clear, visible timer

It’s fully server-side, requires no client mods, and integrates with permission systems like LuckPerms.

Important info before downloading

• Fabric loader + Fabric API required
• Server-side only (players do not need to install anything)
• Timers are defined in config/bosstimer_commands.json
• Active timers are canceled on config reload for safety

Simple to configure, reliable for players, and designed for real-world server use.

Example Config

{
  "restart": {
    "duration": 60,
    "bossbar_message": "⏳ Restart in %s seconds",
    "before": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"red\",\"bold\":true,\"extra\":[{\"text\":\"An unplanned server restart is about to take place. Please plan accordingly.\",\"color\":\"yellow\"}]}",
      "title @a title {\"text\":\"Restart Incoming!\",\"color\":\"gold\"}"
    ],
    "after": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"yellow\",\"bold\":true,\"extra\":[{\"text\":\"The server is restarting soon.\",\"color\":\"yellow\"}]}"
    ],
    "triggers": {
      "30": {
        "message": "⏳ 30 seconds remaining."
      },
      "10": {
        "message": "⏰ 10 seconds!"
      },
      "5": {
        "message": "⚠️ Restarting soon..."
      }
    }
  },
  "scheduledrestart": {
    "duration": 300,
    "bossbar_message": "Scheduled Restart in %s seconds",
    "before": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"red\",\"bold\":true,\"extra\":[{\"text\":\"A scheduled server restart is about to take place. Please plan accordingly.\",\"color\":\"yellow\"}]}",
      "title @a title {\"text\":\"Restarting Soon!\",\"color\":\"gold\"}"
    ],
    "after": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"yellow\",\"bold\":true,\"extra\":[{\"text\":\"The server is restarting soon.\",\"color\":\"yellow\"}]}"
    ],
    "triggers": {
      "180": {
        "message": "⏳ 3 minutes until restart!"
      },
      "60": {
        "message": "⚠️ Restart in 60 seconds!"
      },
      "10": {
        "message": "⏰ 10 seconds!"
      }
    }
  },
  "reload": {
    "duration": 45,
    "bossbar_message": "🔁 Reload in %s seconds",
    "before": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"red\",\"bold\":true,\"extra\":[{\"text\":\"An unplanned server reload is about to take place. Please plan accordingly.\",\"color\":\"yellow\"}]}",
      "title @a title {\"text\":\"Reload Incoming!\",\"color\":\"gold\"}"
    ],
    "after": [
      "tellraw @a {\"text\":\"[ALERT] \",\"color\":\"red\",\"bold\":true,\"extra\":[{\"text\":\"The server is now reloading.\",\"color\":\"yellow\"}]}",
      "reload"
    ],
    "triggers": {
      "20": {
        "message": "⏳ 20 seconds left before reload."
      },
      "10": {
        "message": "⏰ Final 10 seconds!"
      },
      "5": {
        "message": "⚠️ Reload incoming..."
      }
    }
  },
  "dropparty": {
    "duration": 300,
    "bossbar_message": "🎉 Drop Party in %s seconds",
    "before": [
      "tellraw @a {\"text\":\"[EVENT] \",\"color\":\"aqua\",\"bold\":true,\"extra\":[{\"text\":\"A drop party is starting soon at \",\"color\":\"white\"},{\"text\":\"/warp dropparty\",\"color\":\"yellow\",\"underlined\":true}]}",
      "title @a title {\"text\":\"🎁 Drop Party Incoming!\",\"color\":\"aqua\"}"
    ],
    "after": [
      "tellraw @a {\"text\":\"[EVENT] \",\"color\":\"aqua\",\"bold\":true,\"extra\":[{\"text\":\"The drop party has begun at \",\"color\":\"white\"},{\"text\":\"/warp dropparty\",\"color\":\"yellow\",\"underlined\":true}]}",
      "title @a title {\"text\":\"🎁 Drop Party Started!\",\"color\":\"aqua\"}"
    ],
    "triggers": {
      "180": {
        "message": "⏳ 3 minutes until drop party at /warp dropparty!"
      },
      "60": {
        "message": "⏰ 1 minute left! Prepare for the drop at /warp dropparty!"
      },
      "10": {
        "message": "🎁 Drop party starting any moment now! Use /warp dropparty!"
      }
    }
  }
}