Pages

Rebuilding portals

a very useful feature introduced in v11 is the "portal rebuild" server console command, that rebuilds all portals in your server, according the portal shape previously read from your config.yml file when plugin (re)load

the introduction of self contained water in v11 made possible to change the default portal shape similar to a small nether portal .. but this important change needs a way to standardize the portals on your server or your old version portals won't be recognized by events, here is when this command born

old new

before doing this update please consider the version you have now, do all needed updates before this at least to version 9 .. read the "Update" title of the project description page for details

if you want to use the new portal shape (now shown in project description page), you should follow the following procedure to do a "clean" portal rebuilding:

  • stop the bukkit service to avoid modification/lock issues
  • (backup and) edit your config.yml file ... change all non-zero values to zeroes in the "shape*" sections (replace material blocks with air)
  • overwrite your MyPortals.jar v10- file with the v11+ one
  • ensure that no one will connect to play, for example by using a firewall, unpluging wan cable or changing bukkit listen port
  • start the bukkit service
  • at server console, do a "portal rebuild" command, this will read config.yml and "erase" all portals blocks (turns into air)
  • backup and DELETE (or rename/move) your config.yml file
  • do a server reload command so the plugin will regenerate and load the file
  • optional: if you want to change the new default portal shape, edit the new generated config.yml file and restart/reload server again
  • at server console type "portal rebuild" to read new portal shape config and apply to all server portals
  • open server to the players again, they will find the portals structure has changed

after that you should instruct your players = if someone finds a portal facing the wrong direction, he can break, rebuild, activate and name it manually to correct it, ALWAYS WITH THE BASE BLOCK IN THE SAME PREVIOUS LOCATION so portals were pointing to it restores its links