Crusalis CapPinger

A tiny, client-side Fabric mod that watches your chat for war alerts and fires a clean Discord embed with a live map image so your team can react instantly.

---

What it does

• Detects war messages like:

  • "[War] <player> is attacking <town> at (x, y, z)"
  • "[War] <player> captured chunk (cx, cz) from <town>"
  • "[War] <player> captured territory (id=ID) from <town>"

• Sends a Discord embed with:

  • Attacker name
  • Target town
  • Coordinates
  • Timestamp
  • A generated map image showing the attack location with nation colors from Dynmap

• Different embed styles for different events:

  • Chunk Attacked - Red, for ongoing attacks
  • Chunk Captured - Orange, for when a chunk is taken
  • Territory Captured - Purple, with a striped visualization showing attacker vs defender

No commands, no server plugin required—just drop it in your client.

---

Configuration (Cloth Config)

Open Mods → Crusalis Cap Pinger → Config (Mod Menu), then:

• Discord Webhook URL — paste your channel webhook.
• Broadcast All (default ON) — forward every matching alert.
• Target Names — when Broadcast is OFF, only send if the target matches one of these names (exact match, case-insensitive).
• Ping Role ID (optional) — paste a Discord Role ID to @mention your defense squad.

Settings are saved locally; you can change them in-game anytime.

---

How it works

The mod listens to client message events on Fabric 1.21.7-1.21.8, parses each line, matches regex patterns for [War] messages, and—if allowed by your config—generates a map image from Dynmap data and POSTs a Discord embed. Map generation runs on a background thread so there's no FPS impact.

---

Requirements

• Minecraft 1.21.7 or 1.21.8
• Fabric Loader + Fabric API
• Cloth Config
• Mod Menu (for the config button)

---

Installation

1. Install Fabric Loader and Fabric API.
2. Drop Crusalis CapPinger into mods/.
3. Add Mod Menu and Cloth Config.
4. Launch → Mods → Crusalis Cap Pinger → Config → paste webhook.
5. Keep Broadcast All ON or add Target Names if you only care about certain towns.
6. (Optional) Add Role ID to ping a specific role.

You're live the moment a war alert hits chat.

---

The Map Image

Each alert includes an auto-generated map showing:

• Nation territories in their actual Dynmap colors
• Chunk grid overlay for reference
• Blue ocean background
• The attacked/captured chunk or territory highlighted
• Territory captures show stripes to indicate attacker vs defender

---

Privacy & Safety

• The mod reads incoming chat locally to find alerts.
• It only sends matched war alerts to your webhook.
• Your webhook URL stays on your PC.
• Dynmap data is fetched from the public Crusalis map API.

---

Filtering behavior

• Broadcast All = ON: every matching [War] message goes to Discord.
• Broadcast All = OFF: only send if the parsed target equals one of your Target Names (case-insensitive).

---

Compatibility

• Client-side only. No server permissions required.
• Works alongside optimization mods (Sodium, etc.).
• Doesn't modify gameplay—just listens for messages and posts webhooks.

---

Modpack & server policy

• Allowed in modpacks.
• Safe for client-only use (it doesn't automate gameplay, just relays alerts you can already see).

---

Summary

Paste webhook → choose Broadcast All or targets → (optional) role ping → done.

Crusalis CapPinger gives your team fast, clean Discord alerts with map images the moment a war event happens.

---

Special thanks to:

oreotrollturbo for providing me his original dynmap fetcher code from Crusalis Utils.