Multiverse-Portals-GUI

A Minecraft Paper plugin that replaces portal entry with a destination-selection GUI. Walk into a configured Multiverse portal and choose where to go from a chest menu — other MV portals or direct coordinates, with per-destination cooldowns and Vault pricing.

Requirements

• Paper 1.21.4+
• Java 21+
• Multiverse-Core + Multiverse-Portals 5.2.x (soft-depend, reflection-based — no compile dependency)
• Optional: Vault economy (required for priced destinations)

Features

• Portal entry interception — walking into a configured portal opens a destination GUI instead of teleporting
• Two destination types:
  • Portal — button teleports to another MV portal's safe spawn location (addportal)
  • Location — button teleports to saved world coordinates (addloc)
• Per-destination cooldowns and Vault prices
• Paginated GUI with configurable rows, materials, and nav slots
• In-game management — no config file editing (/mvpgadmin)
• Portal with zero destinations keeps its normal Multiverse behavior (direct teleport)
• /mvpg portal-list GUI for players

Permissions

Permission	Description	Default
mvpguis.use	Open portal GUI and use portals	true
mvpguis.admin	All admin commands	op
mvpguis.manage.<portal>	Manage destinations for a specific portal	op

Commands

Player Commands

Command	Description
/mvpg	Open the portal list GUI
/mvpg info <portal>	List that portal's destinations
/mvpg reload	Re-init Multiverse hook + refresh GUI

Aliases: portalgui, mvgui, portals

Admin Commands

Command	Description
/mvpgadmin addportal <portal> <name> <targetPortal>	Add a button that teleports to another portal's safe spawn
/mvpgadmin addloc <portal> <name>	Add a button for your current location
/mvpgadmin remove <portal> <name>	Delete a destination
/mvpgadmin cooldown <portal> <name> <seconds>	Set destination cooldown (0 = none)
/mvpgadmin price <portal> <name> <amount>	Set Vault price (0 = free)
/mvpgadmin list [portal]	List all portals or one portal's destinations
/mvpgadmin reload	Re-init Multiverse hook + validate destinations

Aliases: portalguiadmin

addportal buttons teleport to the target portal's location (safe spawn), not its Multiverse action — so circular portal actions can't chain.

Installation

1. Build or download the JAR
2. Place in plugins/ folder
3. Restart server
4. Configure plugins/Multiverse-Portals-GUI/config.yml as needed
5. Add destinations in-game with /mvpgadmin
6. Use /mvpgadmin reload after adding portals in Multiverse

Configuration

config.yml

gui:
  title: "&8Portal List"
  item-material: ENDER_PEARL
  rows-per-page: 6
  nav:
    prev:
      material: ARROW
      slot: 45
    next:
      material: ARROW
      slot: 53
    back:
      material: BARRIER
      slot: 49

Setting	Default	Description
gui.title	&8Portal List	GUI title (color codes supported)
gui.item-material	ENDER_PEARL	Material of destination buttons
gui.rows-per-page	6	Rows per page (3–6; last row is nav)
gui.nav.prev.material / .slot	ARROW / 45	Previous-page button
gui.nav.next.material / .slot	ARROW / 53	Next-page button
gui.nav.back.material / .slot	BARRIER / 49	Back/close button

destinations.yml

Generated on first edit. Managed in-game via /mvpgadmin:

portals:
  p1:
    Base:
      type: location
      world: world
      x: 32.63
      y: 69.0
      z: 271.46
      yaw: -162.13
      pitch: 68.81
      cooldown: 0
      price: 0.0
    Hub:
      type: portal
      portalName: hub
      cooldown: 10
      price: 0.0

Entries without a type default to location (migration from older files, no data loss).

Building

mvn clean package

Output: target/multiverse-portals-gui-1.0.0.jar

License

GPL-3.0