Bukkit

Ever wanted to use a custom twitter feed to fuel your in game announcements? Well, now you can! This plugin was comissioned by Wildcraft for their server. Be sure to check them out!

Features

• Reads an account's Tweets and makes announcements out of them
• Create time sensitive announcements which automatically stop running after the time frame
• Auto refresh! No need to ever reload the plugin to grab new announcements
• URL un-shortener - Unshortens URLs which don't resolve to twitter.com
• Easy to use and configure
• Supports color codes!

How to Use

1. Create a Twitter account
2. Install the plugin
3. While in game do the command /ta auth to get your verification URL
4. Open the URL in your browser using the Twitter account you want to use and authorize the application to read your tweets. It will give you a code, write it down.
5. Back in game do the command /ta auth <code> where <code> is the code you got. Example: /ta auth 567934
6. Now that the account is authorized do the command /ta user <username> where <username> is the user's name. To read my tweets for example you would do: /ta user thetux2
7. You're done! Just set the duration between the announcements in the config.yml and you're all set!

Tweet Format

• For permanent announcements: P <announcement> Example: P &6Make sure to check out our website: http://wildcraftmc.com
• For temporary announcements: T <time><s|m|h|d|w|y> <announcement> Example temp tweet for 5 minutes: T 5m &75 Minute flash sale! Use code 5MINFLASH in our shop to get 20% off!
• s = seconds, m = minutes, h = hours, d = days, w = weeks and y = years.

Config

• SecondsBetweenAnnouncements - The amount of seconds between announcements
• MinutesBetweenTwitterSync - If you want the plugin to sync at a specified interval instead of when it's done cycling through the tweets put it here. Otherwise leave it at -1 to let it sync whenever it gets done with the current list of tweets
• UserToken - Don't touch this! I get this from Twitter when you authorize your account!
• UserSecret - Don't touch this either! I also get this from Twitter when you authorize your account!
• TwitterID - The Twitter user to grab tweets from
• IgnoreInvalidTweets - Set this to true if you want any Tweets not meeting the specified format to not be announced. Otherwise It formats tweets not meeting the critera as permanent announcements.
• IgnoreRepliesAndRetweets - Does what it says. Ignores replies to users and retweets when true.
• Prefix - The prefix before the announcement. Set to "" if you don't want a prefix.

Permissions

• tweetannouncer.auth - Allows the player to setup TweetAnnouncer.