Перейти к содержимому
Mineforgian

BubbleAnnounce

Auto announcements for Minecraft servers. Super easy to configure.

Загрузки
151
Подписчики
0
Обновлён
5 июня 2026 г.
Лицензия
MIT

Опубликован 11 декабря 2025 г.

Исходный код

A highly configurable announcement plugin for Bukkit-based servers (Paper/Purpur/Folia/Spigot). Easy setup, modern text support, and lots of QoL.

✅ Compatibility

  • Minecraft: 1.21+
  • Java: 21
  • Works on: Paper / Purpur / Folia / Spigot
  • Not for proxies: ❌ Velocity / BungeeCord / Waterfall

✨ What it can do

  • 📣 Send announcements to chat, actionbar, or titles
  • 🎨 Text formats: Legacy (& + hex #RRGGBB), MiniMessage, JSON Components
  • ↔ Center messages with <center>...</center> (chat + actionbar)
  • ⏱ Fixed intervals or 🎲 randomized intervals
  • 🕒 Hour windows + ⭐ priority to reduce overlap
  • 🔒 Targeting + QoL: permissions, worlds, per-player cooldown, sounds, prefixes
  • 🧩 PlaceholderAPI support (optional)
  • 🍀 Folia-safe delivery

🚀 Install

  1. Put BubbleAnnounce.jar in plugins/
  2. Restart the server
  3. Edit plugins/BubbleAnnounce/config.yml
  4. Run /bubbleannounce reload

🧾 Config example

announcements:
  discord:
    enabled: true
    type: chat
    mode: legacy
    interval: 30
    messages:
      - "<center>&9★ &fJoin our &9&lDiscord&f server! &9★</center>"
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    cooldownSeconds: 300

📋 Commands

  • /bubbleannounce reload
  • /bubbleannounce list
  • /bubbleannounce toggle <id>
  • /bubbleannounce test <id>
  • /bubbleannounce debug
  • /runannouncements

🧩 PlaceholderAPI

If PlaceholderAPI is installed, placeholders will be applied per-player (e.g. %player_name%).

Ченджлог

1.1.2Релиз26.1.2 · 5 июня 2026 г.

[1.1.2] - 2026-06-05

Fixed

  • Empty messages ("") in announcement lists now render as blank lines instead of being silently dropped by Paper

Added

  • <center> tag support — wrap any message in <center>...</center> (or just <center>) to horizontally center it in chat using pixel-accurate Minecraft font widths
1.1.1Релиз26.1.2 · 17 мая 2026 г.

Updated

  • Upgraded to Paper API 26.1.2.build.63-stable (latest stable)
  • Updated Adventure API to 5.1.0 (adventure-text-minimessage, adventure-text-serializer-legacy) — now compileOnly (provided by Paper 26.x server)
  • Added Java 25 toolchain configuration
  • Updated api-version in plugin.yml to 26.1.2

[1.1.0] - Previous Release

  • Initial stable release with configurable announcements
1.1.2Релиз1.21.9, 1.21.10, 1.21.11 · 15 января 2026 г.

1.1.2 — 2026-01-15

  • Added messagesPerRun to allow sending only N message lines per interval (e.g. 100 tips in one announcement, 1 per hour).
  • randomOrder now supports two useful patterns:
    • With messagesPerRun: 1, it picks a random message each run.
    • With messagesPerRun: 0 (default), it shuffles the whole multi-line announcement.
  • Updated docs/examples to explain "announcement vs message lines" and the recommended setup for large message pools.
1.1.1Релиз1.21.9, 1.21.10, 1.21.11 · 24 декабря 2025 г.

1.1.1 — 2025-12-24

  • Added <center>...</center> tag support to center chat/actionbar lines.
  • Added JSON component message support (set mode: json or use mode: auto with lines that start with { or [).
  • Added randomized intervals via intervalMin/intervalMax (minutes).
  • Added timed windows via activeHourStart/activeHourEnd (server local time).
  • Added priority-based overlap control via priority (higher priority preempts lower to reduce overlapping streams).
  • Implemented the config options that were previously documented but not applied:
    • permission (only players with a permission see it)
    • worlds (only in specific worlds)
    • sound (plays a sound when an announcement is delivered)
    • prefix (per-announcement prefix overrides global settings.prefix)
    • cooldownSeconds (per-player cooldown per announcement)
  • PlaceholderAPI placeholders are applied per-player before parsing (legacy/minimessage/json).
  • Added Folia support by running message delivery on each player's region thread.
  • settings.debugMode now actually controls debug logging (and /bubbleannounce debug still works for toggling at runtime).
  • startup_scheduled message is now logged when timers are scheduled.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 11 декабря 2025 г.

Add clear warnings about Bukkit vs Velocity compatibility

  • Added prominent warnings that this is NOT a Velocity plugin
  • Clarified installation location for proxy setups
  • Added troubleshooting section for common error
  • Updated plugin.yml description with platform requirements

Комментарии

Загружаем…