PlayerItemHeldEvent Add Slot

Author: dG9hc3Q

README.md

@@ -31,36 +31,43 @@ You can download the latest release of Dionysus [here](https://github.com/nopjmp
 You can also [build it yourself](https://github.com/nopjmp/Dionysus#building)
 
 ## Plugin Developers
+###### *With each Dionysus update you must update your dependency.*
 
-In order to use Dionysus as a dependency you must [build it yourself](https://github.com/nopjmp/Dionysus#building).
-Each time you want to update your dependency you must re-build dionysus.
-
-Dionysus-API maven dependency:
+In order to use Dionysus as a dependency you must [build it yourself](https://github.com/nopjmp/Dionysus#building)      
+This will add it to your local maven repository folder. Then add the following to your `pom.xml`:
 
+#### Dionysus-API Maven Dependency:
 ```xml
-
 <dependency>
-  <groupId>dev.pomf.dionysusdev.pomf.dionysus</groupId>
-  <artifactId>dionysus-api</artifactId>
-  <version>1.12.2-R0.1-SNAPSHOT</version>
-  <scope>provided</scope>
+    <groupId>dev.pomf.dionysus</groupId>
+    <artifactId>dionysus-api</artifactId>
+    <version>1.12.2-R0.1-SNAPSHOT</version>
+    <scope>provided</scope>
 </dependency>
 ```
-
-Dionysus-Server maven dependency:
-
+#### Dionysus-Server Maven Dependency:
 ```xml
-
 <dependency>
-  <groupId>dev.pomf.dionysusdev.pomf.dionysus</groupId>
-  <artifactId>dionysus</artifactId>
-  <version>1.12.2-R0.1-SNAPSHOT</version>
-  <scope>provided</scope>
+    <groupId>dev.pomf.dionysus</groupId>
+    <artifactId>dionysus</artifactId>
+    <version>1.12.2-R0.1-SNAPSHOT</version>
+    <scope>provided</scope>
 </dependency>
 ```
 
-There is no repository required since the artifacts should be locally installed
-via building dionysus.
+#### Local Maven Repository:
+
+Windows: `C:\Users\<UserName>\.m2`
+Linux: `/home/<UserName>/.m2`
+Mac: `/Users/<UserName>/.m2`
+
+```xml
+<repository>
+    <id>project.local</id>
+    <name>project</name>
+    <url>file:/Users/User/.m2/repository/</url>
+</repository>
+```
 
 ## Building
 

patches/api/0012-PlayerItemHeldEvent-Add-Slot.patch

@@ -0,0 +1,65 @@
+From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
+From: RemainingToast <[email protected]>
+Date: Tue, 6 Sep 2022 00:43:38 +1000
+Subject: [PATCH] PlayerItemHeldEvent Add Slot
+
+
+diff --git a/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java b/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java
+index f0d055a0e4466e9487c87b4d771fd2c892aa373c..68777b55fa0756777a563351a870cc90e198ceab 100644
+--- a/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java
++++ b/src/main/java/org/bukkit/event/player/PlayerItemHeldEvent.java
+@@ -3,6 +3,7 @@ package org.bukkit.event.player;
+ import org.bukkit.entity.Player;
+ import org.bukkit.event.Cancellable;
+ import org.bukkit.event.HandlerList;
++import org.bukkit.inventory.ItemStack;
+ 
+ /**
+  * Fired when a player changes their currently held item
+@@ -10,13 +11,15 @@ import org.bukkit.event.HandlerList;
+ public class PlayerItemHeldEvent extends PlayerEvent implements Cancellable {
+     private static final HandlerList handlers = new HandlerList();
+     private boolean cancel = false;
+-    private final int previous;
+-    private final int current;
++    private final Slot previous; // Dionysus - Integer -> Slot
++    private final Slot current; // Dionysus - Integer -> Slot
+ 
+     public PlayerItemHeldEvent(final Player player, final int previous, final int current) {
+         super(player);
+-        this.previous = previous;
+-        this.current = current;
++        // Dionysus start - Integer -> Slot
++        this.previous = new Slot(this.player.getInventory().getItem(previous) , previous);
++        this.current = new Slot(this.player.getInventory().getItem(current), current);
++        // Dionysus end
+     }
+ 
+     /**
+@@ -24,7 +27,7 @@ public class PlayerItemHeldEvent extends PlayerEvent implements Cancellable {
+      *
+      * @return Previous slot index
+      */
+-    public int getPreviousSlot() {
++    public Slot getPreviousSlot() { // Dionysus - Integer -> Slot
+         return previous;
+     }
+ 
+@@ -33,7 +36,7 @@ public class PlayerItemHeldEvent extends PlayerEvent implements Cancellable {
+      *
+      * @return New slot index
+      */
+-    public int getNewSlot() {
++    public Slot getNewSlot() { // Dionysus - Integer -> Slot
+         return current;
+     }
+ 
+@@ -53,4 +56,8 @@ public class PlayerItemHeldEvent extends PlayerEvent implements Cancellable {
+     public static HandlerList getHandlerList() {
+         return handlers;
+     }
++
++    public record Slot(ItemStack item, int index) { // Dionysus - Integer -> Slot
++        
++    }
+ }