Wormholes

Create stunning particle wormhole portals with tear-open animations, configurable colors, bidirectional travel, and per-player permissions.

---

Overview

Wormholes lets you create beautiful, animated particle portals and link them together as a travel network. Inspired by Solo Leveling's iconic gates, each portal features 7 layers of particle effects, a dramatic 3-second tear-open animation, and 8 color themes to choose from.

Walk into one portal and get teleported to its linked partner — it's that simple.

---

Features

Particle Portals

Every portal is rendered with 7 layers of particle effects running at 20 TPS:

• Dense void fill with depth illusion
• Spinning inner energy rings (3 counter-rotating rings)
• Glowing outer edge with shimmer
• Energy tendrils reaching outward
• Ground energy cracks beneath the portal
• Ambient floating particles
• Random lightning flashes

Opening Animation

Portals don't just appear — they tear open over 3 dramatic seconds:

1. Spark (0–1s) — A bright point of light crackles with energy
2. Tear (1–2s) — A vertical rift rips open with sparks flying off the edges
3. Expand (2–3s) — The rift widens into the full portal with shockwave rings
4. Burst (3s) — Massive particle explosion with dramatic sound effects

Portals cannot be used until the animation completes.

Wormhole Travel

Link any two portals together with a single command. Travel is bidirectional — walk into Portal A, appear at Portal B, and vice versa. Exit points are offset to prevent teleport loops.

Color Themes

Each portal can have its own color. Every particle layer shifts to match:

Theme	Vibe
🔵 blue	Classic Solo Leveling (default)
🔴 red	S-Rank / Blood Gate
🟡 gold	Royal / A-Rank
🟢 green	Nature / Poison Gate
🟣 purple	Shadow / Void Gate
🩵 cyan	Ice / Frost Gate
⚪ white	Holy / Light Gate
🩷 pink	Sakura / Cherry Gate

Permissions

• Per-portal allow/deny lists — Control exactly who can enter each portal
• Admin bypass — Players with sololevelingportals.bypass can enter any portal
• Silent deny mode — Optionally hide the "access denied" message in chat

Entity Handling

• Mounts (horses, pigs, etc.) teleport with their rider
• Entity stacks are handled correctly — unpermitted passengers get ejected and left behind
• The permitted driver + mount teleport while denied riders stay at the portal

Configuration

• Per-portal dimensions — Width, height, and particle density
• Global defaults — Set default size for new portals in config.yml
• Optional coordinates — Create portals at your location or at specific x/y/z coords
• Hot reload — Reload config without restarting the server

---

Commands

Command	Description
/slportal create <name> [x y z]	Create a portal (coords optional)
/slportal remove <name>	Remove a portal
/slportal connect <A> <B>	Link two portals as a wormhole
/slportal disconnect <name>	Sever a wormhole link
/slportal allow <portal> <player>	Grant portal access
/slportal deny <portal> <player>	Revoke portal access
/slportal set <portal> <property> <value>	Set width, height, density, or color
/slportal list	List all active portals
/slportal info <portal>	View portal details
/slportal reload	Reload config from disk

All commands support full tab completion with context-aware suggestions.

---

Permission Nodes

Permission	Description	Default
sololevelingportals.admin	Access to all /slportal commands	OP
sololevelingportals.bypass	Enter any portal without being on the allow list	OP

---

Requirements

• Paper 1.21+
• Java 21

---

Author

Made by ArcLgenD