Mineuniverse
Log in Register
Plugins

PortableHole

Create temporary tunnels in the world
by desht_08
Download Claim this project
5,447 downloads
0 likes
Updated Jun 30, 2026
0 hypes
Fun Mechanics

Want to get through that wall or floor but don't feel like digging a hole and repairing it again? Then PortableHole is for you!

If you've used the excellent Thaumcraft 2 mod in SSP, you'll have a good idea of what to expect - this is a shameless clone: you can create temporary tunnels through walls and terrain which close up after a short delay. PortableHole behaves largely (but not entirely) like the Thaumcraft 2 portable hole, and adds a few extra features such as permissions checking, highly configurable tunnelling costs, and respecting protection plugins.

PortableHole uses a Written Book item as the trigger item. The book must have a specific title (by default "Portable Hole") - when players left-click any terrain with that book in hand, the plugin will attempt to create a temporary tunnel through the world. The tunnel can be no longer than 31 blocks long (configurable), and there are certain blocks (configurable) that may not be tunnelled. The tunnel ends when any passable block, or bedrock, is reached. Although any player can craft a written book with the right title, the plugin does allow restriction of whose books may actually be used, both by player name and permission group (Vault is needed for the latter).

Want to get started quickly? Read the Quickstart Guide!

Latest Version

Note: PortableHole v1.0.1 will not run on CraftBukkit 1.4.5-R1.0 or later.

Features

  • Create temporary tunnels in your world which close after a delay (tunnel lifetime dependent on length and configuration settings)
  • Permissions support via Bukkit superperms (plus Vault for extra group support)
  • Configurable tunnelling costs (items, item durability, money, hunger, health, XP)
  • Respects protection plugins (any plugin which cancels block breaking events)
  • Configurable sounds & particle effects for tunnels

Videos

Installation

  • If you want economy-based tunnelling costs and/or permission group checking, you will need to have Vault installed, along with an economy and/or permissions plugin.
  • Copy PortableHole.jar into bukkit/plugins and restart/reload your server.
  • Edit bukkit/plugins/PortableHole/config.yml to your liking (see Configuration) and type /ph reload to reload the edited configuration.

Documentation

Source

Bukkit Forums

Changelog

Donations

If you use and enjoy PortableHole, you are welcome to make a donation by clicking the "Donate" button at the top right. However, donations are strictly optional, and don't confer any special benefits over non-donors.

PortableHole v1.2.0
MC CB 1.4.6-R0.3
Release 2013-01-10 Get
PortableHole v1.1.1
MC CB 1.4.6-R0.3
Release 2013-01-04 Get
PortableHole v1.1.0
MC CB 1.4.5-R1.0
Release 2012-12-19 Get
PortableHole v1.0.1
MC CB 1.3.2-R1.0
Release 2012-10-04 Get
PortableHole v1.0
MC CB 1.3.2-R1.0
Release 2012-10-02 Get

More from desht_08

ChessCraft
87,525
PneumaticCraft: Repressurized
76,381,635
ScrollingMenuSign
71,999
AutoHop
7,050
Modular Routers
69,849,776
Checkers
12,277

You Might Also Like

BattleTracker 2.0
A standalone plugin and companion to BattleArena that tracks PVP & PVE statistics along with a suite of additional combat features to enhance server gameplay.
9,997
eHunger Games (Mcpvp hg)
A hunger games plugin like mcpvp
9,985
Basic Trails
Basic Trails Plugin
9,974
HypixelFirework
HypixelFirework
9,956
PremiumBoots [Like GommeHD]
PremiumBoots [Like GommeHD]
9,949
llamaGrapple
A customizable grapple hook!
9,925