Add ApolloPlayerUseItemBucketEvent API

Author: ItsNature

.github/workflows/deploy.yml

@@ -41,7 +41,7 @@ jobs:
                 fi
 
         -   name: Gradle Publish
-            if: "${{ github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/heads/version/') }}"
+            if: "${{ github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/heads/version/') || github.ref == 'refs/heads/feature/bucket-desync' }}"
             run: ./gradlew publish
 
         -   name: Gradle Release

api/src/main/java/com/lunarclient/apollo/event/packetenrichment/world/ApolloPlayerUseItemBucketEvent.java

@@ -0,0 +1,73 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.event.packetenrichment.world;
+
+import com.lunarclient.apollo.event.Event;
+import com.lunarclient.apollo.module.packetenrichment.PlayerInfo;
+import com.lunarclient.apollo.module.packetenrichment.raytrace.RayTraceResult;
+import com.lunarclient.apollo.player.ApolloPlayer;
+import lombok.Value;
+
+/**
+ * Represents an event that is fired when a player uses a bucket (1.7 and 1.8).
+ *
+ * @since 1.2.2
+ */
+@Value
+public class ApolloPlayerUseItemBucketEvent implements Event {
+
+    /**
+     * The player that sent the packet.
+     *
+     * @return the player
+     * @since 1.2.2
+     */
+    ApolloPlayer player;
+
+    /**
+     * The {@code long} representing the unix timestamp
+     * when the packet was created.
+     *
+     * @return the unix timestamp
+     * @since 1.2.2
+     */
+    long instantiationTimeMs;
+
+    /**
+     * The player's {@link PlayerInfo} information.
+     *
+     * @return the player info
+     * @since 1.2.2
+     */
+    PlayerInfo playerInfo;
+
+    /**
+     * The player's {@link RayTraceResult}.
+     *
+     * @return the ray trace result
+     * @since 1.2.2
+     */
+    RayTraceResult rayTraceResult;
+
+}

api/src/main/java/com/lunarclient/apollo/event/packetenrichment/world/ApolloPlayerUseItemEvent.java

@@ -29,7 +29,7 @@
 import lombok.Value;
 
 /**
- * Represents an event that is when a player uses an item (1.16.1+).
+ * Represents an event that is fired when a player uses an item (1.16.1+).
  *
  * @since 1.0.7
  */

api/src/main/java/com/lunarclient/apollo/module/packetenrichment/raytrace/BlockHitResult.java

@@ -0,0 +1,64 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.module.packetenrichment.raytrace;
+
+import com.lunarclient.apollo.common.location.ApolloBlockLocation;
+import com.lunarclient.apollo.common.location.ApolloLocation;
+import lombok.Builder;
+import lombok.Getter;
+
+/**
+ * Represents the block hit ray trace result.
+ *
+ * @since 1.2.2
+ */
+@Getter
+@Builder
+public class BlockHitResult extends RayTraceResult {
+
+    /**
+     * The exact hit {@link ApolloLocation} of the ray on the block.
+     *
+     * @return the hit location
+     * @since 1.2.2
+     */
+    ApolloLocation hitLocation;
+
+    /**
+     * The {@link ApolloBlockLocation} of the block that was hit.
+     *
+     * @return the block location
+     * @since 1.2.2
+     */
+    ApolloBlockLocation blockLocation;
+
+    /**
+     * The {@link Direction} from which the block was hit.
+     *
+     * @return the direction
+     * @since 1.2.2
+     */
+    Direction direction;
+
+}

api/src/main/java/com/lunarclient/apollo/module/packetenrichment/raytrace/Direction.java

@@ -0,0 +1,38 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.module.packetenrichment.raytrace;
+
+/**
+ * Represents a direction in which a block was hit.
+ *
+ * @since 1.2.2
+ */
+public enum Direction {
+    DOWN,
+    UP,
+    NORTH,
+    SOUTH,
+    WEST,
+    EAST
+}

api/src/main/java/com/lunarclient/apollo/module/packetenrichment/raytrace/EntityHitResult.java

@@ -0,0 +1,56 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.module.packetenrichment.raytrace;
+
+import com.lunarclient.apollo.common.ApolloEntity;
+import com.lunarclient.apollo.common.location.ApolloLocation;
+import lombok.Builder;
+import lombok.Getter;
+
+/**
+ * Represents the entity hit ray trace result.
+ *
+ * @since 1.2.2
+ */
+@Getter
+@Builder
+public class EntityHitResult extends RayTraceResult {
+
+    /**
+     * The exact hit {@link ApolloLocation} of the ray on the entity.
+     *
+     * @return the hit location
+     * @since 1.2.2
+     */
+    ApolloLocation hitLocation;
+
+    /**
+     * The {@link ApolloEntity} that was hit.
+     *
+     * @return the entity ID
+     * @since 1.2.2
+     */
+    ApolloEntity entityId;
+
+}

api/src/main/java/com/lunarclient/apollo/module/packetenrichment/raytrace/MissResult.java

@@ -0,0 +1,33 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.module.packetenrichment.raytrace;
+
+/**
+ * Represents the missed ray trace result.
+ *
+ * @since 1.2.2
+ */
+public class MissResult extends RayTraceResult {
+
+}

api/src/main/java/com/lunarclient/apollo/module/packetenrichment/raytrace/RayTraceResult.java

@@ -0,0 +1,33 @@
+/*
+ * This file is part of Apollo, licensed under the MIT License.
+ *
+ * Copyright (c) 2023 Moonsworth
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+package com.lunarclient.apollo.module.packetenrichment.raytrace;
+
+/**
+ * The abstract base class for ray trace results.
+ *
+ * @since 1.2.2
+ */
+public abstract class RayTraceResult {
+
+}

common/src/main/java/com/lunarclient/apollo/module/packetenrichment/PacketEnrichmentImpl.java

@@ -28,11 +28,13 @@
 import com.lunarclient.apollo.event.packetenrichment.chat.ApolloPlayerChatCloseEvent;
 import com.lunarclient.apollo.event.packetenrichment.chat.ApolloPlayerChatOpenEvent;
 import com.lunarclient.apollo.event.packetenrichment.melee.ApolloPlayerAttackEvent;
+import com.lunarclient.apollo.event.packetenrichment.world.ApolloPlayerUseItemBucketEvent;
 import com.lunarclient.apollo.event.packetenrichment.world.ApolloPlayerUseItemEvent;
 import com.lunarclient.apollo.network.NetworkTypes;
 import com.lunarclient.apollo.packetenrichment.v1.PlayerAttackMessage;
 import com.lunarclient.apollo.packetenrichment.v1.PlayerChatCloseMessage;
 import com.lunarclient.apollo.packetenrichment.v1.PlayerChatOpenMessage;
+import com.lunarclient.apollo.packetenrichment.v1.PlayerUseItemBucketMessage;
 import com.lunarclient.apollo.packetenrichment.v1.PlayerUseItemMessage;
 
 /**
@@ -109,6 +111,21 @@ private void onReceivePacket(ApolloReceivePacketEvent event) {
                 throwable.printStackTrace();
             }
         });
+
+        event.unpack(PlayerUseItemBucketMessage.class).ifPresent(packet -> {
+            ApolloPlayerUseItemBucketEvent playerUseItemBucketEvent = new ApolloPlayerUseItemBucketEvent(
+                event.getPlayer(),
+                NetworkTypes.fromProtobuf(packet.getPacketInfo().getInstantiationTime()),
+                NetworkTypes.fromProtobuf(packet.getPlayerInfo()),
+                NetworkTypes.fromProtobuf(packet.getRayTraceResult())
+            );
+
+            EventBus.EventResult<ApolloPlayerUseItemBucketEvent> result = EventBus.getBus().post(playerUseItemBucketEvent);
+
+            for (Throwable throwable : result.getThrowing()) {
+                throwable.printStackTrace();
+            }
+        });
     }
 
 }