
Portable Hole
Where did the walls go?
Screenshots

About this Mod

![]()
![]()
![]()
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.
![]()
![]()
![]()
Available Versions
How to Install Portable Hole on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).
Install Mod
Open the mod browser in the dashboard and search for "Portable Hole". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.2, 26.1.2, 26.1.1 (+19 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Portable Hole server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.2). You can switch loaders with one click in the panel.
Is Portable Hole compatible with fabric and forge and neoforge?
Portable Hole officially supports fabric, forge, neoforge for Minecraft 26.2, 26.1.2, 26.1.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Portable Hole – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Portable Hole consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Portable Hole with just one click on your server.



