Portable Hole

Portable Hole

Where did the walls go?

by
291.7K Downloads
fabricforgeneoforgeequipmenttransportation
Rent Server with this Mod

Screenshots

Portable Hole Screenshot 1

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

[NEOFORGE] [26.2.x] v26.2.0release
MC 26.2neoforge
June 19, 2026
[FABRIC] [26.2.x] v26.2.0release
MC 26.2fabric
June 19, 2026
[FABRIC] [26.1.x] v26.1.0release
MC 26.1, 26.1.1, 26.1.2fabric
May 4, 2026
[NEOFORGE] [26.1.x] v26.1.0release
MC 26.1, 26.1.1, 26.1.2neoforge
May 4, 2026
[FABRIC] [1.21.11] PortableHole v21.11.0release
MC 1.21.11fabric
December 16, 2025

How to Install Portable Hole on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.2).

3

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

fabricforgeneoforge

Minecraft Versions

26.2, 26.1.2, 26.1.1 (+19 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Portable Hole with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
Mozilla Public License 2.0
Server-side
Required

Supported Versions

26.226.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.6+12 more