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 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.

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.admin - Default: false

Code

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

  • Avatar of Aubli Aubli Aug 23, 2014 at 20:52 UTC - 0 likes

    @sparts: Go

    Hi sparts,
    You mean that the player is able to run a command because of an event?

    I found no way to make custom fireworks without code changes, so it will take some days to add this.

    You can add more items with a new line. For different names just use 'name: "The item name here" '.

    Example:

    bread-day:
    date: 08-24
    belated: False
    gift:
    items:
    - { id: BREAD, amount: 2 , name: "Your Bread!" } # 2 breads named 'Your Bread!'
    - { id: WHEAT, amount: 10, name: "The Wheat to make bread!" }
    message: "Happy Bread Day %1$s, check your inventory for more bread!"




    Hope i could help you.

    BFAK:90841244,1b90c6b8a0ce3d5b9664336451e015d7e8e1fe7f501ff306c21cc6c22c2866f6

  • Avatar of sparts sparts Aug 22, 2014 at 23:08 UTC - 0 likes

    I tried this plugin and it seems to run pretty well. I would really like to be able to run a command for the first time you log on during the event.

    How do you add multiple items with different names? I would like to give more than one type of item, but they are all named the same. I can't figure out how to make custom fireworks. An example that I normally use is:

    - 401 2 color:red,black fade:green,white type:star power:2

    It gives you 2 red/black star fireworks that fades to green/white with power 2

  • Avatar of Aubli Aubli Jun 09, 2014 at 10:33 UTC - 0 likes

    @otterun: Go

    It's possible to gift spawn eggs. Just use 383 as the item id and the Entity-Ids as damage values. You can find all entities in this table.


    Simple example for Skeletons:

    Monster-Day:
    date: 06-09
    belated: False
    gift:
    items:
    - { id: 383, damage: 51}
    name: "Monster"
    message: "Take that Egg."


    About Age:
    It's possible too, but only around several corners (Spawn entity manually and set its age).

  • Avatar of Aubli Aubli Jun 06, 2014 at 19:44 UTC - 1 like

    Hello Guys, I am the new Maintainer of GiftEvents.

    The next things i'll be working on are:

    Aubli (Alex)

  • Avatar of omwah omwah Jun 04, 2014 at 19:00 UTC - 0 likes

    @otterun: Go

    It is probably not possible as written currently since they are entities and not items. But I would welcome anyone to take a crack at modifying the plugin to support it.

  • Avatar of otterun otterun Jun 03, 2014 at 06:49 UTC - 0 likes

    @omwah: This Plugin is tons of fun! My server mates and I love it! I did have a question about gifting spawn eggs. Is it possible? It's not on the material class documentation list and I'm having trouble finding the proper item IDs.

    If it is possible to gift spawn eggs, I was also wondering if we could go as far as to set their age. I was looking at this page: http://jd.bukkit.org/dev/apidocs/org/bukkit/entity/Ageable.html#setAgeLock(boolean) And now I really want to give everyone permanent baby wolves. :P

    Any info you have would be fantastic. Again, GREAT plugin!

  • Avatar of MisterMystery MisterMystery May 21, 2013 at 01:23 UTC - 0 likes

    @omwah: Go

    I am using the new one with the events.yml. Thank you for the correction!

    while we're exchanging ideas: These are the two that I've added to your default that seem to work now (thank you)

    halloween: date: 10-31 belated: False gift: items: - { id: POISONOUS_POTATO } # Poison Potato - { id: GOLDEN_APPLE } - { id: 91, amount: 2 } # Two jack-o-lanters name: "Trick or Treat!" message: "Happy Halloween %1$s, check your inventory for a gift!"

    valentines: date: 02-14 belated: False gift: items: - { id: RED_ROSE, enchantments: {ARROW_INFINITE: 1} } name: "I love you!" message: "Happy Valentines Day %1$s, check your inventory for a gift!">>

    <</code>>

    I"m currently brainstorming ideas for St. Patricks day and 4th of July (maybe just lots of fireworks?) And I like the idea of giving 9 torches (candles) on Hannukah - but its different every year. So its hard. :) Or perhaps 1 torch on every new day of Hannukah.

    Anyway, awesome plugin I really love it.

    Last edited May 21, 2013 by MisterMystery
  • Avatar of omwah omwah May 21, 2013 at 00:24 UTC - 0 likes

    @MisterMystery: Go

    I also added an issue for myself to add this great example to the default events.yml file. You can see a better formatted copy of the configuration here.

    Thanks.

  • Avatar of omwah omwah May 21, 2013 at 00:06 UTC - 1 like

    The items line should be as follows:

        - { id: RED_ROSE, enchantments: {ARROW_INFINITE: 1} }
    

    The correct name for the rose is RED_ROSE. Also you need to specify a enchantment level for the ARROW_INFINITE, above I put 1.

    Check the Bukkit Material page for the correct name of items:
    http://jd.bukkit.org/beta/apidocs/org/bukkit/Material.html

    Also if you are using the latest version of the plugin then the events now go in events.yml. This is to keep the plugin from crashing due to incorrect syntax. When you run this version for the first time it will move things out of config.yml. Or you can just back up your old plugins/GiftEvents dir and let the plugin regenerate from the defaults.

    When you do edit the events.yml you can check it without reloading the server by using the "/events reload" command.

    Last edited May 21, 2013 by omwah
  • Avatar of MisterMystery MisterMystery May 20, 2013 at 23:00 UTC - 0 likes

    @omwah: Go

    What am I doing wrong with this:

    valentines: date: 02-14 belated: False gift: items: - { id: ROSE, enchantments: {ARROW_INFINITE} } name: "I love you!" message: "Happy Valentines Day %1$s, check your inventory for a gift!"

    when I take it out /events works just fine. but when I add it to the events.yml and restart doing the command /events gives "events - ?" Which usually means there's an error.

Facts

Date created
Mar 05, 2013
Category
Last update
Nov 01, 2014
Development stage
Release
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
GiftEvents
Downloads
1,647
Recent files
  • 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
  • R: v2.0 for 1.5.2 May 09, 2013
  • R: v0.1.3 for 1.4.7 Mar 12, 2013
  • B: v0.1.2 for 1.4.7 Mar 10, 2013

Authors