An auto-messaging/auto-announcement/announcer/thing system for your minecraft server.

Bukkit version doesn't matter for this plugin. Please don't ask me to update it for that reason.


Okay, so here's my first plugin which I've actually released that isn't amazingly small-scale. It's a fairly simple plugin which relays messages, at the rate in minutes, set in the configuration. It allows for colours, multi-line messages, message cycling, and message shuffling. I made this because I've seen a few plugins like this, but they're either out-of-date and don't work, or they just don't work, period. From thereabouts comes this plugin, FrogAnnounce. I know the name is lame; I'm not creative with names, sorry.

FrogAnnounce 2.0.1: Review By: UltiByte


Version: 2.4.0
Build date: 30 March 2014
BukkitDev Download: Latest Build

Not-Always-So-Stable Source

GitHub: TheLunarFrog's Source


  • Announcements relayed to the entire server at the specified rate
  • Random or sequenced (configurable)
  • Ability to store as many announcements as you want
  • Force an announcement to run immediately, without interrupting the normal announcement cycle or schedule
  • Opt out and ignore announcements, or opt-in again and be unignored to see them again, controllable with permission nodes
  • Ability to announce everything to only certain groups (improved in 2.3.0).
  • Ability to send specific messages to certain groups, i.e. announcement 1 to group administrators, announcement 2 to moderators and donators (improved in 2.3.0)
  • In 2.3.0: Ability to announce everything to only certain worlds
  • In 2.3.0: Ability to announce only certain announcements to certain worlds
  • In 2.3.0: Ability to combine any of the preceding 4 conditions (global groups, announcement-specific groups, global worlds, and announcement-specific worlds)

Planned Features

  • Any suggestions are welcome.

Special Function Explanations

Special function explanations with escape sequences and other special instructions and help (i.e. announcement specific group filtering, etc.)

Change Log


Permissions & Commands

Permissions & Commands

Configuration Explanation


Bugs and Feature Requests

Bug reports & Feature Requests

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of crazyfrogcrafter crazyfrogcrafter Mar 30, 2014 at 18:35 UTC - 0 likes

    Perfect! Just what I wanted!

  • Avatar of TheLunarFrog TheLunarFrog Mar 28, 2014 at 16:52 UTC - 0 likes

    Version 2.4.0 has been uploaded and is waiting on approval. It includes independent announcements, which will not interrupt or delay the schedule of synchronous announcements at all. All you have to do to mark an announcement as independent is add the key "Interval" to that announcement, i.e. Interval: 5. If left at the same interval as the synchronous announcer, the announcement will fire at the same time as the synchronous announcer.

    More information on this update is available on the changelog page.

    Last edited Mar 28, 2014 by TheLunarFrog
  • Avatar of BashyDaBest BashyDaBest Mar 19, 2014 at 04:40 UTC - 0 likes

    @TheLunarFrog: Go

    Lol, that was easy, thanks for the help! :D

  • Avatar of TheLunarFrog TheLunarFrog Mar 18, 2014 at 15:12 UTC - 0 likes

    @BashyDaBest: Go

    While the colour seems to be yellow, you can just use &e; (note the semicolon). If you have any more issues, let me know.

  • Avatar of BashyDaBest BashyDaBest Mar 18, 2014 at 04:48 UTC - 0 likes

    @TheLunarFrog: Go

    Mind helping me with something? Whats the code for &e for FrogAnnounce? I've tried &YELLOW; or &LIGHT_GOLD; Non work, got any idea whats the code?

  • Avatar of TheLunarFrog TheLunarFrog Dec 22, 2013 at 18:10 UTC - 0 likes

    @Destroyer_xI: Go

    I'm aware, based on the previous comment and a ticket has been created already.

  • Avatar of Destroyer_xI Destroyer_xI Dec 22, 2013 at 16:11 UTC - 0 likes

    using the latest bukkit builds, empty config files are generated.

    inputs full configuration file.

    /fa add testtest


    /fa bc 1

    an internal error occured

  • Avatar of TheLunarFrog TheLunarFrog Dec 20, 2013 at 01:50 UTC - 0 likes

    @xYourFreindx: Go

    Thanks for the stacktrace! I will work on fixing this (I know what's wrong, based on what you've given me)

    The different interval feature should be coming fairly soon. It's a pretty simple feature at this point.

  • Avatar of xYourFreindx xYourFreindx Dec 20, 2013 at 01:38 UTC - 0 likes

    @TheLunarFrog: Go Thank you so much for the quick reply.

    I've pasted the error it first gave me here - - I have never had a problem with plugin's generating files automatically for me before. This was a first. No longer an issue to me anymore.

    I do really look forward to the ability to set different intervals. And thanks for the info regarding the apostrophes, I'll keep that in mind.

    Looking to be the apprentice for a plugin owner.
    I'd like to test for bugs and or pick up on some java experience.
    Please PM me if you'd be willing.

  • Avatar of TheLunarFrog TheLunarFrog Dec 20, 2013 at 00:43 UTC - 0 likes

    @xYourFreindx: Go

    Thanks for the compliment! I'd just like to point out that, while I do not ignore comments, if you have an issue with a plugin, you should submit a ticket, as a lot of people on bukkitdev will ignore your request if you don't. Beyond that, I will address your issues in order of which you mentioned them:

    1. I'm unsure of what you mean by that. Can you make sure your security settings (i.e. OS, antivirus, etc. - I know Comodo has an issue with programs creating files, until you add an exception in its security rules for Bukkit's Java process) and your folder settings (such as the directory's chmod if you're on linux) to make sure that it doesn't create a default config for you? Is an exception thrown into the console at all? Or does no error appear? If you watch your console and have colours enabled, my plugin may or may not stick out (its console messages are always headed with a dark green '[FrogAnnounce]'), hopefully helping you find this information.

    On my local machine, the default configuration does generate, so if you're having an issue getting it to generate, I'd love to get that fixed.

    In the meantime, however, check out the default configuration posted on BukkitDev in this plugin's pages.

    2. That feature exists already. If you look at the configuration page, it allows you to specify a group for only that announcement to announce to. For example, if I have:

                Text: 'Don\'t forget to pick a class!'
                - 'Default'

    ...Then the announcement will only announce to the Default group, if that's what your default group is called. Please note, however, that Don't should actually be Don\'t - this is explained on the special function explanations page. I don't believe this has been fixed yet within SnakeYAML, the library which Bukkit uses for reading YML files (or, well, changed - it's intentional).

    Unfortunately, I haven't yet added a functionality to specify an individual announcement's interval. That feature, however is planned.

    In addition, at the moment, the announcer will not look for a different announcement to send to those not eligible for the current announcement, i.e. if there's another message that goes to everyone, but player X is not part of the Default group and the aforementioned announcement exists, player X will not receive that other announcement in place of the current one. This functionality was deemed too taxing on the server, as it could potentially run through a very long list of announcements if none of them apply to a given player - and this would happen every time the plugin announces. This functionality is also planned however, but it will be toggleable (you can turn it on and off at will), defaulting to off when it's added.

    If I misinterpreted what you're asking for, please clarify.

    Thanks! Happy holidays to you, too!

    Last edited Dec 20, 2013 by TheLunarFrog


Date created
Oct 21, 2011
Last update
Mar 28, 2014
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files