BetterQoL - Enhance Your Minecraft Experience

BetterQoL is a comprehensive Quality of Life mod that brings powerful inventory management, intelligent mining tools, movement helpers, and useful overlays to your Minecraft gameplay. Every feature is fully configurable and designed to work seamlessly together.

🔧 Vein Miner

Mine entire ore veins, trees, or crop fields with a single action. Vein Miner intelligently breaks connected blocks while respecting tool requirements, enchantments, and game rules.

Multiple activation modes: Toggle, hold key, or always on
Three search shapes: VEIN (flood fill), COLUMN (vertical), and TUNNEL (geometric volumes)
Configurable tunnels: 3x3, 5x5, or 7x7 cross-sections with adjustable depth
Enchantment scaling: Vein size increases with enchantment level (8/16/32/64/128 blocks)
Resource costs: Optional XP or hunger costs that scale with blocks broken
Farmer mode: Harvest crops and vertical plants with automatic replanting
Undo system: Reverse accidental activations
Fully configurable: Tool restrictions, block whitelists/blacklists, durability handling, and more

Perfect for: Mining operations, tree harvesting, farming, and large-scale building projects.

📦 Better Inventory

Streamline your inventory management with powerful sorting, bulk transfer, smart filtering features, and automated item distribution.

One-click sorting: Middle-click any slot to sort player inventory or containers
Bulk transfers: Ctrl + middle-click to move all matching stacks, or Shift + drag to transfer multiple slots
Quick deposit: Shift + double-click containers in the world to auto-deposit matching items
Chest tag filtering: Assign tags to chests, barrels, and shulker boxes for automatic item organization
Matched item transfer: Shift + double-click a slot to transfer all matching items from your inventory
Controller system: Use crafting tables as controllers to distribute items to nearby chests with a single action
Custom tags: Create your own item groups using Minecraft tags or individual items
Default tags included: Pre-configured tags for stones, logs, ores, crops, building blocks, wood, food, tools, armor, redstone, dyes, mob drops, and decorative blocks

Perfect for: Organizing storage systems, managing large inventories, automated sorting, and reducing repetitive clicking.

🏃 Better Movement

Reduce repetitive inputs with automatic movement helpers that keep you in control.

Auto-Run: Toggle automatic forward movement with smart sprinting
Auto-Jump: Automatic jumping with obstacle detection and cooldown system
Smart cancellation: Auto-Run stops on damage, GUI open, or manual input
Mount support: Optional mount and boat compatibility
Configurable behavior: Adjust cooldowns, obstacle detection, and stop conditions

Perfect for: Long-distance travel, exploration, and reducing hand strain during extended play sessions.

📊 Better Stats

Keep important information visible without cluttering your screen or opening the debug menu.

Customizable overlay: Show FPS, ping, coordinates, biome, entities, and memory usage
Drag-and-drop layout: Reposition any stat block to your preferred location
Chat sharing: Shift + click overlay entries to send values to chat
Context-aware: Automatically hides during pause, HUD off, or configuration screens
Individual toggles: Enable or disable each stat independently

Perfect for: Performance monitoring, coordinate sharing, and keeping track of important game information.

🔍 Zoom

Enhanced zoom functionality with smooth controls and cinematic camera integration.

Hold-to-zoom: Hold the key to zoom in, release to return to normal
Adjustable zoom: Scroll wheel adjusts zoom level from 0.01x to 1.0x
Cinematic camera: Automatically enables smooth camera movement while zoomed
Client-side only: No server impact, purely visual enhancement

Perfect for: Building details, exploration, and getting a better view of distant areas.

Quick Start

Install the mod - BetterQoL requires NeoForge for Minecraft 1.21+
Configure features - Open Options → BetterQoL to customize each module
Set keybindings - Go to Options → Controls → BetterQoL to bind keys
Start playing - All features work out of the box with sensible defaults

Configuration

BetterQoL uses a modular configuration system with separate files for different settings:

betterqol-common.toml - Server-side settings (Vein Miner, Better Inventory)
betterqol-client.toml - Client-side settings (Movement, Stats, Zoom)

Each feature can be enabled or disabled independently, and most settings can be changed in-game through the config screens.

Keybindings

All keybindings can be customized in Options → Controls → BetterQoL:

Vein Miner Toggle - Activate/deactivate Vein Miner
Undo Vein Miner - Reverse last Vein Miner action
Cycle Shape Mode - Switch between search shapes
Open Shape Config - Configure tunnel dimensions
Toggle Auto-Run - Enable/disable automatic forward movement (default: R)
Toggle Auto-Jump - Enable/disable automatic jumping (default: J)
Zoom - Hold to zoom in (default: Z)

Requirements

Minecraft: 1.21+
NeoForge: Latest version for your Minecraft version
Java: 21 or higher

Compatibility

BetterQoL is designed to be compatible with most mods. All features use standard Minecraft APIs and should work alongside other quality of life mods. Server-side features (Vein Miner, Better Inventory) require the mod on both client and server for full functionality.

Enjoy a better Minecraft experience with BetterQoL!

Better QoL