MythicPortals icon
In Development

MythicPortals

Location-based portals with animated particles and cinematic build-up.

In development
Spigot downloads
Modrinth downloads
No ratings yetSpigot rating
1.3.0Current version
Last public update

Full overview

Location-based portals with animated particles and cinematic build-up.

MythicPortals creates physical travel points from locations, trigger blocks and configurable regions. Portals can feel like part of the world through particle animations, delays and visual build-up rather than acting as invisible command shortcuts.

Different portal sizes and destinations support small personal gateways, large server hubs and story-driven transitions between important locations.

Best suited toRPG worlds, server hubs and survival networks that want travel to feel like a physical world mechanic.

How it works

Step into a visible portal and travel after a cinematic build-up

Administrators define the trigger area and destination, then choose the particle style and optional countdown. Entering the region begins the effect and teleports the player when the configured delay completes.

Movement cancellation can prevent players from beginning a teleport and then walking away. Destination management keeps portal travel separate from broad player warp permissions.

  • World-integrated travel rather than command-only warps
  • Multiple particle animation styles
  • Optional countdown and cancellation rules
  • Support for portals wider than one block

Administration

Configuration and live-server use

Portal definitions focus on location data, dimensions, animation, timing and destination safety. The project is in development and is intended to remain standalone rather than require LevelCraft.

CompatibilityPaper 1.21.x IntegrationsNo required integrations VersionIn development

Feature breakdown

Everything included in MythicPortals

Each headline feature is expanded below so visitors can understand the real server use rather than seeing a short tag list.

Custom trigger locations

Define exactly where players must stand or walk to activate travel.

Multiple portal sizes

Build compact one-block portals or wider structures such as 2×1 gateways.

Particle animation presets

Helixes and other patterns give each portal a distinct visual identity.

Optional teleport countdown

Create anticipation before the destination change.

Movement cancellation

Cancel a pending teleport when the player leaves the trigger area.

Destination management

Store and edit portal endpoints without exposing general warp commands.

Getting started

Installation and rollout

This project is not currently offered as a public platform download; its page documents the system and development status.

  1. 1

    The standalone plugin remains in development.

  2. 2

    Create test portals with different dimensions and animations.

  3. 3

    Verify countdown cancellation and destination safety.

  4. 4

    Load-test particle settings before enabling high-traffic hubs.

Tokens & placeholders

Text tokens found in the source

Availability depends on the feature that references each token.

%portal%%portal_id%%seconds%%seconds_rounded%

Source architecture

13 Java classes across 7 packages

models (4), utils (3), managers (2), commands (1), listeners (1), me.Ghoul.MythicPortals (1), tasks (1)

Core systems

Main, PortalAnimationType, PortalData, PortalDirection, PortalParticleTask, ParticleAnimationRenderer, ParticleUtil

Commands

PortalCommand

Listeners & events

PortalListener

Managers & services

PortalManager, TeleportManager

Models & data

ParticleProfile

Utilities

ColorUtil

Configuration reference

1 bundled YAML file

Top-level sections and defaults are summarised from the supplied resources.

config.yml

  • Settings — 6 nested settings: Enabled, Cooldown-Seconds, Particle-Interval-Ticks, Default-Particle, Default-Animation, Default-Render-Distance
  • Messages — 9 nested settings: Use-Prefix, Prefix, No-Permission, No-Portal-Permission, Reloaded, Teleported, Teleport-Started…
  • Portals — 0 nested settings:

Permissions

2 declared permission nodes

Defaults and descriptions come directly from plugin.yml.

mythicportals.admin

Allows managing MythicPortals portals

Default: op

mythicportals.use

Basic permission node for future portal use checks

Default: True

Commands

1 declared command

Aliases, usage and permissions come directly from plugin.yml.

/

/mythicportals

Manage MythicPortals altar portals

Aliases: /mp, /mportal, /mportals, /portals · Usage: /mythicportals · Permission: None declared

Source-verified reference

Checked against MythicPortals 1.3.0

This static reference is built from the supplied plugin.yml, YAML resources and Java source. No browser-generated documentation is used.

Main classme.Ghoul.MythicPortals.MainAPI version1.21Java classes13 Hard dependenciesNoneSoft dependenciesNoneLoad beforeNone

Related projects

Continue exploring