P_Alerta

P_Alerta Plugin – Description

The P_Alerta plugin provides a command for broadcasting customizable alert messages to all online players on a Minecraft server. Alerts are displayed as titles, subtitles, and action bar messages, with support for legacy color codes (&), MiniMessage formatting, PlaceholderAPI placeholders, and configurable sound effects. The plugin ensures all messages are correctly formatted and automatically truncated if they exceed the configured character limits.

Commands /alerta

Description: Sends an alert message to all online players. The title uses a configurable prefix (default: [ALERTA] in red), while the subtitle and action bar show the message provided by the sender.

Features:

Supports legacy color codes (&)

Supports MiniMessage modern formatting

Supports PlaceholderAPI placeholders (if installed)

Plays a configurable sound when the alert is sent

Automatically truncates oversized messages

Configurable action bar duration and refresh rate

Permission: p_alerta.alerta

Usage Examples

/alerta &cAtenção! Evento começará em 5 minutos! Sends a red alert saying “Atenção! Evento começará em 5 minutos!” to all players.

/alerta <red>Manutenção programada às 14:00</red> Uses MiniMessage formatting to send a red maintenance alert.

Behavior

If no players are online, the command sender is notified.

If the message is empty, the sender receives a warning that the message cannot be empty.

Messages exceeding the configured maximum lengths (title-max-length, actionbar-max-length) are automatically shortened with ....

The action bar message persists for the configured duration (actionbar-duration-ticks) and refreshes every 0.2 seconds.

If PlaceholderAPI is enabled, placeholders in the message are replaced per player.

A configurable sound effect (alert-sound, sound-volume, sound-pitch) can be played for all players when sending an alert.