GiftEvents

Enjoy your Cake

About

This plugin handles giving out gifts to players when they join on certain types of days:

  • Their birthday if registered
  • Their first played anniversary
  • Arbitrary defined dates

For any event an announcement can optionally be made to all players. For instance, for their birthday you might configure a message letting everyone know its their birthday. Gifts can optionally be received after an event should the player miss logging on. You can configure any number of items to give to a player and each item can have any number of enchantments. Items are given when the player logs on.

Safeguards are in place to keep a player from changing their birthday to get additional gifts and to keep announcements from occurring too frequently. Even if the player changes their configured birthday to another date they will not receive another gift till the following year.

McStats

GiftEvents is using McStats to collect some data such as operating system, java version, Amount of players and some more.
You can learn more about it here.

You can disable it in the config file in the plugin directory.
GiftEvents Stats

Screenshot

Enjoy your Cake

Commands

  • /birthday get - Gets a player's birthday if set
  • /birthday set MM-dd - Sets the birthday for a player
  • /anniversary - Gets a player's first play anniversary, the date when they first joined the server
  • /events list - Lists all configured events and their dates
  • /events info - Detailed info about an event, including which gifts are given
  • /events give - Admin command to give the items from an event to a player
  • /events reset - Admin command to reset the gift status of a player for an event
  • /events reload - Reloads the events config file from disk

Configuration

The are a few options in the config file, but most modifications take place in the events file. Both contains plenty of comments and examples to help you get started configuring events.

When configuring items use either the Minecraft item id number or a name as it appears in the Bukkit Material class documentation. For enchantments you can again use a numerical enchantment id or the enchantment's name in the Bukkit Enchantment class documentation. In case of spawn eggs use 383 as ID and the entity ID as damage value. All entity types can be found in the official Minecraft wiki.

When testing a configuration use the "/events reload" command to check for errors without needing to restart the server.

Permissions

The permissions are very simple and allow you restrict access for certain users:

  • giftevents.birthday - Default: true
  • giftevents.anniversary - Default: true
  • giftevents.events - Default: true
  • giftevents.incremental - Default: true
  • giftevents.admin - Default: false

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of jh93267 jh93267 Feb 19, 2015 at 19:17 UTC - 0 likes

    Just picked it up. I will be testing it later this evening after my homework is done. Thanks so much for this.

  • Avatar of Aubli Aubli Feb 18, 2015 at 13:26 UTC - 0 likes

    @jh93267: Go

    I implemented your requested feature and uploaded a new version.

    After it is approved please test it out and tell me what you think. It probably has a lot of errors and could misbehave. It is currently in beta and should not be used in a productive environment!

    BFAK:90841244,1b90c6b8a0ce3d5b9664336451e015d7e8e1fe7f501ff306c21cc6c22c2866f6

  • Avatar of jh93267 jh93267 Feb 17, 2015 at 05:49 UTC - 0 likes

    Awesome, thanks for the quick reply. I will keep checking in to see how things are going.

  • Avatar of Aubli Aubli Feb 16, 2015 at 08:25 UTC - 0 likes

    @jh93267: Go

    It is currently not possible but your Idea is really good.

    I will add something for you.

    Last edited Feb 16, 2015 by Aubli
  • Avatar of jh93267 jh93267 Feb 16, 2015 at 02:11 UTC - 0 likes

    Thanks for the plugin, my family really likes it. The question I had for you is this: Can you set up multiple login events? Example: day 1 they get a gift, day 2 they get another gift (different gift), and so on. This would allow one to set up daily gifts based on the day they joined the server and in a sense be used to accumulate days and gifts. In any case if this is possible please let me know. Thanks.

  • Avatar of Aubli Aubli Feb 13, 2015 at 04:58 UTC - 0 likes

    @Ironic8b49: Go

    Thank you for the report. I am gonna fix that soon.

  • Avatar of Ironic8b49 Ironic8b49 Feb 12, 2015 at 23:56 UTC - 1 like

    @Aubli: Go

    gift_on_first_join was set to true but I didn't want that option so I set it to false now, I tried to run /events list [player] got internal error so I re-downloaded the plugin in case i got a bad download and still get same error

    [19:04:17] [Server thread/ERROR]: null org.bukkit.command.CommandException: Unhandled exception executing command 'events' in plugin GiftEvents v2.3 at org.bukkit.command.PluginCommand.execute(PluginCommand.java:46) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:141) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at org.bukkit.craftbukkit.v1_8_R1.CraftServer.dispatchCommand(CraftServer.java:646) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.PlayerConnection.handleCommand(PlayerConnection.java:1115) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.PlayerConnection.a(PlayerConnection.java:950) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.PacketPlayInChat.a(PacketPlayInChat.java:26) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.PacketPlayInChat.a(PacketPlayInChat.java:53) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.PacketHandleTask.run(SourceFile:13) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:471) [?:1.7.0_75] at java.util.concurrent.FutureTask.run(FutureTask.java:262) [?:1.7.0_75] at net.minecraft.server.v1_8_R1.MinecraftServer.z(MinecraftServer.java:683) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.DedicatedServer.z(DedicatedServer.java:316) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.MinecraftServer.y(MinecraftServer.java:623) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at net.minecraft.server.v1_8_R1.MinecraftServer.run(MinecraftServer.java:526) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] at java.lang.Thread.run(Thread.java:745) [?:1.7.0_75] Caused by: java.lang.NullPointerException at com.github.omwah.giftevents.command.EventsListCommand.execute(EventsListCommand.java:61) [?:?] at giftevents.com.github.omwah.omcommands.CommandHandler.dispatch(CommandHandler.java:103) [?:?] at giftevents.com.github.omwah.omcommands.NestedCommandExecutor.onCommand(NestedCommandExecutor.java:72) [?:?] at org.bukkit.command.PluginCommand.execute(PluginCommand.java:44) [craftbukkit.jar:git-Spigot-d0d1d87-15e81cf] ... 14 more

    Last edited Feb 13, 2015 by Ironic8b49
  • Avatar of Aubli Aubli Feb 12, 2015 at 15:44 UTC - 0 likes

    @Ironic8b49: Go

    There is an option in the config file to enable or disable gift_on_first_join.

    But even if enabled the player should only get it only once per year.

    You can check with: /events list [PLAYER]

    true means he has received the gift and the number means how many times the announcement was displayed.

    Hope I could help you.

  • Avatar of Aubli Aubli Feb 11, 2015 at 16:53 UTC - 0 likes

    @Ironic8b49: Go

    I will see what i can do about it.

  • Avatar of Ironic8b49 Ironic8b49 Feb 11, 2015 at 04:12 UTC - 0 likes

    I have a first time player which told me they get 5 diamonds every time they log in on the same day they first joined. thought you said they would have to wait a year for the anniversary event to work.

Facts

Date created
Mar 05, 2013
Category
Last update
Feb 18, 2015
Development stage
Release
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
GiftEvents
Downloads
1,778
Recent files
  • B: v2.4 for 1.8.1 Feb 18, 2015
  • R: v2.3.1 for 1.8.1 Feb 17, 2015
  • R: v2.3 for 1.8.1 Feb 06, 2015
  • B: v2.2 for CB 1.7.9-R0.2 Nov 01, 2014
  • R: v2.1 for CB 1.7.9-R0.1 Jun 13, 2014

Authors