isitgeorge/randomgift

RandomGift Bukkit Plugin

RandomGift

####Reward your active players!

---

###Description

RandomGift randomly rewards a lucky online player with a gift when a fellow player logs into the server. RandomGift encourages players to be active and spend time playing on the server regularly throughout the day as they are rewarded.

RandomGift is fully customisable, including the gift pool, minimum players required to activate RandomGift and amount of cooldown time between each gift reward.

---

###Default item pool

	Name	Quantity	ID
	Diamond	1	264
	Iron Sword	1	267
	Iron Shovel	1	256
	Iron Pickaxe	1	257
	Iron Shovel	1	258
	Iron Helmet	1	306
	Iron Chestplate	1	307
	Iron Leggings	1	308
	Iron Boots	1	309

---

###Permissions and Commands

Description	Command	Permission
Allows player to trigger the RandomGift	N/A	randomgift.trigger
Allows player to receive the RandomGift	N/A	randomgift.receive
View amount of time remaining before RandomGift is active again	/randomgift cooldown	randomgift.cooldown
Reset the remaining cooldown time	/randomgift reset	randomgift.reset
Manually trigger RandomGift	/randomgift gift <trigger player>	randomgift.gift
Reload the configuration file	/randomgift reload	randomgift.reload
View last player that received a gift	/randomgift history	randomgift.history
Notifications for Administrators	N/A	randomgift.admin
Access to everything above	N/A	randomgift.*

---

###Suggested Permission Setup

• Administrators

• randomgift.admin

• Inherit Staff

• Staff

• randomgift.trigger

• randomgift.cooldown

• randomgift.reset

• randomgift.gift

• randomgift.reload

• randomgift.history

• Players

• randomgift.trigger

• randomgift.receive

randomgift.* is also available to allow access to everything, recommended for Owners/Administrators.

---

###Configuration

The configuration file can be found inside /plugins/RandomGift once the server has been started with RandomGift installed.

Old configuration files do not update themselves, you are required to either manually update the config file yourself or generate a new one and copy your previous configuration (more info).

You can view detailed configuration information here.

---

###Future Features If you have a suggestion for a future feature, drop it into the comments section.

---

###Contributers View the contributers that help keep RandomGift awesome!

---

###Notes Update check

RandomGift checks the version of itself against the latest available version on startup, this can be disabeld inside config.yml.

Data collection

RandomGift uses Plugin Metrics to collect anonymous statistic data about RandomGifts usage and sends it to http://mcstats.org/plugin/randomgift.

If you prefer, you can disable both the Plugin Metrics and sending of version data inside the configuration file as seen above. You can also disable Plugin Metrics globally inside its own configuration located at /plugins/Plugin Metrics/config.yml

Help RandomGift conquer the world on GitHub?