2 Migrating from an older major release
NotMyFault edited this page 2021-04-27 18:34:04 +02:00

Migrating from an older major release

If you are using PlotSqaured version 4 or older, please read the following steps carefully in order to upgrade successfully to v5 or newer. Keep in mind you need to update additional dependencies, such as WorldEdit, Fawe or the server itself as well while updating PlotSquared in order to let P2 function properly. Each major release contains its own migration handler, PlotSquared will attempt to upgrade its own files. Schematics can't be updated and need to be redone.

Migrating from PlotMe:

  1. Get the latest PlotMe version from here: https://www.spigotmc.org/resources/plotme-official.2131/ The zip contains 3 jars, but you need PlotMe-Core.jar only. Replace your current PlotMe version with the latest one.
  2. Launch your server with the latest PlotMe version, check the log to ensure no errors (no errors means no errors by any plugin!!) occur so you can start the migration.
  3. Get the latest PlotSquared v3 from here https://dev.bukkit.org/projects/plotsquared/files/2647923 3.1 Replace PlotMe with PlotSquared v3 and launch the server, ensure there are no errors or warnings and shut it down again.
  4. Get the latest PlotSquared v4 from https://www.spigotmc.org/resources/plotsquared-v4-v5-out-now.1177/. 4.1 Replace PlotSquared v3 with v4 and launch the server. Ensure there are no errors or warnings and shut it down again. If you encounter errors or warnings read them carefully and do what they tell you to do. Ignoring them can lead to further issues down the line. You may need to revisit /plugins/PlotSquared/settings/worlds.yml and perform material updates yourself. Versions prior to v5 weren't very smart in that aspect. Click here for an up to date list of valid material names.
  5. Get the latest PlotSquared v5 from https://www.spigotmc.org/resources/plotsquared-v5.77506/ 4.1 Replace PlotSquared v4 with v5 and launch the server. Same procedure here, check your log and ensure no warnings or errors occur.
  6. That's it. The conversion is done.

Migrating from PlotSquared v3:

  1. Get the latest PlotSquared v3 from here https://dev.bukkit.org/projects/plotsquared/files/2647923 1.1 Replace your current version with PlotSquared v3 and launch the server, ensure there are no errors or warnings and shut it down again.
  2. Get the latest PlotSquared v4 from https://www.spigotmc.org/resources/plotsquared-v4-v5-out-now.1177/. 2.1 Replace PlotSquared v3 with v4 and launch the server. Ensure there are no errors or warnings and shut it down again. If you encounter errors or warnings read them carefully and do what they tell you to do. Ignoring them can lead to further issues down the line. You may need to revisit /plugins/PlotSquared/settings/worlds.yml and perform material updates yourself. Versions prior to v5 weren't very smart in that aspect. Click here for an up to date list of valid material names.
  3. Get the latest PlotSquared v5 from https://www.spigotmc.org/resources/plotsquared-v5.77506/ 3.1 Replace PlotSquared v4 with v5 and launch the server. Same procedure here, check your log and ensure no warnings or errors occur.
  4. That's it. The conversion is done.

Migrating from PlotSquared v4:

  1. Get the latest PlotSquared v4 from https://www.spigotmc.org/resources/plotsquared-v4-v5-out-now.1177/. 1.1 Replace your current version with v4 and launch the server. Ensure there are no errors or warnings and shut it down again. If you encounter errors or warnings read them carefully and do what they tell you to do. Ignoring them can lead to further issues down the line.
  2. Get the latest PlotSquared v5 from https://www.spigotmc.org/resources/plotsquared-v5.77506/ 2.1 Replace PlotSquared v4 with v5 and launch the server. Same procedure here, check your log and ensure no warnings or errors occur. You may need to revisit /plugins/PlotSquared/settings/worlds.yml and perform material updates yourself. Versions prior to v5 weren't very smart in that aspect. Click here for an up to date list of valid material names. 2.2 Visit https://github.com/IntellectualSites/PlotSquared/wiki/Updating-from-1.12-to-1.13- for further instructions.
  3. That's it. The conversion is done.