Bukkit

Effects

Aside from setting the amount of hearts, food bars or saturation to regenerate or what potion effects to add, you can add additional effects that don't qualify as potion effects. We'll get through all of those accessible in v0.6 step by step.

Arguments are generally split with the slash ( / ). To apply multiple effects, use the semicolon ( ; ). In some cases, you also can use two different numbers, one stating the min and the other one stating the max, so when 20,40 is given, a number from 20 to 40 is chosen.
(eg. "effect: [burn/20,30/24%;override]")

XP

food:
  apple:
    effect: [xp/10,100/80%]

In this case, the argument "10,100" will give the player between 10 and 100 xp. The percentage at the end is optional, it can be anywhere from 0% to 100%.

Burn

food:
  apple:
    effect: [burn/40/24%]

Set the player on fire. Arguments are optional. "40" is the time in seconds.

Clear

food:
  apple:
    effect: [clear/90%]

Clear all effects that the player had (same as milk bucket). Argument is optional.
This does not clear the effects that the player gets afterwards - If the player eats a spider eye, he will get poisoned! To avoid this, use override as well!
This will not affect the potion effects you have added.

Command

food:
  apple:
    effect: [cmd/me is eating an apple/95%]

Executes a command, in this case the /me command. May not include a secondary slash inside the command! Percentage at the end is optional.

Override

food:
  spider_eye:
    effect: [override]

All potion effects that the food item causes will be cancelled.
This will not affect the potion effects you have added.
Warning: This is done by cancelling the event and re-filling food bars and saturation levels. Might cause inventory bugs!

Cancel

food:
  apple:
    effect: [cancel]

Cancels the whole event, prevents the player from eating the food item. No other effects will be applied, health, food bars and saturation will not be restored.