feat: Auto Wind Charge (#6770)

Author: 1zun4

src/main/kotlin/net/ccbluex/liquidbounce/features/module/ModuleManager.kt

@@ -325,6 +325,7 @@ object ModuleManager : EventListener, Iterable<ClientModule> by modules {
             ModuleAutoBreak,
             ModuleAutoFish,
             ModuleAutoRespawn,
+            ModuleAutoWindCharge,
             ModuleOffhand,
             ModuleAutoShop,
             ModuleAutoWalk,

src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/player/ModuleAutoWindCharge.kt

@@ -0,0 +1,114 @@
+/*
+ * This file is part of LiquidBounce (https://github.com/CCBlueX/LiquidBounce)
+ *
+ * Copyright (c) 2015 - 2025 CCBlueX
+ *
+ * LiquidBounce is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * LiquidBounce is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with LiquidBounce. If not, see <https://www.gnu.org/licenses/>.
+ */
+package net.ccbluex.liquidbounce.features.module.modules.player
+
+import net.ccbluex.liquidbounce.config.types.nesting.ToggleableConfigurable
+import net.ccbluex.liquidbounce.event.tickHandler
+import net.ccbluex.liquidbounce.features.module.Category
+import net.ccbluex.liquidbounce.features.module.ClientModule
+import net.ccbluex.liquidbounce.features.module.modules.player.ModuleAutoWindCharge.Rotate.rotations
+import net.ccbluex.liquidbounce.utils.aiming.RotationManager
+import net.ccbluex.liquidbounce.utils.aiming.RotationsConfigurable
+import net.ccbluex.liquidbounce.utils.aiming.data.Rotation
+import net.ccbluex.liquidbounce.utils.combat.CombatManager
+import net.ccbluex.liquidbounce.utils.entity.FallingPlayer
+import net.ccbluex.liquidbounce.utils.entity.getMovementDirectionOfInput
+import net.ccbluex.liquidbounce.utils.input.isPressed
+import net.ccbluex.liquidbounce.utils.inventory.Slots
+import net.ccbluex.liquidbounce.utils.inventory.useHotbarSlotOrOffhand
+import net.ccbluex.liquidbounce.utils.kotlin.Priority
+import net.ccbluex.liquidbounce.utils.movement.DirectionalInput
+import net.minecraft.client.util.InputUtil
+import net.minecraft.item.Items
+
+/**
+ * Uses wind charges to boost yourself up when holding jump.
+ */
+object ModuleAutoWindCharge : ClientModule("AutoWindCharge", Category.PLAYER) {
+
+    private object Rotate : ToggleableConfigurable(this, "Rotate", true) {
+        val rotations = tree(RotationsConfigurable(this))
+    }
+
+    private object HorizontalBoost : ToggleableConfigurable(this, "HorizontalBoost", true) {
+        val pitch by float("Pitch", 70f, 0f..90f)
+        val boostKey by key("Key", InputUtil.GLFW_KEY_LEFT_CONTROL)
+    }
+
+    init {
+        treeAll(HorizontalBoost, Rotate)
+    }
+
+    private val combatPauseTime by int("CombatPauseTime", 0, 0..40, "ticks")
+    private val slotResetDelay by intRange("SlotResetDelay", 0..0, 0..40, "ticks")
+
+    /**
+     * 7 ticks is the perfect time to use a wind charge before hitting the ground,
+     * and drastically boosts us higher.
+     */
+    const val PREDICTION_TICKS = 7
+
+    @Suppress("unused")
+    private val autoWindChargeHandler = tickHandler {
+        if (player.isGliding || player.isSwimming || player.isInFluid || !mc.options.jumpKey.isPressed) {
+            return@tickHandler
+        }
+
+        val collision = FallingPlayer
+            .fromPlayer(player)
+            .findCollision(PREDICTION_TICKS) ?: return@tickHandler
+
+        val itemSlot = Slots.OffhandWithHotbar.findSlot(Items.WIND_CHARGE) ?: return@tickHandler
+
+        val isHorizontalBoost = HorizontalBoost.enabled && HorizontalBoost.boostKey.isPressed
+        val directionYaw = getMovementDirectionOfInput(player.yaw,
+            DirectionalInput(player.input)) - 180f
+        val directionPitch = when {
+            isHorizontalBoost -> HorizontalBoost.pitch
+            else -> 90f
+        }
+
+        var rotation = Rotation(directionYaw, 80f)
+
+        if (Rotate.enabled) {
+            fun isRotationSufficient(): Boolean {
+                return RotationManager.serverRotation.angleTo(rotation) <= 1.0f
+            }
+
+            waitConditional(20) {
+                CombatManager.pauseCombatForAtLeast(combatPauseTime)
+                RotationManager.setRotationTarget(
+                    rotations.toRotationTarget(rotation),
+                    Priority.IMPORTANT_FOR_USAGE_3,
+                    this@ModuleAutoWindCharge
+                )
+
+                isRotationSufficient()
+            }
+
+            if (!isRotationSufficient()) {
+                return@tickHandler
+            }
+        }
+
+        val (yaw, pitch) = rotation.normalize()
+        useHotbarSlotOrOffhand(itemSlot, slotResetDelay.random(), yaw, pitch)
+    }
+
+}

src/main/resources/resources/liquidbounce/lang/en_us.json

@@ -730,5 +730,6 @@
   "liquidbounce.module.noEntityInteract.description": "Prevents you from interacting with entities.",
   "liquidbounce.module.autoPearl.description": "Aims and throws a pearl at an enemies pearl trajectory.",
   "liquidbounce.module.replenish.description": "Automatically refills your hotbar with items from your inventory when the count drops to a certain threshold.",
-  "liquidbounce.module.anchor.description": "Pulls you into safe holes for crystal PvP."
+  "liquidbounce.module.anchor.description": "Pulls you into safe holes for crystal PvP.",
+  "liquidbounce.module.autoWindCharge.description": "Automatically boosts you using wind charges when holding jump."
 }