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:
- Spark (0–1s) — A bright point of light crackles with energy
- Tear (1–2s) — A vertical rift rips open with sparks flying off the edges
- Expand (2–3s) — The rift widens into the full portal with shockwave rings
- 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.bypasscan 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