Easy Gift
This simple and lightweight plugin allows users to easily send gifts to one another.
Here's an example, PlayerA wants to send PlayerB a gift of 10 diamonds. All PlayerA has to do is have 10 diamonds highlighted on their hotbar and type /gift PlayerB. Then the 10 diamonds will be removed from PlayerA's inventory then, if PlayerB is online and has space in their inventory, PlayerB will receive the gift of 10 diamonds.
This project is still in beta, not all features are completely finished or working correctly.
Current Features
- <sub>[v1.0]</sub> Gifts - Sending gifts between players
- <sub>[v1.0]</sub> Gift Log - Logs all gifts between players (Toggleable in the config).
- <sub>[v1.1.5]</sub> Receipts - When a player sends a gift, they receive a receipt with the following information. Who the gift was sent to, what the gift was, how many items were sent & the date and time.
- <sub>[v1.1.5]</sub> Opt-out - Players can opt-out of gifts being sent to them.
- <sub>[v1.1.5]</sub> Blocks - Players can block specific players from sending them gifts.
- <sub>[v1.1.5]</sub> Plugin Metrics - See stats about Easy Gift.
- <sub>[v1.2.1]</sub> Permissions - Control who uses different commands.
- <sub>[v1.2.9]</sub> Admin Stats - View various stats. Gifts sent, players who opted out & blocked players. (More coming soon)
<sub>[v1.3.6]</sub> Cooldowns - Customizable and toggleable cooldowns, make players wait between sending gifts to avoid spam.Causing bugs, fix soon.- <sub>[v1.3.6]</sub> Gift all Items - All items can be sent. Named items, items with lore, items with enchantments, items with durability, written books, enchanted books, player heads & maps.
- <sub>[v1.3.6]</sub> Update Checker - Check if there is an update available for Easy Gift (toggleable in config).
- <sub>[v1.4.2]</sub> More admin commands - Added enabling and disabling all gift giving.
- <sub>[v1.4.2]</sub> Banned items - Admins can ban certain items from being sent as gifts.
- <sub>[v1.4.2]</sub> More stats - See banned items.
Todo List
Cooldowns - Add cooldown between sending gifts to avoid spam.Opt Outs - Allow a player to choose not to accept gifts.Blocks - Allow players to block certain players sending gifts.Special Items - Allow players to send items withenchantments, durability values, books, names and lore.Receipts - Give players books or pieces of paper detailing who gave what and how much to who.Plugin Metrics.Improve file loader.- Optimize code.
Admin commands.(More admin commands coming soon)Permissions.- Send a message with a gift.
- Switch file storage to database.
- Banned Items - Certain items cannot be sent as gifts.
- Improve cooldowns - Allow player to see a timer to check how long their cooldown has left.
Commands | Description |
---|---|
/gift <player> | Sends whatever the sender has highlighted on hot bar to <player>. |
/giftblock <player> | Blocks a specific player sending you gifts. |
/giftunblock <player> | Unblocks a specific player, allowing them to send you gifts. |
/giftaccept | You will accept gifts from all players (default) |
/giftdeny | You will not accept gifts from players, gift sender will receive message saying you do not wish to receive gifts. |
Admin Commands | Description |
/eg stats | Lists various Easy Gift stats. (Must have logging enabled to see gift stats) |
/eg check | Check if update is available for Easy Gift. |
/eg stop | Stops all gift sending. |
/eg start | Starts all gift sending. |
Permissions | Description |
---|---|
easygift.gift | Allows player to send gifts. |
easygift.gift.block | Allows player to block a specific player sending them gifts. |
easygift.gift.unblock | Allows player to let a specific player send them gifts. |
easygift.gift.accept | Allows player to accept all gifts sent to them. |
easygift.gift.deny | Allows player to deny all gifts sent to them. |
easygift.admin | Allows player to access admin commands. |
Config | Description |
---|---|
save-log | Enables or disables logging player gifts. |
receipts | Enables or disables receipts being sent to players. |
cooldown | Enables or disables cooldowns between sending gifts. |
cooldown-time | Time between sending gifts (default 60,000ms = 60 seconds). |
update-check | Enable or disables update checking. |
banned-items | List of banned items that cannot be sent as gifts. |
Bugs
- Cooldown will not end. (Removed cooldowns in v1.4.2)
The following items will not be sent properly.Enchanted items - Will remove enchantment.Named items - Will remove name.Items with lore - Lore will be removed.Written books - Will send empty written book.Items with durability - Durability will be reset.Enchanted books
If you find any other bugs, please submit a ticket.
There should be a way to limit the amount you send to a person. Let's say I have a stack of smooth stone in my hand. I would type /gift Bluemarien 47 and I'd only send 47 of my 64 smooth stone. I've seen that in another gifting plugin, and I like the feature. :D
@Awesomeman2
I will do soon, I'm completely reorganizing the code at the moment. Once that's finished it will be on Github.
@Emmsii
Make it open sourced?
@Iwitrag I like the "send a message with the gift" idea, I'll try and get that in one of the next updates. I'm looking to get admin commands and permissions working for the next update, all items will come after that.
Well, if you implement permissions, admin commands and support all items (with names, lores, books, etc...) it will be great plugin! Suggestion: Change /gift player to /gift player <text>.. user can (but don't have to) send a message with his gift...