GroupAnnouncer
GroupAnnouncer
Send announcements to different groups using permissions.
Completely manageable in-game.
Version: v0.72
Licensed under: GNU Lesser General Public License version 3 (LGPLv3)
Supports: Bukkit Permissions (AKA SuperPerms)
GroupAnnouncer allows you to broadcast a message to different group using permission nodes. Only groups with the permission node will receive the message. The plugin is 100% manageable in-game.
Features:
- Broadcast messages to specific groups.
- In-game management.
- Fully customizable:
- Tag
- Groups
- Timers
- Announcements
Installation:
- Place jar in plugins folder.
- Reload plugins with a plugin manager or restart server.
Configuration:
The default configuration file is generated upon first load:
enabled: true tag: 'Announcement ' order: 'sequential' groups: - global global: repeat: 60 last: 0 announcements: []
Commands:
The following commands can be used by users with the node 'ga.admin'
/ga: shows this message /ga reload: reload the config /ga toggle <enabled|order>: toggle on/off and order /ga tag [tag]: set the announcement tag /ga list: lists current groups /ga <add|remove> [group]: add or remove a group /ga [group] repeat [minutes]: set the repeat interval /ga [group] list: lists a group's announcements /ga [group] announce [#]: force a specific announcement /ga [group] remove [#]: removes specified message
Customization:
The following commands are examples of how to customize certain aspects of GroupAnnouncer:
/ga set tag &4[&fALERT&4]&f:: will set the tag to [ALERT]: with red brackets and white lettering. /ga global repeat 15: will show announcements for 'global' in 15 minutes increments /ga global add Welcome to the server!: Will add this message to 'global'.
Usage:
To add a new group and set all the necessary information one might do the following:
/ga group add guests **NOTE** The permission node required to see this message will now be ga.guests /ga guests repeat 10 /ga guests add You must register on the &4forums &fto become a member.
To remove a message from a group you would do the following:
/ga guests list **This will list all the messages with an index number. /ga guests remove 1
This section will be updated to include more examples upon request.
Permissions
- The default group is named 'global'. To broadcast this message give your users ga.global.
- User must have node 'ga.admin' in order to use GroupAnnouncer commands.
- In order for a group to see messages they must have the node in the format:
- ga.'group name'
Known Issues:
- None!
Getting support:
- Comment here, use the ticket system, PM me, or find me in #bukkit in IRC esper.net
Change Log:
4/4/12 - v 0.72
- Added the ability to append to an already existing announcement using /ga [group] append [#] [message]
4/4/12 - v 0.71
- Added the ability to use a specific tag for each group. If one is not specified, the default tag will be used.
3/22/12 - v 0.7
- Removed tagColor, msgColor, and delay.
- Added free format to tag using &09a-f.
- Modified a few commands.
- Added the ability to toggle whether or not the announcements are enabled.
- Added the ability to toggle between random and sequential announcements.
- Added the ability to manually announce a message to a group.
- Changed repeat time to minutes instead of seconds.
- Re-added auto reload after each change, but placed longer delay as to not start spamming messages.
- Announcements no longer have a default that you have to remove.
- IMPORTANT: It is recommended that you backup your config file before this update and re-add the information!!
3/22/12 - v 0.61
- Colors are now usable with & both in-game and in the config. You may need to edit your config file to reflect the change.
2/6/12 - v 0.6
- Added ability to add color into announcements using &0-9a-f
- Removed auto reload upon each change. - When you are finished making changes do /ga reload to update on live server.
1/26/12 - Initial release.
Todo & Planned Features:
- None at the moment!
-
View User Profile
-
Send Message
Posted Mar 8, 2012@pocketkings719
hell for that matter just create a new node in superperms right?
There see, i've pitched in. :D
Good work on the plugin bro. I've started to peruse java syntax more lately... might just get in on this action myself.
Thanks for the killer plugin.
PS, make sure to give scranner crap bout his grades lol.
-
View User Profile
-
Send Message
Posted Mar 6, 2012@domingo15
I assume you are using PEX if you are able to give yourself the '*' node. If this is the case all you need to do is give the group the negate permissions for the announcements you don't want them to see.
I'm not sure if there is really a necessity to change the permission node, especially since I already have people using the plugin. You can potentially make the nodes whatever you want. For example you could create an announcement group named "theoverlords" and give your admins the ga.theoverlords permissions and they would receive those announcements.
-
View User Profile
-
Send Message
Posted Mar 6, 2012@pocketkings719
i just wonder, so if u have the permission node "*", you will receive all the announcements from each group that is registered on the config.yml.
Edit: i suggest you change the permissions node ga.admin to groupannouncer.admin, theres no harm having long perms :)
just incase that admins might get confuse.
-
View User Profile
-
Send Message
Posted Mar 6, 2012v 0.6 has been submitted. It allows custom colors using &0-9a-f and removes the auto reload (which can be annoying when adding a lot of messages or making changes). When you are finished making changes, simply do /ga reload to apply them all. More changes coming soon including choosing random vs linear announcements, manually running announcement, and choice to enable/disable announcements.
-
View User Profile
-
Send Message
Posted Mar 5, 2012@Digitalink2008 Well the good news is, fully compatible with 1.2.3 :) Starting work on updates today.
-
View User Profile
-
Send Message
Posted Mar 2, 2012@Digitalink2008
We are in BETA but its running as a normal server. mc.vapidflats.com Will get this updated soon, I promise.
-
View User Profile
-
Send Message
Posted Mar 1, 2012LOL. doing my obligatory plugin checking for v1.2. How's the server coming along bro? I still need to stop in and see ya.
D.
-
View User Profile
-
Send Message
Posted Feb 20, 2012@Silthus
The groups tell the plugin which groups are available. So if you define your own group you must also add it to the group list. You can also use /ga reload if you manually edit the config.
@Enrux
I am currently very busy redoing our server which will hopefully be up this week. Once that is done I will be able to focus on the features people have asked for in the next update. Thank you for your interest!
-
View User Profile
-
Send Message
Posted Feb 18, 2012When will be next update coming?
-
View User Profile
-
Send Message
Posted Feb 18, 2012Is there a reload to command to reload the config when I edit it directly instead of using commands?
Also what is the groups option for?
-
View User Profile
-
Send Message
Posted Feb 9, 2012@R3TRI8UTI0N
In the next update I plan on adding multiple colors per announcement, thank you for the suggestion. In terms of word wrap, the issue is that not everyone uses the same font which means determining where word wrap should be is kind of difficult. I suppose the best solution for this would be to use word wrap while in default, I will look into it.
@ArrowsToDaKnee
Delay is the amount of time it takes before the announcement will start upon server start or plugin reload. Repeat is how often the item repeats. This because especially useful if you have multiple sets of messages able to be seen by one group, for example, if your VIP receive both the global message plus the VIP message, you will probably want to make sure they aren't being broadcast at the same time which is where delay comes into play. I will also be looking at a multi-line solution for the next update.
Thank you all for your feedback.
-
View User Profile
-
Send Message
Posted Feb 8, 2012@pocketkings719
Multi-line support is pretty much all I need!
-
View User Profile
-
Send Message
Posted Feb 7, 2012Awesome! Works great, but what is the difference between delay and repeat?
-
View User Profile
-
Send Message
Posted Feb 6, 2012Suggestion:
Instead of selecting the whole announcement and tag color, why not let us be able to specify multiple colors within the announcement? Word/text wrap would also be wonderful. I have tried multiple word wrap plugins and none seem to change how the message is displayed.
Coloring ex.
edit> Also, is it possible to manually display an announcement by typing a command in-game?
-
View User Profile
-
Send Message
Posted Feb 5, 2012@gabizou
I will double check but you should be able to edit the config manually, and as long as you follow the yaml format, you should just need to do /ga reload in game and it should load all of your announcements. I'm not sure about mulit-line support I will look into it for a future release. Thank you for your feedback, if you have any other suggestions, please let me know.
@Digitalink2008
Glad to see you remembered and are going to give it a shot! Please do let me know if you have any issues. I plan on making a few changes in the next update that should make it a little nicer during setup.
-
View User Profile
-
Send Message
Posted Feb 5, 2012Say, I really like Group Announcer that it doesn't restrict the amount of announcements I can make for any specific group but I'm having the issue that I'd just like to input in the config.yml the announcements myself and not type them all in game (also a multi-line support would be helpful to give more lengthy announcements).
Any way around this?
-
View User Profile
-
Send Message
Posted Feb 5, 2012Hey ya pocket, its DigitalInk2008 from Arctic Craft. So, UltraAnnouncer is officialy dead now. I remembered your plugin so I'm gonna give it a go and see how it works out. I'll let you know how it goes.
See ya, D.
-
View User Profile
-
Send Message
Posted Feb 2, 2012@zackb1079
Since this is the plugin that I use on my own server, I plan to support it as long as I can. If you have any suggestions, please feel free to offer them!
-
View User Profile
-
Send Message
Posted Feb 1, 2012Thanks for this. I hope you plan on providing support and updates for this plugin long-term, because a lot of announcement plugins are going out of date and their helpfulness is severely discredited.
-
View User Profile
-
Send Message
Posted Jan 27, 2012@Mr_H4mm3r
You need to set up your groups and messages using the plugin in game commands, then give your user the proper permissions. Here is a complete example of adding a new group, removing the default message, adding a custom message, and setting the timers:
You then need to give the players that you want to see this message the permission node ga.mygroup. You would then create another group the same way and so on. You may give one user multiple group nodes to allow them to see multiple messages from other groups.
Don't forget to give users ga.global so they can see global messages.