Clean Background FPS

## Stop burning power in the background

You alt-tab to Discord, a browser or a video - and Minecraft keeps rendering 200+ frames per second that nobody sees. Your graphics card heats up, the fans spin loud, and on a laptop the battery drains.

**Clean Background FPS** fixes that automatically:

- **In the background** (another window active): limited to **15 FPS** - the game still updates, so you can glance at it on a second screen.
- **Minimized**: limited to **1 FPS** - practically no load at all.
- **Back in the game**: full speed again instantly.

## Features

- Lower FPS in the background and when minimized (both adjustable).
- Optional: lower or mute the game volume while in the background or minimized - your saved volume settings are never changed.
- Option to only slow down when minimized (keep full FPS on a second monitor).
- The world keeps running normally: only drawing frames is slowed, not the game itself - farms, timers and multiplayer keep going.
- Tiny and lightweight, no key bindings, works with other performance mods.

## Settings

The file `config/cleanbackgroundfps.properties` is created on first launch:

- `enabled` - on or off (default: true)
- `backgroundFps` - FPS when another window is active (default: 15)
- `minimizedFps` - FPS when minimized (default: 1)
- `onlyWhenMinimized` - ignore "background", only slow down when minimized (default: false)
- `backgroundVolume` - 1.0 = unchanged, 0.5 = half, 0.0 = muted (default: 1.0)
- `minimizedVolume` - same, while minimized (default: 1.0)

## Works on servers

This is a **client-side only** mod. It only changes how fast your own game draws frames; the server and other players don't notice anything. Works in singleplayer, on Realms and on any server.

## Honest limitations

- At 1 FPS it can take up to one second before the game is fully smooth again after restoring the window.
- Minecraft only knows whether its window is active, not whether it's covered by another window - so "background" means "another window is active".
- Other mods that also limit FPS in the background (like Dynamic FPS) do the same job; use one of them.
- The settings are in a config file; there is no in-game settings screen yet.

## Requirements

- Minecraft 1.21 / 1.21.1
- Fabric Loader 0.16 or newer
- Fabric API
- Java 21

## Installation

1. Install Fabric Loader for Minecraft 1.21.1.
2. Put **Fabric API** and **Clean Background FPS** in your `mods` folder.
3. Start the game.

## Modpacks

You are welcome to include this mod in any modpack. No need to ask.

## Also by this author

- **Clean Item Finder** - search box that highlights items in chests and inventories
- **Clean Auto Reconnect** - automatically rejoins the server after a disconnect
- **Clean Keystrokes** - WASD, mouse buttons and CPS on screen for PvP and streaming
- **Clean Item Mover** - Shift + drag and scroll to move items faster in any inventory
- **Clean Outline** - custom block outline and crosshair: color, thickness, rainbow
- **Clean Chat Heads** - player faces next to chat messages, optional timestamps
- **Light Level Overlay** - press F7 to see where mobs can spawn
- **Clean Ping Display** - real ping numbers in the Tab list
- **Clean Horse Stats** - a horse's speed, jump and health at a glance
- **Clean Info HUD** - coordinates, facing, biome and FPS in a tidy panel
- **Status Effect Timers** - your potion effects as a clean list with countdowns
- **Death Location Helper** - an on-screen arrow back to where you died
- **Item Pickup Notifier** - see everything you pick up at the side of the screen
- **Smooth Zoom** - hold a key to zoom, scroll to change the zoom level
- **Item Container Preview** - see Shulker Box contents in the tooltip
- **Clean Tooltip Enchants** - color-coded enchantments with (MAX) tags
- **Smart Torch Placer** - place torches with one key, optional Auto-Light for mining
- **Smart Crop Harvest** - right-click ripe crops to harvest and replant
- **Floating Damage Indicators** - damage, heal and crit numbers above mobs
- **Smart Tool Safety** - durability warnings and tool break protection
- **Smart Chest Organizer** - sort buttons and quick deposit for chests
- **Dynamic Armor HUD** - armor, held item and arrow durability on screen
- **Smart Auto-Trash** - quickly trash or auto-throw junk items
- **Dynamic Item Glow** - rarity colors and glow for items

## About the images

The project logo is an illustration created with AI assistance; it is not an in-game screenshot. The screenshots in the gallery are real, unedited in-game captures.