[Bleeding] Inventory framework and events. Addresses BUKKIT-856

New events:
- InventoryOpenEvent
- InventoryClickEvent - detects any clicks on a slot or outside the window
  - In the creative inventory view, only clicks on the quickbar are detected
- InventoryCloseEvent
- BrewEvent - when a potion finishes brewing
- CraftItemEvent (a subevent of InventoryClickEvent) - fired when taking the crafted item
- PrepareItemCraftEvent - fired just before updating the result slot
Changes to existing events:
- EnchantItemEvent extends InventoryEvent and also has a new whichButton() method
- PrepareItemEnchantEvent also extends InventoryEvent
- FurnaceBurnEvent and FurnaceSmeltEvent now extend BlockEvent (as does BrewEvent)
- PlayerInventoryEvent is deprecated (though it never did anything anyway)
New subclasses of Inventory:
- BrewerInventory
- CraftingInventory
- DoubleChestInventory
- EnchantingInventory
- FurnaceInventory
New methods in Inventory:
- getViewers()
- getTitle()
- getType()
- getHolder()
- iterator() - Yes, inventories are now iterable!
  - The iterator is a ListIterator that does not support add or remove
New methods in Player:
- getOpenInventory()
- openInventory()
- openWorkbench()
- openEnchanting()
- closeInventory()
- setWindowProperty()
- getItemOnCursor()
- setItemOnCursor()
Other changes:
- createInventory() methods in Server to make inventories not linked to an object
- ContainerBlock is deprecated in favour of InventoryHolder
- New InventoryView class gives direct access to an inventory window!
- Removed the Slot class which did nothing and was used nowhere

Some small credit goes to Afforess (initial conception of openInventory() methods) and Drakia (initial conception of InventoryOpenEvent and InventoryCloseEvent).

By: Celtic Minstrel <celtic.minstrel.ca@some.place>
This commit is contained in:
Bukkit/Spigot
2012-02-29 13:32:33 -05:00
parent da943825be
commit c180de46e2
31 changed files with 1074 additions and 68 deletions

View File

@@ -19,6 +19,9 @@ import org.bukkit.entity.Snowball;
import org.bukkit.entity.Vehicle;
import org.bukkit.event.entity.EntityDamageEvent;
import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
import org.bukkit.inventory.Inventory;
import org.bukkit.inventory.InventoryView;
import org.bukkit.inventory.InventoryView.Property;
import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.PlayerInventory;
import org.bukkit.map.MapView;
@@ -679,4 +682,40 @@ public class TestPlayer implements Player {
public <T> void playEffect(Location loc, Effect effect, T data) {
throw new UnsupportedOperationException("Not supported yet.");
}
public InventoryView getOpenInventory() {
throw new UnsupportedOperationException("Not supported yet.");
}
public InventoryView openInventory(Inventory inventory) {
throw new UnsupportedOperationException("Not supported yet.");
}
public InventoryView openWorkbench(Location location, boolean force) {
throw new UnsupportedOperationException("Not supported yet.");
}
public void openInventory(InventoryView inventory) {
throw new UnsupportedOperationException("Not supported yet.");
}
public void closeInventory() {
throw new UnsupportedOperationException("Not supported yet.");
}
public InventoryView openEnchanting(Location location, boolean force) {
throw new UnsupportedOperationException("Not supported yet.");
}
public ItemStack getItemOnCursor() {
throw new UnsupportedOperationException("Not supported yet.");
}
public void setItemOnCursor(ItemStack item) {
throw new UnsupportedOperationException("Not supported yet.");
}
public boolean setWindowProperty(Property prop, int value) {
throw new UnsupportedOperationException("Not supported yet.");
}
}