Important!
This plugin uses Java 17, if you are using another java version you may need to add this line to your batch file:
"
-DPaper.IgnoreJavaVersion=true ^"
Advancement Announcer Features
- Advancement Announcer gives you the ability to send toast 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 are: GOAL, TASK, CHALLENGE
- Possible options for icon can be found here.
- You can either give a player's name or "all" as target.
- You can write your own message on the command or use one of the presets you 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.
Configuration (YAML)
While you can manage everything from the in-game GUI, you can still edit the config.yml manually.
Code (YAML):
# ######################################################################################################
# ## ##
# ## AdvancementAnnouncer v1.2 by Altkat(StreetMelodeez) ##
# ## Discord: streetmelodeez ##
# ## Please use /aa reload to apply changes. ##
# ## You can use /aa edit in game chat to edit this file. ##
# ## ##
# ######################################################################################################
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
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.