TownyAlerts

TownyAlerts is a lightweight community plugin created by DynaDev that listens to official Towny events and sends administrative alerts directly to Discord through DiscordSRV.

It does not modify Towny, taxes, upkeep, towns, nations or player balances. TownyAlerts works only as an observer and notification layer.

Features

• Daily Towny New Day summaries
• Town bankruptcy alerts
• Town ruin alerts
• Fallen town and nation notifications
• Missed New Day detection after server/plugin downtime
• Discord messages through the existing DiscordSRV bot
• Separate Discord channels per event type
• Dynamic language system
• Included languages:
  • en-us — American English
  • es-cl — Latin American Spanish
• Custom community language files supported
• Optional storage:
  • Memory
  • SQLite
  • MariaDB
  • MySQL
• Persistent event deduplication
• No telemetry
• No update checker
• No Discord webhook or additional bot token required

How it works

TownyAlerts listens to Towny's official Bukkit events.

When events such as a New Day, bankruptcy or ruined town occur, the plugin creates a notification and sends it asynchronously through DiscordSRV.

Discord and database failures are isolated and will not interfere with Towny's normal operation.

By default, no database is required.

storage:
  type: memory
SQLite, MariaDB and MySQL can optionally be enabled for persistent event history and deduplication.

## Commands

| Command | Description |
|---|---|
| `/townyalerts status` | Shows plugin, Towny, DiscordSRV, language and storage status |
| `/townyalerts test` | Sends a test notification to Discord |
| `/townyalerts reload` | Reloads TownyAlerts configuration and languages |
| `/townyalerts storage status` | Shows the current storage backend status |
| `/townyalerts storage test` | Tests the configured storage connection |

## Permissions

| Permission | Description | Default |
|---|---|---|
| `townyalerts.admin` | Allows access to all TownyAlerts administrative commands | OP |

## Requirements

- Towny
- DiscordSRV
- Java 17 or newer, depending on your Minecraft server version

TownyAlerts is designed around Towny's current Minecraft support range from **1.19.x through 26.2.x**.

Current compatibility is focused on **Paper and Purpur**.

## Languages

Set the language in `config.yml`:

```yaml
language: "en"

Examples:

en
en-us
es
es-cl
es-mx
fr
fr-ca
en-uk

Language identifiers are case-insensitive.

Custom language files can be added to:

plugins/TownyAlerts/languages/

Missing translations automatically fall back to en-us.