A Minecraft grass block inside an ice block representing the minecraft server hibernating.

Hibernate MC

Lets your Minecraft Fabric or NeoForge server snooze when idle, slashing CPU usage without missing a block!

**Download from:** [![Modrinth](https://codeberg.org/VoxelBill/devins-badges/raw/branch/v3/assets/cozy-minimal/available/modrinth_vector.svg)](https://modrinth.com/mod/hibernate-mc) [![Codeberg Releases](https://codeberg.org/VoxelBill/devins-badges/raw/branch/v3/assets/cozy-minimal/available/codeberg_vector.svg)](https://codeberg.org/VoxelBill/hibernate-mc)

**Supported loaders:** [![Fabric](https://codeberg.org/VoxelBill/devins-badges/raw/branch/v3/assets/cozy-minimal/supported/fabric_vector.svg)](https://fabricmc.net/use/installer/) [![NeoForge](https://codeberg.org/VoxelBill/devins-badges/raw/branch/v3/assets/cozy-minimal/supported/neoforge_vector.svg)](https://neoforged.net/)

## 📖 About **Hibernate MC** is a lightweight tool that automatically puts your Minecraft Fabric or NeoForge server to sleep when no players are online. By reducing CPU usage during idle times, it helps save server resources, lowers your electricity bill, and makes your server more eco-friendly. It's a simple way to keep your Minecraft world running smoothly without wasting power when it's not needed. **Hibernate MC** can also be used in singleplayer. When used in singleplayer, you can use the `/hibernate` commands (Ops only) and the entity removal feature works if `enableMemoryOptimization` is enabled in the config. No other features work in singleplayer as they only function when no players are online which can't happen in singleplayer. ## 📦 Dependencies **For Fabric:** [![Fabric API](https://codeberg.org/VoxelBill/devins-badges/raw/branch/v3/assets/cozy/requires/fabric-api_vector.svg)](https://modrinth.com/mod/fabric-api) **For NeoForge:** *N/A* ## 🎮 Install & Play Installing **Hibernate MC** is easy: 1. Download the latest version for your loader and Minecraft version [here](https://modrinth.com/mod/hibernate-mc/versions). 2. Put the downloaded jar file in to your `mods` folder. 3. Launch Minecraft and play with the mod. If installing on a server, don't forget to set `pause-when-empty-seconds` to `0` in your `server.properties` file to disable the vanilla hibernation system. ## 📜 Support Policy The project supports the Minecraft version for which the mod is initially developed for, along with the next two major Minecraft versions. Versions released prior to the initial supported version are not supported. Once a Minecraft version falls outside the three-version active support window, it enters **Bug-Fixes-Only** support for the duration of the following major version. During this period, only critical or game-breaking issues directly related to the project will be addressed. New features, enhancements, and non-critical changes will not be backported to versions in this stage. Once a version leaves Bug-Fixes-Only support, it becomes **Unsupported**. Unsupported versions will receive no further updates, fixes, or compatibility changes. | Minecraft version | Supported status | |-------------------|------------------| | `26.3` | `Supported` | | `26.2` | `Supported` | | `26.1` | `Supported` | | `1.21.11` | `Bugs Only` | | `1.21.9` | `Unsupported` | ## 📝 Config The config file can be found at `/config/hibernate_mc.json` from the root of the `.minecraft` folder or your server folder. ### ⚙️ Options

See options

### Basic Settings | Setting | Default | Description | |---------|---------|-------------| | `startEnabled` | `true` | Whether hibernation activates automatically when server starts with no players | | `ticksToSkip` | `400` | Number of ticks to process before applying sleep during hibernation | | `permissionLevel` | `2` | Required permission level to use hibernation commands (0=all, 4=owner) | | `sleepTimeMs` | `75` | Milliseconds to sleep between tick processing cycles | ### Memory Optimization | Setting | Default | Description | |---------|---------|-------------| | `enableMemoryOptimization` | `true` | Enable memory cleanup during hibernation | | `memoryCleanupIntervalSeconds` | `30` | How often to run memory cleanup routines | | `memoryThresholdPercent` | `80.0` | Memory usage percentage that triggers cleanup | | `forceGarbageCollection` | `true` | Force Java garbage collection during hibernation | | `gcIntervalSeconds` | `30` | Minimum time between garbage collection runs | | `saveBeforeHibernation` | `true` | Save world data before entering hibernation | | `removeEntities` | `item`, `firework_rocket`, `arrow`, `experience_orb` | List of entities to remove during hibernation (ignores entities with custom names) | | `droppedItemMaxAgeSeconds` | `300` | Age in seconds after which items are removed (5 minutes) | | `logMemoryInfo` | `false` | Log memory usage and garbage collector information to console | ### CPU Optimization | Setting | Default | Description | |---------|---------|-------------| | `aggressiveCpuSaving` | `true` | Enable more aggressive CPU saving measures | | `minSleepInterval` | `1500` | Minimum time in milliseconds between sleep cycles | | `highLoadSleepMultiplier` | `1.5` | Multiplier for sleep time when system load is high | | `yieldInterval` | `8` | How often to yield CPU to other threads (every N ticks) | ### Gamerule Values When The Servers Awake | Setting | Default | Description | |---------|---------|-------------| | `advance_time` | `true` | The value to set the gamerule `advance_time` to when coming out of hibernation | | `advance_weather` | `true` | The value to set the gamerule `advance_weather` to when coming out of hibernation | | `random_tick_speed` | `3` | The value to set the gamerule `random_tick_speed` to when coming out of hibernation | | `spawn_mobs` | `true` | The value to set the gamerule `spawn_mobs` to when coming out of hibernation | | `fire_spread_radius_around_player` | `128` | The value to set the gamerule `fire_spread_radius_around_player` to when coming out of hibernation | ### Gamerule Values When The Servers Hibernating | Setting | Default | Description | |---------|---------|-------------| | `advance_time` | `false` | The value to set the gamerule `advance_time` to when going into hibernation | | `advance_weather` | `false` | The value to set the gamerule `advance_weather` to when going into hibernation | | `random_tick_speed` | `0` | The value to set the gamerule `random_tick_speed` to when going into hibernation | | `spawn_mobs` | `false` | The value to set the gamerule `spawn_mobs` to when going into hibernation | | `fire_spread_radius_around_player` | `0` | The value to set the gamerule `fire_spread_radius_around_player` to when going into hibernation |

## 👨‍💻 Developing Are you a developer and want to develop for this mod?

Click to get started.

To get a local copy up and running, follow these simple steps. ### 🧰 Prerequisites Ensure you have the following installed on your machine: * **Java Development Kit (JDK)**: Version 25 or higher. * [Download JDK](https://adoptium.net/) * **Gradle**: Version 9.7.1 or higher. * [Install Gradle](https://gradle.org/install/) * **Minecraft**: Version 26.1 ### 🛠️ Build 1. **Clone the repository** ```sh git clone https://codeberg.org/VoxelBill/hibernate-mc.git ``` 2. Navigate to the project directory ```sh cd hibernate-mc ``` 3. Build the project with Gradle ```sh ./gradlew clean build ``` You can find the built mod at `hibernate-mc//build/libs/hibernate_mc--x.x.x+mc2x.x.jar`.

## ⚖️ License Distributed under the **GNU Lesser General Public License v3.0 only (LGPL-3.0-only)**. This project is a fork of [Hibernateforge](https://github.com/Thadah/Hibernateforge) which was distributed under the **European Union Public License v1.2 (EUPL-1.2)**. Relicensing has been done in accordance with the compatibility clause of the EUPL (Article 5). See `LICENSE` for more information.

Hibernate MC (Formerly Hibernate Fabric)

Compatibility

Minecraft: Java Edition

Platforms

Supported environments

Links

Tags

Creators

Details