PortalToggler

Minecraft 版本： 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： paper purpur spigot

标签： game-mechanics management utility

PortalToggler

A simple plugin to control Nether and End portal entry and creation on Paper/Spigot.

Description

PortalToggler lets server admins easily enable or disable Nether/End portal entry and creation. It's lightweight, easy to configure, and great for events, minigames, or any server that needs tight portal control.

Features

• Toggle Nether/End entry and creation separately
• Bypass permissions for trusted players
• Fully customizable MiniMessage messages
• Reload config without restarting
• Built-in debug mode
• Tab completion for all commands
• Lightweight and simple to set up

Usage

Commands

<> = required, [] = optional

Configuration

config.yml

The main configuration file controls portal states and debug settings:

# PortalToggler Configuration

# Debug Settings
debug: false

# Portal Settings
portals:
  nether:
    entry:
      enabled: true
    creation:
      enabled: true
  end:
    entry:
      enabled: true
    creation:
      enabled: true

Configuration Options:

messages.yml

Customize all plugin messages with MiniMessage formatting:

prefix: "<dark_gray>[</dark_gray><gradient:#ff55ff:#5555ff>PortalToggler</gradient><dark_gray>]</dark_gray>"

# Status Messages
status-enabled: "<green>Enabled</green>"
status-disabled: "<red>Disabled</red>"

# Portal Messages
portal-disabled: "<red>Disabled {portal} portal {mode}."
portal-enabled: "<green>Enabled {portal} portal {mode}."

disabled-portal-attempt: "<red>You cannot enter the {portal} as portal entry is disabled."
disabled-end-portal-creation: "<red>You cannot insert an eye of ender into an {portal} portal frame while it is disabled."
disabled-nether-portal-creation: "<red>You cannot create a {portal} portal while it is disabled."

# Command Messages
no-permission: "<red>You don't have permission to use this command."
reload-success: "<green>Configuration reloaded successfully!"

MiniMessage Formatting:

• Supports gradients, colors, hover text, and more
• Learn more at MiniMessage Documentation

Command Examples

# Toggle nether portal entry
/portal toggle nether entry

# Disable end portal creation
/portal disable end creation

# Check all portal statuses
/portal status

# Check only nether portal status
/portal status nether

# Reload configuration
/portal reload

Permissions

Permission Examples

LuckPerms:

# Grant admin access to a group
/lp group admin permission set portaltoggler.admin true

# Allow VIP players to bypass nether portal restrictions
/lp group vip permission set portaltoggler.bypass.enter.nether true
/lp group vip permission set portaltoggler.bypass.create.nether true

PermissionsEx:

/pex group admin add portaltoggler.admin
/pex group vip add portaltoggler.bypass.enter.nether