LightFalling

LightFalling is a Fabric client-side mod focused on practical quality-of-life features for daily gameplay, including automation helpers, visual overlays, HUD modules, and utility commands.

Overview

• Mod type: Fabric client mod (environment: client)
• Minecraft version: 1.21.11
• Language: Kotlin + Java
• Java version: 21
• Build system: Gradle + Fabric Loom
• Main entrypoint: src/main/kotlin/top/teanli/lightfalling/Lightfalling.kt

Core Capabilities

Player Utilities

• AutoClicker: configurable left/right click automation with CPS range and jitter
• AutoTool: automatically switches to best hotbar tool for mining/attacking
• AutoFish: automatic cast/reel workflow based on splash packet detection
• AutoElytra: auto-equip Elytra while falling and optional swap-back behavior
• AutoFill: refills low-count hotbar stacks from inventory
• AntiAFK: periodic anti-idle actions (rotate, jump, move)
• Sprint, CustomFOV, BrightnessChanger

Display and HUD

• HUD: player status text (coordinates, facing, FPS/TPS/MSPT, movement states)
• ArmorHUD / HandItemsHUD: draggable item overlays with durability rendering
• CompassHUD: top-center direction indicator
• CropGrowthIndicator: crop growth overlay in 2D/3D
• RedstoneIndicator: redstone signal visualization in 2D/3D
• ShulkerBoxTooltip: preview shulker box contents in tooltip
• HealthDisplay: health text above nearby entities

World Utilities

• AutoMine: continuous mining for selected target blocks
• DamageIndicator: floating damage text
• DeathPoint: records last death position
• ExplosiveTimer: TNT and creeper detonation timing overlay
• TimeChanger: configurable world time setting module

Architecture Summary

This order matters because modules/settings must be ready before config load and commands.

Build and Run

.\gradlew.bat build
.\gradlew.bat runClient

License

MIT License. See LICENSE.txt.