PortalLock

A lightweight, production-ready Paper plugin for controlling access to the Nether and The End.

PortalLock is designed for servers that want natural progression without changing the vanilla experience. Lock the Nether or The End until a specific date, unlock them automatically on a schedule, or control them manually with simple commands.

Perfect for SMP, survival, hardcore, RPG, seasonal, and community servers.

---

✨ Features

• 🔥 Independently lock the Nether and The End.
• ⏰ Automatic scheduled unlocking.
• 🔒 Manual locking and unlocking with commands.
• 💾 Timers persist through server restarts.
• 💬 Fully customizable MiniMessage messages.
• 🎨 Custom dimension names.
• 📢 Optional broadcasts, titles, sounds and console commands on unlock.
• ⚡ PlaceholderAPI support.
• 🛡️ Permission-based administration.
• 🚀 Lightweight and optimized for Paper.
• 📦 No external dependencies required.

---

🎮 How it works

When a dimension is locked:

• Players cannot enter it.
• Players receive a customizable message explaining why access is blocked.
• Remaining unlock time can be displayed.
• Administrators may bypass restrictions (optional).

Once the timer expires, the dimension automatically becomes available for everyone.

---

📦 Commands

/portallock status
/portallock reload
/portallock open <nether|end>
/portallock close <nether|end>
/portallock settime <nether|end> <time>

Example:

/portallock settime nether 7d
/portallock open end
/portallock close nether

---

🔑 Permissions

portallock.admin
portallock.command.reload
portallock.command.status
portallock.command.open
portallock.command.close
portallock.command.settime

portallock.bypass.nether
portallock.bypass.end

---

⚙️ Configuration

PortalLock includes fully documented configuration files.

Everything can be customized:

• unlock dates
• timers
• messages
• MiniMessage formatting
• sounds
• titles
• broadcasts
• PlaceholderAPI output
• dimension names
• permissions
• unlock actions

No code editing required.

---

🧩 PlaceholderAPI

Available placeholders include:

%portallock_nether_status%
%portallock_end_status%

%portallock_nether_remaining%
%portallock_end_remaining%

---

❤️ Designed for

• Survival Servers
• SMP
• Vanilla+
• Hardcore
• RPG
• Nations
• Lifesteal
• Community Events
• Seasonal Servers

---

✅ Compatibility

• Paper 26.2+
• PlaceholderAPI (optional)
• MiniMessage
• Java 25

---

💡 Why PortalLock?

Many plugins simply disable portals.

PortalLock was built specifically for progression-based gameplay, allowing server owners to gradually unlock Minecraft dimensions while keeping the vanilla survival experience intact.

Whether you're launching a brand-new SMP, running a seasonal event, or slowing progression on a long-term world, PortalLock provides a simple, reliable and highly configurable solution.

---

📄 License

Released under the MIT License.

If you enjoy PortalLock, consider ⭐ starring the project on GitHub and following future updates.