Advancement Announcer Features

• Advancement Announcer gives you the ability to send custom advancement messages to desired players.
• In-Game GUI Editor: Manage everything from an easy-to-use in-game interface. No more YAML editing!
• You can set up presets to easily send them with a simple command or the GUI.
• Set automated messages to send on a specified interval to your players.
• AA supports PlaceholderAPI (PAPI), allowing you to use any placeholders supported by PAPI.
• Update Checker: Notifies admins in-game when a new version of the plugin is available.
• Tested on Minecraft versions 1.16.5 - 1.21.8.
• Feel free to contact me via Discord for questions, issues, or suggestions.

Commands

• /aa edit: Opens the main configuration GUI. From here, you can manage presets and auto-announcements.
• /aa <style> <icon> <player's name/all> <preset/message>
  • Possible options for style: GOAL, TASK, CHALLENGE.
  • Possible options for icon can be found here.
  • Target a specific player's name or use all.
  • Write your own message in the command or use one of the presets defined in the config.
• /aa toggle: Players can set if they want to see announcement messages (Player-specific announcements are not affected by this command).
• /aa reload: Reloads the configuration file.

Permissions

• advancementannouncer.admin: Required for all commands except /aa toggle.

The In-Game GUI Editor

Manage everything with the new /aa edit command. Add, remove, or edit presets and auto-messages on the fly without ever needing to open the config file.

Images from Advancement Announcer

Due to file limits, GIFs are located in the gallery section.

Configuration (YAML)

While you can manage everything from the in-game GUI, you can still edit the config.yml manually.

# ######################################################################################################
# ##                                                                                                  ##
# ##   AdvancementAnnouncer v1.2 by Altkat(StreetMelodeez)                                            ##
# ##   Discord: streetmelodeez                                                                        ##
# ##   Please use /aa reload to apply changes.                                                        ##
# ##                                                                                                  ##
# ######################################################################################################
bstats: true # Should the plugin send data to bStats?

# you can use placeholders from PlaceholderAPI in the messages. like %player_name%
# use | to print on a new line
presets: # you can add as many presets as you want
  preset1: "&aThis is &6my cool| &amessage wow!"
  store-preset: "&6You can get ranks|&6on our store &b/store"
  discord-preset: "&9Join our discord server|&bdiscord.gg/yourdc"
  greeting: "&eHello &a%player_name%|&eHow is it going?"


auto-announce:
  enabled: false    # should the plugin announce messages automatically
  interval: 30      # in seconds
  mode: "ORDERED"   # ORDERED, RANDOM
  messages:         # you can add as many messages as you want
    custommessage1:
      message: "&eHello &a%player_name%|&eHow is it going?"
      style: "GOAL"   # GOAL, TASK, CHALLENGE
      icon: "EMERALD" # [https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html)
    custommessage2:
      message: "&9Join our discord server|&bdiscord.gg/yourdc"
      style: "TASK"
      icon: "DIAMOND"
    vipmessage:
      message: "&6You can get ranks|&6on our store &b/store"
      style: "CHALLENGE"
      icon: "GOLD_INGOT"




#These are the messages shown to players
#You can edit these messages
lang-messages:
  config-reloaded: "&3[AdvancementAnnouncer] &aConfig reloaded!"
  wrong-usage: "&cWrong usage! Please use /aa toggle"
  announcements-toggled-on: "&aYou now see the advancement announcements!"
  announcements-toggled-off: "&cYou no longer see the advancement announcements!"
  edit-gui-title: "&3Advancement Announcer Edit"
  presets-gui-title: "&3Advancement Announcer Presets"
  auto-announce-gui-title: "&3Auto Announce Config"
  input-cancelled: "&cInput process cancelled."

Need help? Feel free to contact me via Discord.