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 May 12, 2012@lolitsthad
This will only reset if you have somehow added an illegal character. I recommend editing your config with Notepad Plus Plus then you will be able to edit them just fine. The most common error is a Windows Return character. Please get back to me.
-
View User Profile
-
Send Message
Posted May 10, 2012The latest update broke this for me. Up until now I've been adding my announcements into the config.yml because I want to have announcements that are longer than the chat allows you to type. When I upload the config and then do a "/ga reload", it just wipes everything I put in the config and generates a new blank one. I also tried stopping the server, then uploading my config.yml, and starting the server, but when the server starts up it just wipes the config and generates new blank one again.
So I can only add announcements through the in-game commands and can't figure out how to get the things I put directly into the config.yml to work.
-
View User Profile
-
Send Message
Posted Apr 14, 2012@deleted_7554077
Hey very sorry about slow updates. I am in the middle of a job transition and moving to a new state so bare with me. 0.73 is in the works and I will push it out as soon as possible.
-
View User Profile
-
Send Message
Posted Apr 13, 2012Any ETA on the next version. Really looking forward to it!
Thanks
-
View User Profile
-
Send Message
Posted Apr 12, 2012Moved here from UltraAnnouncer, love the in-game ease, as well as the ease of setting it up to copy my old configuration file. Thank you for working to keep a plugin like this going!
-
View User Profile
-
Send Message
Posted Apr 6, 2012@BoboTheTwit
Bobo, everything is setup in game. Start by creating a new group with /ga add <group> Then add the announcements you want with /ga <group> add <message> Finally set the repeat time with /ga <group> repeat <time-in-minutes> and you should get a basic config that you can then edit by hand if you want. The idea behind this plugin is that everything is done in game. Also, make sure you give the group you want to see the announcement ga.<group>
-
View User Profile
-
Send Message
Posted Apr 6, 2012is there an example config, with pre-made announcements already in place? I'm a bit confused as to what goes where...
-
View User Profile
-
Send Message
Posted Apr 4, 2012@lolitsthad
Last is used to track the last announcement that was broadcast so it know which once to broadcast next. It is used for internal purposes only.
-
View User Profile
-
Send Message
Posted Apr 4, 2012@pocketkings719 thanks for the fast reply. One more question - what is "last"? I have delay and repeat set to 20 and last to 0. The announcements showed up a few times and then stopped showing altogether even though I didn't toggle them off.
-
View User Profile
-
Send Message
Posted Apr 4, 2012GA 0.72 pushed to Dropbox
-
View User Profile
-
Send Message
Posted Apr 4, 2012Ok sure.
-
View User Profile
-
Send Message
Posted Apr 4, 2012@deleted_7554077
I'm only doing one thing at a time right now, the change-log is accurate for these pushes.
-
View User Profile
-
Send Message
Posted Apr 4, 2012Did you change the interval into seconds or is it still in minutes?
I see default is 10 for default and 60 for interval.
You set the interval to 60 minutes :D?
-
View User Profile
-
Send Message
Posted Apr 4, 2012@deleted_7554077
Put that in a ticket so I don't forget :P
-
View User Profile
-
Send Message
Posted Apr 4, 2012Now you just need to add these to be group specific aswell:
enabled: true
order: sequential
So we can toggle on/off and the order for each group separately :D
-
View User Profile
-
Send Message
Posted Apr 4, 2012GA 0.71 pushed to Dropbox
-
View User Profile
-
Send Message
Posted Apr 4, 2012@deleted_7554077
The offsite link will contain the latest at all times.
-
View User Profile
-
Send Message
Posted Apr 4, 2012Will do :D
-
View User Profile
-
Send Message
Posted Apr 4, 2012@lolitsthad
Delay is the time is takes for the announcements to start happening once the server is first started, all plugins are reloaded, or you just use /ga reload.
Repeat is the time in between announcements.
@deleted_7554077
I will pushing updates out tonight as I am working on them. Please feel free to test the features and let me know if there are any bugs as I'm working.
-
View User Profile
-
Send Message
Posted Apr 4, 2012Delay = time between announcements
delay = time between plugin loaded to first announcement