By
How to Use the Simple Portals Plugin (fast regional portals + commands)

Jak używać Simple Portals (portale regionowe + komendy) How to Use the Simple Portals Plugin (regional portals + commands)

Simple Portals pozwala szybko tworzyć prostopadłościenne portale, które teleportują graczy i opcjonalnie uruchamiają komendy przy wejściu. Działa w jednym i wielu światach, współpracuje z proxy.

Simple Portals lets you quickly create cuboid portals that teleport players and optionally run commands when a player enters. It works in single- and multi-world setups and is proxy-friendly.

Simple Portals – poradnik (PL) Simple Portals tutorial hero (EN)
Pobieranie Wtyczka: Simple Portals — SpigotMC (download).
Zawsze pobieraj z zaufanych źródeł. Unikaj nieoficjalnych mirrorów — mogą zawierać malware.

Podstawowa konfiguracja portalu

  1. Włącz tryb zaznaczania:
/sp sm

Zaznacz obszar portalu: lewy przycisk pierwszy róg, prawy przycisk drugi róg. Może to być dowolny prostopadłościan.

  1. Utwórz portal (użyj własnej nazwy):
/sp create <portalname>

Powinieneś zobaczyć cząsteczki wypełniające region (wizualizacja granic).

  1. Ustaw miejsce teleportu na swoją obecną pozycję:
/sp sl <portalname>
Zarządzanie i podgląd Pokaż lokalizację portalu: /sp sr <portalname>
Wyłącz/Włącz portal: /sp disable <portalname> / /sp enable <portalname>
Usuń portal: /sp delete <portalname> • Lista: /sp list
Przeładuj po edycji configu: /sp reload

Zaawansowane użycie (komendy i wiadomości)

Dodaj komendy do portalu

Podpinaj komendy uruchamiane przy wejściu. Wybierz wykonawcę: PLAYER lub CONSOLE. Gdy pominiesz, domyślnie wykona je gracz.

/sp addcmd <portalname> say Welcome!:CONSOLE
/sp addcmd <portalname> warp spawn:PLAYER

Podgląd/wyczyszczenie listy komend:

/sp cmds <portalname>
/sp clearcmds <portalname>

Przełącz tryb tylko-komendy (wyłącza teleport, zostawia komendy):

/sp tco <portalname>

Wiadomości przy wejściu

Wyświetl komunikat po wejściu. Typy: Normal (chat), Bar (nad hotbarem), Title (centrum), Subtitle (pod tytułem). Możesz ustawić do czterech wiadomości (po jednej na typ).

/sp message <portalname> "&aTeleporting to spawn!":Normal
/sp message <portalname> "&bHave fun!":Bar
/sp message <portalname> "&eWelcome!":Title
/sp message <portalname> "&7Travel started":Subtitle

Wyłącz wszystkie wiadomości:

/sp dm <portalname>

Uprawnienia (permissions)

Nadaj odpowiednim rangom (np. przez LuckPerms):

simpleportals.showregion # podgląd regionów portalu
simpleportals.setlocation # ustaw cel portalu
simpleportals.info # info o wtyczce
simpleportals.reload # /sp reload
simpleportals.create # tworzenie portali
simpleportals.delete # usuwanie portali
simpleportals.list # lista portali
simpleportals.selectionmode # /sp sm
simpleportals.portal.<name> # użycie konkretnego portalu (* = wszystkie)
simpleportals.addcommand # /sp addcmd
simpleportals.clearcommands # /sp clearcmds
simpleportals.togglecommandonly # /sp tco
simpleportals.viewcommands # /sp cmds
simpleportals.toggle # włącz/wyłącz portale
simpleportals.message # /sp message
simpleportals.dm # /sp dm
simpleportals.fill # wypełnianie portalu (particles)

Przykład: portal na spawn

  1. Zaznacz region: /sp sm → lewy róg (LPM), prawy róg (PPM).
  2. Utwórz: /sp create spawn_portal
  3. Ustaw cel: stań na spawnie → /sp sl spawn_portal
  4. Dodaj wiadomości:
    /sp message spawn_portal "&aTeleporting to spawn!" :Title
    /sp message spawn_portal "&7Enjoy your stay!" :Subtitle
  5. (Opcjonalnie) Komenda z konsoli:
    /sp addcmd spawn_portal "say {player} used the spawn portal!" :CONSOLE

Rozwiązywanie problemów

Portal nie teleportuje

  • Upewnij się, że poprawnie zaznaczyłeś region (/sp sm, dwa rogi).
  • Ustaw cel teleportu: /sp sl <portalname>.
  • Sprawdź, czy portal jest włączony: /sp enable <portalname>.
  • Czy gracz ma simpleportals.portal.<name> lub simpleportals.portal.*?

Komendy się nie uruchamiają

  • Sprawdź składnię /sp addcmd i wykonawcę (PLAYER/CONSOLE).
  • Jeśli wykonawcą jest PLAYER, upewnij się, że ma permisję do tej komendy.
  • Podgląd/wyczyść listę: /sp cmds <portalname> / /sp clearcmds <portalname>.

Download Plugin: Simple Portals — SpigotMC (download).
Always use trusted sources. Avoid unofficial mirrors — they may contain malware.

Basic portal setup

  1. Toggle Selection Mode:
/sp sm

Select the portal area: left-click the first corner, right-click the second. Any rectangular cuboid works.

  1. Create the portal (use your own name):
/sp create <portalname>

You should see particles filling the region to visualize the portal’s bounds.

  1. Set the teleport destination to your exact current location:
/sp sl <portalname>
Manage & inspect Show portal location: /sp sr <portalname>
Disable/enable a portal: /sp disable <portalname> / /sp enable <portalname>
Delete a portal: /sp delete <portalname> • List portals: /sp list
Reload after config edits: /sp reload

Advanced usage (commands & messages)

Add commands to a portal

Attach commands that run when a player enters. Choose the executor: PLAYER or CONSOLE. If omitted, it defaults to PLAYER.

/sp addcmd <portalname> say Welcome!:CONSOLE
/sp addcmd <portalname> warp spawn:PLAYER

View or clear commands:

/sp cmds <portalname>
/sp clearcmds <portalname>

Toggle command-only mode (disables teleport but still runs commands):

/sp tco <portalname>

Send messages on entry

Display a message when the user enters the portal. Types: Normal (chat), Bar (above hotbar), Title (center title), Subtitle (center subtitle). You can set up to four messages per portal — one per type.

/sp message <portalname> "&aTeleporting to spawn!":Normal
/sp message <portalname> "&bHave fun!":Bar
/sp message <portalname> "&eWelcome!":Title
/sp message <portalname> "&7Travel started":Subtitle

Disable all messages for a portal:

/sp dm <portalname>

Permission nodes

Grant these to the right ranks (e.g., via LuckPerms):

simpleportals.showregion # view portal regions
simpleportals.setlocation # set portal destination
simpleportals.info # plugin info
simpleportals.reload # /sp reload
simpleportals.create # create portals
simpleportals.delete # delete portals
simpleportals.list # list portals
simpleportals.selectionmode # /sp sm
simpleportals.portal.<name> # use a specific portal (* = all)
simpleportals.addcommand # /sp addcmd
simpleportals.clearcommands # /sp clearcmds
simpleportals.togglecommandonly # /sp tco
simpleportals.viewcommands # /sp cmds
simpleportals.toggle # enable/disable portals
simpleportals.message # /sp message
simpleportals.dm # /sp dm
simpleportals.fill # portal fill commands

Example: spawn portal

  1. Select a region: /sp sm → left-click first corner, right-click second.
  2. Create it: /sp create spawn_portal
  3. Set destination: stand at your spawn → /sp sl spawn_portal
  4. Add messages:
    /sp message spawn_portal "&aTeleporting to spawn!" :Title
    /sp message spawn_portal "&7Enjoy your stay!" :Subtitle
  5. (Optional) Add a console command:
    /sp addcmd spawn_portal "say {player} used the spawn portal!" :CONSOLE

Troubleshooting

Portal doesn’t teleport

  • Make sure the region was selected correctly (/sp sm, two corners).
  • Set the destination with /sp sl <portalname>.
  • Confirm the portal is enabled: /sp enable <portalname>.
  • Does the player have simpleportals.portal.<name> or simpleportals.portal.*?

Commands don’t run

  • Check the /sp addcmd syntax and executor (PLAYER/CONSOLE).
  • If executor is PLAYER, ensure the player has permission for that command.
  • Review with /sp cmds <portalname> and clear if needed: /sp clearcmds <portalname>.