Portable Hole

Portable Hole adds a simple magical tool that opens temporary passages through solid blocks. Click a surface to clear a short tunnel in that direction, letting you slip through walls, floors, ceilings, and tight spaces without permanently breaking anything. 🌀

After a brief moment, the removed blocks return on their own, making it useful for exploration, quick escapes, hidden entrances, and creative builds where you want movement without lasting damage. ✨

The mod keeps the effect readable with spark particles, a portal-style overlay, and reappearing block feedback, while offering configuration for hole depth, duration, cooldown, visuals, and which blocks can be affected. ⚙️

• 🌀 Temporary Passages: Open short-lived holes through blocks and move through them without leaving permanent damage behind.
• ↔️ Directional Tunnels: Create holes through walls, floors, or ceilings based on the side of the block you click.
• ⏳ Automatic Restoration: Removed blocks return after a few seconds, keeping worlds intact.
• ✨ Clear Visual Feedback: Spark particles, portal-style edges, and reappearing block effects make active holes easy to spot.
• ⚙️ Configurable Behaviour: Adjust cooldown, tunnel depth, duration, block hardness limits, and visual effects to fit your world or server.

⏩ INSTALLATION REQUIRED ON CLIENT & REQUIRED ON SERVER

⏩ REQUIRES PUZZLES LIB TO BE INSTALLED (FABRIC & NEOFORGE)

⏩ REQUIRES FABRIC API TO BE INSTALLED (FABRIC)

⏩ REQUIRES FORGE CONFIG API PORT TO BE INSTALLED (FABRIC)

If available for a mod, configuration is possible directly from in-game using the mod menu (requires Mod Menu by Prospector to be installed on Fabric).

For manual configuration using an external text editor all files are found at .minecraft/config, named as MOD_ID-client.toml, MOD_ID-common.toml, or MOD_ID-server.toml, depending on the type of config. Not all types might exist for a mod, if any at all.

🌟 Huge thanks to Azanor for creating Thaumcraft 3, whose Portable Hole inspired this mod from the very beginning.

🌟 Thanks to Vazkii for creating Botania, which inspired the magical spark particle effects used in this mod.

🌟 Thanks to Finalbossblues for creating the excellent icon set available on itch.io, parts of which are used in this mod.