Configurable Waterlogging: Waterlog Any Block in Minecraft
Minecraft’s water mechanics have always been a double-edged sword for builders. The vanilla waterlogging system allows certain blocks—slabs, stairs, fences, and a handful of others—to coexist with water inside the same block space, creating seamless underwater structures and decorative water features. But what if you want a full stone block, a door, or even a bed to hold water without flooding the entire room? That is where Configurable Waterlogging: Waterlog Any Block in Minecraft steps in, tearing down the hardcoded restrictions and handing the reins to you. This mod transforms waterlogging from a limited, predefined list into a fully customizable system, letting you decide exactly which blocks can become waterlogged through a straightforward configuration file.
Understanding Vanilla Waterlogging
In standard Minecraft, waterlogging is a mechanic that allows a block to be filled with water while still occupying its space, preventing the liquid from flowing into adjacent air blocks. It is what makes underwater builds with stairs and slabs look so clean—the water sits inside the block’s geometry rather than being displaced. The game’s code, however, only grants this ability to a specific set of blocks. For builders who dream of submerged libraries with waterlogged bookshelves, flooded redstone contraptions, or aquariums where every decorative block interacts with water, the vanilla limitations often force awkward workarounds or outright compromises.
What Configurable Waterlogging Brings to the Table
This mod completely redefines the rules. Instead of relying on Mojang’s fixed list, you gain the power to declare any block ID or block tag as waterloggable. Whether you are working with Configurable Waterlogging: Waterlog Any Block in Minecraft for Minecraft on a personal creative world or managing a multiplayer server, the flexibility is immense. The mod reads a simple TOML configuration file where you list the blocks you want to include, and it also supports a blacklist to exclude specific entries that might otherwise cause issues. The result is a tailored waterlogging experience that feels native to the game.
Key Features
- Universal block support: Add any block ID (like
minecraft:stone) or entire tags (likeminecraft:fences) to the waterloggable list, and they will immediately accept water. - Blacklist functionality: Even if a block is caught by a broad tag, you can explicitly exclude it to protect delicate builds or redstone mechanisms.
- Vanilla bucket behavior: Using a water bucket on a configured block fills it with water, and an empty bucket removes the water—exactly as players expect.
- Complex block handling: Doors, beds, and other multi-part blocks are processed intelligently, ensuring water behaves predictably across both halves.
- Hot reloading: Changes to the configuration file can be applied without restarting the client or server, saving time during testing and tweaking.
Configuration Made Simple
The heart of the mod lies in its configuration file, typically named configurablewaterlogging-common.toml. This file is generated automatically on first launch and can be edited with any text editor. Inside, you will find arrays for waterloggable_blocks and waterloggable_tags, where you list the identifiers of the blocks you want to waterlog. A separate blacklist array lets you remove specific entries from the broader rules. There is also a skip_native_waterloggable option, which, when enabled, prevents the mod from interfering with blocks that already support waterlogging in vanilla—this avoids duplication and keeps the logic clean.
Editing the TOML File
To get started, open the TOML file and add your desired blocks under the appropriate section. For example, to make stone and all fence types waterloggable, you would include "minecraft:stone" in the blocks list and "minecraft:fences" in the tags list. If you later decide that stone should not be waterloggable, simply move it to the blacklist. The mod also allows you to set command permission levels; a value of 0 grants access to all players, while 2 restricts commands to operators. This granularity is especially useful for server administrators who want to prevent griefing or unintended water placement.
In-Game Commands for Quick Tweaks
Beyond the configuration file, Configurable Waterlogging: Waterlog Any Block in Minecraft includes a set of handy in-game commands that make on-the-fly adjustments effortless. These commands are accessible through the /cw prefix and require the appropriate permission level set in the config.
/cw toggle— Toggles waterlogging on the block you are looking at. This is perfect for testing a single block without editing the file./cw reload— Reloads the configuration from disk, applying any recent changes immediately./cw status— Displays the current number of blocks affected by your rules, giving you a quick overview of the mod’s reach.
These commands turn the mod into a dynamic tool, allowing builders to experiment with different materials in real time and see the results instantly.
Installation and Compatibility
If you are wondering how to install this mod, the process is straightforward. It is available for both Fabric and Forge mod loaders, covering a wide range of Minecraft versions including 1.20.x, 1.19.x, and often 1.18.x. To get started, simply download Configurable Waterlogging: Waterlog Any Block in Minecraft from a trusted mod repository and place the JAR file into your mods folder. Ensure you have the correct loader installed and that the mod version matches your game version. For server use, the same file goes into the server’s mods directory, and the configuration can be managed centrally. The mod is lightweight and does not introduce any new blocks or items, so it pairs seamlessly with resource packs and other decorative mods without causing conflicts.
Practical Use Cases
The true power of this mod shines in creative and survival builds alike. Imagine constructing an underwater base where every wall block, not just slabs, holds water, creating a fully submerged environment without air pockets. Aquarium builders can waterlog glass panes, coral blocks, and even sea lanterns to achieve a more natural look. Redstone engineers can design flooded circuits where water and redstone coexist in the same block space, opening up new contraption possibilities. Server owners can define a consistent set of waterloggable blocks across the entire world, ensuring that all players experience the same rules and that no one accidentally floods a shared build. The mod also works beautifully with modpacks, allowing pack creators to tailor waterlogging to fit the theme of their custom experience.
Conclusion
Configurable Waterlogging: Waterlog Any Block in Minecraft is a focused, no-nonsense utility that solves a long-standing limitation in Minecraft’s building mechanics. By shifting control from the game’s code to a simple configuration file, it empowers players to realize underwater visions that were previously impossible or required tedious workarounds. Whether you are a solo builder, a server administrator, or a modpack developer, this mod delivers the precision and flexibility needed to make water an ally rather than an obstacle. With its intuitive commands, hot reloading, and broad loader support, it integrates smoothly into any setup and quickly becomes an indispensable part of the creative toolkit.