MyWorlds/Portals

From BergerHealer Wiki
Revision as of 00:10, 17 September 2023 by Bergerkiller (talk | contribs) (→‎Rejoin Portals)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

« Go back

Several types of portals on display

Introduction

Besides commands, this plugin comes with the simplest cross-world teleportation solution: Actual portals. Walk from world to world simply, by walking into a portal. To make a portal, all you have to do is place a [portal] sign nearby a block structure that looks like a portal.

There are three types of portals to choose from:

  • Nether portals
  • End portals
  • Water portals

Default Portal Destination

MyWorlds Portals are created using signs. If you want player-created nether portals or naturally generated end gateways to send players to a certain destination, configure that using /world endportal and /world netherportal. See the commands page for more information.

Vanilla Defaults

Nether portals automatically teleport players from worldname to worldname_nether and back. Similarly an end gateway teleportation is automatically set up between worldname and worldname_the_end. If this is not working, run the following commands while in the world to apply the options to (/tpp worldname). This assumes world names "overworld", "nether_world" and "end_world". Replace these with the names of your worlds.

From where Command Explanation
overworld /mw netherportal destination nether_world
/mw netherportal mode nether_link
/mw endportal destination end_world
/mw endportal mode end_platform
When players enter a nether portal in the overworld they should go to /8 coordinates (nether link mode) to the nether world. When they enter an end gateway they should teleport to the end platform in the end world.
nether_world /mw netherportal destination overworld
/mw netherportal mode nether_link
When players enter a nether portal in the nether, teleport x8 (nether link) to the overworld
end_world /mw endportal destination overworld
/mw endportal mode respawn
When players enter an end gateway in the end, respawn the player at their bed or world spawn

Nether Link Permissions

If you have a default portal mode set to nether_link, then it will create a new nether portal on the destination world (at x8 coordinates). For this creation, players require the following permission (default true): myworlds.world.linknether

Enable

This portal behavior must be enabled in MyWorlds' config.yml before they can be used. If portal signs aren't working, first check that all relevant portal types are enabled:

# Turns different types of portals on or off
# When the portal is disabled, MyWorlds will not handle the portal's logic
enabledPortals:
  # Turns handling of nether portal teleportation on or off
  # Vanilla Minecraft will handle nether portals when disabled
  netherPortal: true
  # Turns handling of end portal teleportation on or off
  # Vanilla Minecraft will handle end portals when disabled
  endPortal: true
  # Enables or disables the water stream portals
  waterPortal: true

Usage

Nether portals and End gateways

Standard nether portals and end gateways can also be used as portals. For a custom frame or shape, this command can be used to get a special item to place them down:

Gives an item to place end/nether portals
Command: /world giveportal [end/nether]
Permission: myworlds.world.giveportal


Water portals

To use water as a portal, the water must be surrounded on at least two sides with a solid block and at least one side with open air. This is to prevent random lakes to act as portals. With a hole in the ground you can prevent the water from flooding outwards. Water is counted as a solid block, so they can be infinitely wide.

Portal Sign

Portal sign is placed below a nether portal, teleporting players inside
Signtemplate.png
[portal]
name
destination
title

For each line:

  • on the first line: [portal]
  • on the second line the portal name. You can teleport to this portal by this name, for example, with /tpp [name].
  • on the third line the portal or world name to teleport to. This is taken when the portal is entered.
  • optionally on the fourth line the destination display name (otherwise uses portal/world name on third line). Can be left empty.


Signtemplate.png
[portal]
Portal1
HubWorld

Placement

Players are teleported to the first open space above the portal sign. You can put the portal sign underground, and the player will be teleported on top of the solid blocks above. It is safe to put the portal sign below the portal itself, cyclical teleports are prevented.

Cleaning up portals

If you want to remove a portal you lost, you can remove the saved portal data from: root\plugins\My Worlds\portals.txt

Teleporting to portals

Please see the /world teleport and /tpp commands on the Commands page

Use with Traincarts

The Traincarts plugin supports this type of sign for creating (cross-world) train teleporters. See this page for more information.

Rejoin Portals

Rejoin portals are special portals which mimic the /world rejoin command. Rejoining means a player is teleported to the last position of the world name put on the sign. You must specify one of the worlds that should be rejoined on the last line.

Signtemplate.png
[portal rejoin]
Portal1
world

To make sure rejoining 'world' also rejoins 'world_nether' if the player was last in the nether, see the lastposition command to merge worlds. This way players also rejoin the last world they were on when rejoining one of the merged worlds.

Additional Options

Additional options that don't really fit on the sign can be configured using the /world setportaloption <portal name> <option> <value> command. If you want to set per portal whether mobs and items can pass through the portal, rather than relying on the global option in config.yml, this can be set per portal here:

/world setportaloption hub playersonly [no/yes]